douyin-weekly-surge

抖音七日点赞飙升榜

📝 简介

周度内容飙升监测工具，每日收录核验全平台万级抖音作品，输出七日新增点赞 TOP50 榜单。

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

✨ 功能特性

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

🔑 鉴权

前往 红狐hub 获取 API Key，通过以下方式配置：

# 方式一：配置文件（如 OpenClaw 的 ~/.openclaw/openclaw.json）
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }

# 方式二：终端环境变量
export REDFOX_API_KEY="ak_xxxx..."

📡 API 调用

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

详见 api-config.md。

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

当脚本 scripts/douyin_weekly_surge.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_weekly_surge.py 输出结果。

🔄 交互流程

1. 时间判断

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

时间提示语：

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

2. 赛道判断

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

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

3. 默认行为

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

📊 标准输出格式

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

💡 榜单说明：每日 17:00 更新过去七日数据，[如有时间偏差提示则插入]。飙升数据为七日新增统计，与累计总量存在差异。

📊 抖音七日点赞飙升TOP20（截至 YYYY-MM-DD）[查询全部时含"赛道"列，查询特定赛道时不含]

| 排名 | 作品标题 | 作者 | 赛道* | 七日新增收藏 | 七日新增评论 | 七日新增分享 | **七日新增点赞** | 发布时间 |
|------|---------|------|-------|---------|---------|---------|------------|---------|
| 1 | [红烧肉的教程](https://www.douyin.com/video/xxx) | 美食达人 | 美食 | 10w+ | 10w+ | 10w+ | **10w+** | 05-28 12:00 |

*查询特定赛道时去掉"赛道"列

⚡ 更多操作
• 本次榜单完整共50条数据，是否需要查看剩余30条？

📬 订阅服务
1️⃣ 我们每日 17:00 更新过去七日数据，是否需要订阅每日的抖音作品七日飙升排行，订阅后定时推送给您
2️⃣ 是否需要订阅具体赛道的作品表现？我们支持：[列出28个赛道]

作品标题超链接规范

• 作品标题必须以 Markdown 链接格式输出：[作品标题](workUrl)
• workUrl 为接口返回的 share_url 字段
• 禁止使用 HTML <a> 标签或终端 OSC 转义序列

数据字段说明

字段	来源字段	说明
排名	数组位置	按七日新增点赞降序排列
作品标题	aweme_desc + share_url	展示为超链接格式，见上方规范
作者	user_nickname	账号名
赛道	category	仅全品类查询时展示
七日新增收藏 / 七日新增评论 / 七日新增分享 / 七日新增点赞	add_collect_count / add_comment_count / add_share_count / add_digg_count	七日新增互动数据（入库时间快照），七日新增点赞列数值需加粗显示
发布时间	create_time_str	格式 MM-DD HH:00

📬 文件输出与订阅

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

📚 其他资源

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