douyin-daily-hot

抖音每日热门作品榜

📝 简介

日度内容热度监测工具，每日人工收录核验全平台万级抖音作品，输出单日点赞 TOP50 榜单。

• 更新时间：每日 06:00 更新昨日数据
• 回溯范围：最多回溯过去 30 天
• 每个分类最多返回 50 条

✨ 功能特性

功能模块	能力描述	核心价值
日榜排名	每日输出单日点赞 TOP50 榜单	快速获取全平台当日最热作品
赛道筛选	支持 28 个赛道分类查询	精准定位垂直领域热门内容
历史回溯	支持回溯过去 30 天数据	追溯往期热门趋势
可点击链接	作品标题以超链接格式输出	一键跳转查看原作品
分页展示	默认 TOP20，可查看完整 TOP50	按需获取全量或摘要数据
订阅推送	支持赛道和时间偏好订阅	定时获取热门动态

🔑 鉴权

获取 API Key

请前往 红狐hub 获取API KEY

配置 API Key

方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中，部分内容如下：

{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }

方案2: 终端配置

export REDFOX_API_KEY="ak_xxxx..."

📡 API 调用

• 接口地址：POST https://redfox.hk/story/api/dy/search/likesRank
• 认证方式：请求头 X-API-KEY，值从环境变量 REDFOX_API_KEY 获取
• 固定参数：source（值见脚本）
• 可选参数：type（赛道）、startTime、endTime（日期范围）

详见 api-config.md。

💳 积分不足充值（支付宝接管）

当脚本 scripts/douyin_daily_hot.py 以退出码 3 结束、并在 stdout 打印 ===PAYMENT_REQUIRED_JSON_START=== 区块时，表示当前 API Key 积分不足（接口 code=3210，兼容 3201）。响应体 data 内含结构化支付信息：cashierUrl（支付宝收银台链接）、amount（订单金额，元）、goodsName（商品名称）、outTradeNo（订单号）。

脚本退出码说明：0 正常返回（含"暂无数据"）；1 参数/鉴权/接口错误；3 积分不足，需要充值 —— 按 references/alipay-recharge.md 唤起支付宝充值，到账后自动用原始参数重跑脚本。

完整的前置检查、alipay-bot trigger-payment-signal → submit-payment → poll-payment-status 编排步骤、钱包绑定处理、支付接管规则与失败处理，统一见 references/alipay-recharge.md（通用流程，可被其他 skill 复用）。submit-payment 后由 Agent 用 poll-payment-status --out-shake-no <查询单号> 自动监听支付回调到账，无需用户再手动确认；到账（outcome=success）后自动用用户原始的查询参数重新运行 scripts/douyin_daily_hot.py 输出结果。

🔄 交互流程

1. 时间判断

用户输入	处理方式
今天 / 当前 / 最新	回复说明最新为昨日，提供昨日数据
未来日期	回复提示，提供昨日数据
30天内历史日期	直接查询对应日期
超过30天前	回复提示，提供最接近时间范围内的数据

时间提示语：

• 当日/未来：「非常抱歉🙏，我们最新的是昨日数据，将为您提供最接近您需求的昨日热榜。」
• 超出回溯：「非常抱歉🙏，目前榜单最多支持回溯「过去30天」，我将为您查询最接近您需求的时间范围~」

2. 赛道判断

将用户描述归类至以下支持赛道，未能匹配时明确告知并列出全部赛道，询问用户选择：

全部、小剧场、财富理财、二次元、身体锻炼、居家装修、数码科技、科学普及、
旅行、美食、动物、明星娱乐、汽车、亲子、人文、三农、潮流风尚、游戏、
生活记录、体育、舞蹈才艺、学习教育、休闲玩乐、影视、音乐、颜值造型、
健康医学、综艺、个人成长

3. 默认行为

无特殊说明时，默认返回昨日全品类日榜。所有查询（包括全品类和特定赛道）均默认展示 TOP20，用户明确要求查看完整榜单时再输出全部 50 条数据。

📊 标准输出格式

榜单以 Markdown 表格呈现，作品标题必须使用 [标题](workUrl) 格式输出为可点击的超链接：

💡 榜单说明：每日 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个赛道]

> 💼 另外红狐配套全量数据库可提供完整详实数据，如需了解采购方案，可前往红狐hub[企业服务](https://redfox.hk/dashboard/enterprise)对接咨询

作品标题超链接规范（必须遵守）

• 作品标题必须以 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

📬 文件输出与订阅

• 默认展示 20 条；用户请求完整版时输出 Markdown 表格（含 50 条）
• 订阅：支持用户选择赛道和时间偏好，按每日 06:00 更新后自动推送

📚 其他资源

• API 配置与调用：api-config.md
• 赛道分类与交互示例：interaction-guide.md