Menu
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/redfox-data/redfox-community --skill douyin-hot-trendThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
| name | douyin-hot-trend |
| description | 专注于获取抖音最新的热榜数据，每小时更新，包含热点事件、热度值和跳转链接；支持查询近7天、近30天历史热榜，并支持订阅定时推送。 |
抖音热榜是一款实时追踪抖音平台热点趋势的数据工具，对接 红狐Hub 数据 API，每小时更新热榜内容，并提供创作者视角的深度分析。
通过简单的自然语言指令，你可以：
适用于内容创作者、短视频运营、MCN 机构、品牌营销人员等需要追踪抖音热点、寻找创作灵感、制定内容策略的场景。
技术基础：Python 3.x + requests 库，通过 红狐Hub APIKey获取数据。
requests 库ak_xxxxxxxx）douyin-hot-trend 技能文件夹复制到 WorkBuddy 的 skills 目录下pip install requests
SKILL.md 与 references/core_workflow.mdREDFOX_API_KEY 环境变量pip install requests| 变量名 | 必填 | 说明 |
|---|---|---|
REDFOX_API_KEY | 是 | 红狐Hub API 访问密钥，格式 ak_xxxxxxxx |
配置方式（任选其一）：
# 方式一：直接设置环境变量（推荐）
export REDFOX_API_KEY=ak_xxxxxxxx
# 方式二：写入 Shell 配置文件（~/.bashrc / ~/.bash_profile / ~/.zshrc）
echo 'export REDFOX_API_KEY=ak_xxxxxxxx' >> ~/.bashrc
source ~/.bashrc
若未配置环境变量，技能将自动从 Shell 配置文件读取；若仍未获取到，会在运行时提示配置。
在 WorkBuddy 中配置 Key：可在系统环境变量中设置 REDFOX_API_KEY，或在 Shell 配置文件中写入后重启 WorkBuddy，无需在每次对话中手动传入。
告诉助手你想查看当前抖音热点：
用户：抖音热榜 助手：为您展示抖音实时热榜 TOP 20（含排名、热度值、话题链接），并附创作者洞察报告。
查询指定时间范围的历史数据：
用户：近7天热榜 助手：为您展示近 7 天抖音历史热榜，支持按日期回溯热点演变。
用户：4月15日热榜 助手：为您查询 4 月 15 日当天的热榜数据。
默认展示 TOP 20，可继续加载至 TOP 50：
用户：继续加载 助手：为您展示 TOP 21–50，并生成包含完整 TOP 50 的 HTML 报告。
热榜展示后自动输出深度分析：
用户：今日热榜 助手：（展示表格后）输出爆款选题机会、标题套路破解、趋势预判与行动建议。
对比两个时间点的热榜变化：
用户：对比昨天和今天的热榜 助手：为您对比两日热榜排名与热度变化，标注新进榜与掉榜话题。
设置定时自动推送：
用户：订阅每日热榜推送 助手：已设置每日推送，将在指定时间自动推送 TOP 50 完整热榜数据。
用户：取消订阅 助手：已取消定时推送。
每次查询自动生成可视化报告：
用户：今日热榜 助手：（查询完成后）已生成 HTML 页面与 PDF 文件，数据与表格展示完全一致，支持点击跳转。
| 指令 | 功能 |
|---|---|
| 抖音热榜 / 今日热榜 | 查询实时热榜 TOP 20 |
| 昨日热榜 | 查询昨日热榜 |
| 近7天热榜 | 查询近 7 天历史热榜 |
| 近30天热榜 | 查询近 30 天历史热榜 |
| X月X日热榜 | 查询指定日期热榜 |
| 继续加载 / 加载更多 | 加载 TOP 21–50 完整榜单 |
| 订阅每日/每小时推送 | 设置定时推送 |
| 取消订阅 | 停止定时推送 |
角色：抖音短视频创作者
需求：每天快速了解平台热点，找到适合自己赛道的创作方向
使用方式：
预期收益：缩短选题时间，提高内容命中率
角色：MCN 运营人员
需求：监控平台热点趋势，为旗下达人提供选题指导和内容策略
使用方式：
预期收益：提升团队内容策略的时效性和精准度
角色：品牌营销经理
需求：及时发现可借势的热点话题，制定蹭热点营销方案
使用方式：
预期收益：提升品牌热点的响应速度和借势效果
角色：短视频运营新手
需求：学习爆款内容的创作规律，提升运营能力
使用方式：
预期收益：快速建立内容 sense，掌握爆款创作方法论
douyin-hot-trend/
├── SKILL.md # 技能说明文档（当前文件）
├── references/
│ └── core_workflow.md # Agent 核心工作流指令
├── scripts/
│ ├── hotspot_fetcher.py # 热榜数据获取脚本
│ └── gen_douyin_hot_html.py # HTML 可视化报告生成脚本
└── assets/
└── douyin_hot_trend_template.html # HTML 页面模板
| 模块 | 文件 | 职责 |
|---|---|---|
| 数据获取 | hotspot_fetcher.py | 调用 红狐Hub API 获取抖音热榜 JSON，支持实时与历史查询 |
| 报告生成 | gen_douyin_hot_html.py | 将热榜数据渲染为紫色极简风格 HTML，支持导出 PDF |
| 页面模板 | douyin_hot_trend_template.html | 独立 HTML 模板，支持占位符快速替换生成 |
| 类别 | 说明 |
|---|---|
| 运行环境 | Python 3.x |
| HTTP 请求 | 原生 requests 库 |
| 认证方式 | X-API-KEY 请求头，三级回退（环境变量 → Shell 配置 → 提示配置） |
| 数据来源 | 红狐Hub API |
| 部署平台 | WorkBuddy / Cursor 等 Agent 环境 |
Q1: 运行时提示「缺少 REDFOX_API_KEY 配置」怎么办？
A: 请按以下步骤排查：
export REDFOX_API_KEY=ak_xxxxxxxxsource ~/.bashrc 使其生效ak_ 开头Q2: 需要安装哪些 Python 依赖？
A: 仅需 requests 库：pip install requests
Q3: 如何在 WorkBuddy（龙虾）中启用本技能？
A: 将技能文件夹放入 WorkBuddy 的 skills 目录，配置好 REDFOX_API_KEY 后，在对话中说「抖音热榜」即可触发。Agent 将按 references/core_workflow.md 执行完整工作流。
Q4: 热榜数据多久更新一次？
A: 每小时更新一次。每次查询都会调用 API 获取最新数据，不依赖本地缓存。
Q5: 可以查询多久之前的历史数据？
A: 最长支持查询近 30 天的历史热榜。超过 30 天的数据暂不支持。
Q6: API 调用失败怎么办？
A: 请按以下顺序排查：
https://redfox.hk?source=githubecho $REDFOX_API_KEYQ7: 订阅推送没有收到怎么办？
A: 确认订阅已成功设置。如需重新设置，说「取消订阅」后重新订阅。如仍有问题，检查WorkBuddy等系统的自动化任务是否正常运行。
Q8: HTML 报告预览不成功或显示空白怎么办？
A: 请按以下方式处理：
✅ 已生成 提示）Q9: API Key 如何安全存储？
A: 建议通过环境变量或 Shell 配置文件存储，不要将 Key 写入代码仓库或公开分享。本技能支持三级鉴权回退，优先读取环境变量，避免在对话中明文传递。
Q10: 数据来源与使用许可？
A: 热榜数据来自 红狐Hub 官方 API，使用时须遵守 红狐Hub 平台服务条款及抖音平台相关规定。本技能仅作数据展示与分析辅助，不保证数据的商业用途合规性。
如有其他问题，可通过以下方式获取帮助：
references/core_workflow.mdAgent 执行参考：完整的操作步骤、输出格式、数据规则等执行层指令，请查阅 references/core_workflow.md。
Based on SOC occupation classification