douyin-daily-hot · diff
git:20260602.fe8a28e to git:20260602.08c4de8
195 added, 48 removed. Audit A to A.
---
name: douyin-daily-hot
description: 抖音每日最热作品榜查询工具。日度收录全平台抖音作品，输出单日点赞TOP50榜单，支持按赛道分类查询、历史日期回溯（最多30天）、个性化订阅推送。当用户查询抖音热榜、抖音日榜、抖音爆款作品、抖音赛道排名、抖音达人排名、抖音热门内容时使用。触发词：抖音热榜、抖音日榜、抖音排名、抖音爆款、抖音最热、抖音TOP榜、抖音赛道榜单。
---
# 抖音每日热门作品榜
- ## 产品概述
+ ## 1. 简介
- 日度内容热度监测工具，每日人工收录核验全平台万级抖音作品，输出单日点赞 TOP50 榜单。
+ **一句话定位**：抖音每日最热作品榜查询工具，日度收录全平台抖音作品，输出单日点赞TOP50榜单，支持28个赛道分类查询和历史回溯。
- - 更新时间：每日 06:00 更新昨日数据
- - 回溯范围：最多回溯过去 30 天
- - 每个分类最多返回 50 条
+ **核心价值**：
+ - **日度精准更新**：每日人工收录核验全平台万级抖音作品，每日06:00更新昨日数据
+ - **多维赛道覆盖**：支持28个赛道分类查询，从全品类到细分领域全覆盖
+ - **灵活时间回溯**：最多回溯过去30天，支持历史数据对比分析
- ## 鉴权
+ **适用对象**：抖音内容创作者、MCN机构运营、品牌营销策划、抖音数据分析师。
- ### 获取 API Key
+ ## 2. 功能特性
+ ### 核心功能
+
+ | 功能模块 | 能力描述 | 核心价值 |
+ |----------|----------|----------|
+ | 📊 全品类日榜 | 单日点赞TOP50榜单 | 快速了解抖音最热内容 |
+ | 🏷️ 赛道分类查询 | 28个细分赛道独立查询 | 精准定位垂直领域热点 |
+ | 📅 历史回溯 | 最多回溯30天 | 对比分析历史趋势 |
+ | 👤 达人追踪 | 展示作者粉丝数 | 发现潜力达人账号 |
+ | 📈 互动数据看板 | 收藏/评论/分享/点赞 | 多维度衡量作品表现 |
+ | ⏰ 订阅推送 | 每日06:00自动推送 | 持续追踪，不错过热榜 |
+
+ ### 特色亮点
+
+ - **超链接标题**：所有作品标题以 `[标题](workUrl)` 格式输出，可直接点击跳转抖音
+ - **智能时间判断**：自动判断数据可用性，当日/未来日期自动回退到最近可用数据
+ - **TOP20默认展示**：默认展示TOP20，可按需查看完整50条
+ - **赛道未匹配提示**：自动列出28个赛道供用户选择
+
+ ## 3. 一键安装
+
+ ### 鉴权
+
+ #### 获取 API Key
+
请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取API KEY
- ### 配置 API Key
+ #### 配置 API Key
方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中，部分内容如下：
```bash
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
```
- 方案2: 终端配置
+ 方案2: 终端配置：
```bash
export REDFOX_API_KEY="ak_xxxx..."
```
- ## API 调用
+ ### 依赖安装
- - **接口地址**：`POST https://redfox.hk/story/api/dy/search/likesRank`
- - **认证方式**：请求头 `X-API-KEY`，值从环境变量 `REDFOX_API_KEY` 获取
- - **可选参数**：`type`（赛道）、`startTime`、`endTime`（日期范围）
+ 本技能使用API直调方式，无需额外Python依赖。如需调用脚本，请确保Python 3可用。
- 详见 [api-config.md](api-config.md)。
+ ### 环境变量配置
- ## 交互流程
+ | 变量名 | 说明 | 必填 |
+ |--------|------|------|
+ | `REDFOX_API_KEY` | 红狐 API Key | 是 |
- ### 1. 时间判断
+ ## 4. 使用指南
- | 用户输入 | 处理方式 |
- | ------------------ | ------------------------------------ |
- | 今天 / 当前 / 最新 | 回复说明最新为昨日，提供昨日数据 |
- | 未来日期 | 回复提示，提供昨日数据 |
- | 30天内历史日期 | 直接查询对应日期 |
- | 超过30天前 | 回复提示，提供最接近时间范围内的数据 |
+ ### 基础使用
- 时间提示语：
+ #### 查询昨日全品类日榜（默认行为）
- - 当日/未来：「非常抱歉🙏，我们最新的是昨日数据，将为您提供最接近您需求的昨日热榜。」
- - 超出回溯：「非常抱歉🙏，目前榜单最多支持回溯「过去30天」，我将为您查询最接近您需求的时间范围~」
+ 无特殊说明时，默认返回昨日全品类日榜TOP20。
- ### 2. 赛道判断
+ **接口调用**：
+ - 接口地址：`POST https://redfox.hk/story/api/dy/search/likesRank`
+ - 认证方式：请求头 `X-API-KEY`，值从环境变量 `REDFOX_API_KEY` 获取
+ - 可选参数：`type`（赛道）、`startTime`、`endTime`（日期范围）
- 将用户描述归类至以下支持赛道，未能匹配时明确告知并列出全部赛道，询问用户选择：
+ #### 查询指定赛道
+ 用户可指定以下28个赛道：
+
```
全部、个人才艺、生活vlog、财富理财、二次元、居家装修、学习教育、小剧场、
数码科技、旅行、美食、化妆美容、动物、亲子、汽车、情感、三农、健康医学、
潮流风尚、舞蹈才艺、颜值造型、人文、音乐、影视、身体锻炼、体育、明星娱乐、游戏
```
- ### 3. 默认行为
+ 未能匹配时明确告知并列出全部赛道，询问用户选择。
- 无特殊说明时，默认返回昨日全品类日榜。**所有查询（包括全品类和特定赛道）均默认展示 TOP20，用户明确要求查看完整榜单时再输出全部 50 条数据。**
+ ### 高级使用
- ## 标准输出格式
+ #### 时间判断规则
- 榜单以 Markdown 表格呈现，**作品标题必须使用 `[标题](workUrl)` 格式输出为可点击的超链接**：
+ | 用户输入 | 处理方式 |
+ |----------|----------|
+ | 今天 / 当前 / 最新 | 回复说明最新为昨日，提供昨日数据 |
+ | 未来日期 | 回复提示，提供昨日数据 |
+ | 30天内历史日期 | 直接查询对应日期 |
+ | 超过30天前 | 回复提示，提供最接近时间范围内的数据 |
- ```
- 💡 榜单说明：每日 06:00 更新昨日数据，[如有时间偏差提示则插入]。互动数据为入库时间，与实时数据存在差异。
+ **时间提示语**：
+ - 当日/未来：「非常抱歉🙏，我们最新的是昨日数据，将为您提供最接近您需求的昨日热榜。」
+ - 超出回溯：「非常抱歉🙏，目前榜单最多支持回溯「过去30天」，我将为您查询最接近您需求的时间范围~」
- 📊 抖音每日点赞TOP20（YYYY-MM-DD）[查询全部时含"赛道"列，查询特定赛道时不含]
+ #### 标准输出格式
+ 榜单以 Markdown 表格呈现，**作品标题必须使用 `[标题](workUrl)` 格式输出为可点击的超链接**。各列说明：
+
+ | 列名 | 来源字段 | 说明 |
+ |------|---------|------|
+ | 排名 | rank | 当日点赞排名 |
+ | 作品标题 | video_title + workUrl | **必须展示为 `[标题](workUrl)` 超链接格式** |
+ | 作者（粉丝数） | author_name + author_fans | 账号名 + 粉丝总数 |
+ | 赛道 | category | 仅全品类查询时展示，查询特定赛道时隐藏此列 |
+ | 收藏 | collect | 入库时快照 |
+ | 评论 | comment | 入库时快照 |
+ | 分享 | share | 入库时快照 |
+ | 点赞 | like | **入库时快照，数值需加粗显示** |
+ | 发布时间 | publish_time | 格式 MM-DD HH:00 |
+
+ **输出模板**：
+
+ ```markdown
+ 💡 榜单说明：每日 06:00 更新昨日数据。互动数据为入库时间，与实时数据存在差异。
+
+ 📊 抖音每日点赞TOP20（YYYY-MM-DD）
+
| 排名 | 作品标题 | 作者（粉丝数） | 赛道* | 收藏 | 评论 | 分享 | **点赞** | 发布时间 |
|------|---------|--------------|-------|------|------|------|------|---------|
| 1 | [红烧肉的教程](https://www.douyin.com/video/xxx) | 美食达人（10w+） | 美食 | 10w+ | 10w+ | 10w+ | **10w+** | 05-28 12:00 |
*查询特定赛道时去掉"赛道"列
⚡ 更多操作
• 本次榜单完整共50条数据，是否需要查看剩余30条？
📬 订阅服务
1️⃣ 我们每日 06:00 更新昨日数据，是否需要订阅每日的抖音账号最新排名，订阅后定时推送给您
2️⃣ 是否需要订阅具体赛道的账号表现？我们支持：[列出28个赛道]
```
- ### 作品标题超链接规范（必须遵守）
+ #### 作品标题超链接规范（必须遵守）
- 作品标题**必须**以 Markdown 链接格式输出：`[作品标题](workUrl)`
- `workUrl` 为接口返回字段，是作品在抖音的访问链接
- **禁止**使用 HTML `<a>` 标签或终端 OSC 转义序列
- 即使终端不支持直接点击，Markdown 链接格式也能确保对话界面正确渲染为可点击超链接
- ### 数据字段说明
+ #### 分页展示策略
- | 字段 | 来源字段 | 说明 |
- | ------------------------- | -------------------------------- | -------------------------------------------------- |
- | 排名 | rank | 当日点赞排名 |
- | 作品标题 | video_title + workUrl | **必须展示为 `[标题](workUrl)` 超链接格式** |
- | 作者 | author_name + author_fans | 账号名 + 粉丝总数 |
- | 赛道 | category | 仅全品类查询时展示 |
- | 收藏 / 评论 / 分享 / 点赞 | collect / comment / share / like | 互动数据（入库时间快照），**点赞列数值需加粗显示** |
- | 发布时间 | publish_time | 格式 MM-DD HH:00 |
+ - 默认展示 **TOP20**，用户明确要求查看完整榜单时再输出全部50条
+ - 数据不足20条时展示实际数量
- ## 文件输出与订阅
+ #### 订阅服务
- - 默认展示 20 条；用户请求完整版时输出 Markdown 表格（含 50 条）
- - 订阅：支持用户选择赛道和时间偏好，按每日 06:00 更新后自动推送
+ - 支持用户选择赛道和时间偏好
+ - 按每日 06:00 更新后自动推送
+ - 每个分类最多返回 50 条
- ## 其他资源
+ 详见 [api-config.md](api-config.md) 和 [interaction-guide.md](interaction-guide.md)。
+ ### 命令速查表
+
+ | 场景 | 说明 |
+ |------|------|
+ | 默认查询 | 返回昨日全品类TOP20 |
+ | 赛道查询 | 指定28个赛道之一，返回该赛道昨日TOP20 |
+ | 历史日期查询 | 指定30天内的日期，返回对应日期的榜单 |
+ | 完整榜单 | 用户明确要求时输出全部50条 |
+
+ ## 5. 使用场景
+
+ ### 场景一：内容创作者选题参考
+
+ **角色**：抖音短视频创作者
+ **需求**：了解昨日最火的作品类型和内容方向，为自己的创作提供参考
+ **使用方式**：查询全品类日榜TOP20，重点关注高赞作品的标题、赛道和内容特征
+ **预期收益**：快速把握抖音内容风向，提高作品爆款概率
+
+ ### 场景二：MCN机构达人监测
+
+ **角色**：MCN运营
+ **需求**：监测旗下达人在各自赛道中的排名表现，发现同行竞品动态
+ **使用方式**：按赛道分别查询，对比不同达人的互动数据和排名变化
+ **预期收益**：精准评估达人表现，及时调整运营策略
+
+ ### 场景三：品牌营销内容分析
+
+ **角色**：品牌营销策划
+ **需求**：分析特定赛道（如美食、旅行）的热门作品，寻找品牌植入方向
+ **使用方式**：查询目标赛道TOP20，关注达人粉丝规模、内容形式和互动数据
+ **预期收益**：找到与品牌调性匹配的达人，策划高效的种草内容
+
+ ### 场景四：账号冷启动方向定位
+
+ **角色**：新入局抖音创作者
+ **需求**：了解不同赛道的竞争程度和爆款特征，选择适合的创作方向
+ **使用方式**：连续查询多个赛道近7天数据，对比各赛道门槛和上限
+ **预期收益**：基于数据做出赛道选择决策，降低试错成本
+
+ ## 6. 项目架构
+
+ ### 目录结构
+
+ ```
+ douyin-daily-hot/
+ ├── SKILL.md # 技能描述文件
+ ├── api-config.md # API配置与调用说明
+ └── interaction-guide.md # 赛道分类与交互示例
+ ```
+
+ ### 技术栈
+
+ | 组件 | 技术 | 说明 |
+ |------|------|------|
+ | 数据接口 | Redfox API (POST) | 抖音点赞榜数据 |
+ | 认证方式 | X-API-KEY | 请求头认证 |
+ | 输出格式 | Markdown 表格 | 结构化榜单展示 |
+ | 更新时间 | 每日 06:00 | 更新昨日数据 |
+
+ ### 核心模块说明
+
+ | 模块 | 功能 |
+ |------|------|
+ | API 调用层 | POST 请求到 `https://redfox.hk/story/api/dy/search/likesRank`，携带 X-API-KEY 认证 |
+ | 时间判断 | 智能处理当日/未来/超时查询，自动回退到最近可用数据 |
+ | 赛道匹配 | 将用户自然语言输入匹配到28个标准赛道 |
+
+ ### 资源索引
+
- API 配置与调用：[api-config.md](api-config.md)
- 赛道分类与交互示例：[interaction-guide.md](interaction-guide.md)
+
+ ## 7. 常见问答
+
+ ### 安装相关
+
+ **Q: 需要安装什么依赖？**
+ A: 本技能通过直接调用Redfox API获取数据，无需额外Python依赖。只需配置 `REDFOX_API_KEY` 环境变量即可。
+
+ **Q: 如何验证API Key配置成功？**
+ A: 执行一次全品类日榜查询，如果能正常返回数据则配置成功。
+
+ ### 使用相关
+
+ **Q: 为什么查询"今天"的数据返回的是昨天的？**
+ A: 数据每日06:00更新昨日数据，当日的最新数据要到次日06:00才可用。系统会自动回退并提供最接近的数据。
+
+ **Q: 支持查询多久之前的数据？**
+ A: 最多回溯过去30天。
+
+ **Q: 每个赛道最多返回多少条？**
+ A: 每个分类最多返回50条。默认展示TOP20，用户要求时可展示完整50条。
+
+ **Q: 为什么有些赛道查不到数据？**
+ A: 可能是该赛道在查询日期没有收录到数据，建议尝试近邻日期或全品类查询。
+
+ ### 故障排除
+
+ **Q: 查询返回空数据？**
+ A: 可能原因：1) API Key 无效或过期；2) 查询日期已超过30天回溯范围；3) 赛道名称拼写错误。请逐一排查。
+
+ **Q: 作品链接无法点击？**
+ A: 确保输出格式为 `[作品标题](workUrl)` Markdown 链接格式，不要使用 HTML 标签。