抖音热榜

要解决什么问题

抖音热点每小时都在变，运营和创作者若只靠刷 App 或零散截图，很难系统化回答三件事：当前榜上有哪些话题、某个热点是刚冲上来还是快退潮、以及这条热点能不能转成自己赛道里的选题。本技能把查询、回溯、对比和报告生成收进 Agent 对话里，数据来自红狐Hub 官方 API，用 REDFOX_API_KEY 鉴权。

技能如何工作

• 实时热榜：按小时拉取抖音 TOP 50，默认先展示 TOP 20，可说「继续加载」补全 21–50；字段含排名、热度值、标题与跳转链接。
• 历史与检索：支持近 7 天、近 30 天，以及「X月X日热榜」这类按日查询（文档说明最长约 30 天）。
• 对比：例如「对比昨天和今天的热榜」，用于看新进榜、掉榜与热度变化。
• 创作者洞察：在表格之后给出选题机会、标题套路、趋势预判与可执行建议，强调「怎么用」而非只复述榜单。
• 报告与订阅：查询后可生成紫色极简风格 HTML，并支持导出 PDF；可设置每小时或每日推送，也可用「取消订阅」关闭。

实现侧是 Python 3.x + requests，核心模块包括 hotspot_fetcher.py（调 API）、gen_douyin_hot_html.py 与 HTML 模板；API Key 优先读环境变量，并支持向 Shell 配置回退。

适用边界与注意点

• 数据更新频率以 API 为准（文档为约 60 分钟一次），每次查询走实时请求，不依赖本地长期缓存。
• 历史范围受平台能力限制，超过约 30 天的历史不在支持范围内。
• 订阅推送依赖所在 Agent/宿主环境（如 WorkBuddy）的定时任务是否正常；HTML 若在内置预览空白，可直接用浏览器打开生成的文件。
• 使用须遵守红狐Hub 服务条款与抖音平台规则；API 积分与 Key 有效性会影响调用结果。