douyin-hot-trendlisted

# 抖音热榜 ## 简介 抖音热榜是一款实时追踪抖音平台热点趋势的数据工具，对接 [红狐Hub](https://redfox.hk/?source=github) 数据 API，每小时更新热榜内容，并提供创作者视角的深度分析。 通过简单的自然语言指令，你可以： - 📊 **实时热榜查询**：每 60 分钟抓取抖音 TOP 50 榜单，同步热度值与跳转链接 - 📅 **历史热榜回溯**：覆盖近 7 天、近 30 天历史数据，支持按日期与关键词检索 - 🔀 **热榜数据对比**：对比任意两个时间点（如昨天 vs 今天）的热榜变化 - 💡 **深度洞察分析**：从创作者视角提供选题机会、标题套路与趋势预判 - 🔔 **个性化订阅**：支持每小时或每日定时推送热榜数据 适用于内容创作者、短视频运营、MCN 机构、品牌营销人员等需要追踪抖音热点、寻找创作灵感、制定内容策略的场景。 **技术基础**：Python 3.x + `requests` 库，通过 红狐Hub APIKey获取数据。 --- ## 功能特性 ### 🎯 核心功能 - **📊 实时热榜**：获取抖音当前 TOP 50 热榜，每小时刷新，展示排名、热度值、话题标题和跳转链接 - **📅 历史回溯**：支持查询近 7 天或近 30 天历史热榜，最长覆盖 30 天 - **💡 创作者洞察**：自动生成选题机会分析、标题套路拆解、趋势预判与行动建议 - **📄 可视化报告**：一键生成紫色极简风格 HTML 页面，支持导出 PDF，每条记录可点击跳转 - **🔔 订阅推送**：支持每小时或每日定时推送，自动追踪热点变化 ### ✨ 特色亮点 - **⚡ 自然语言交互**：输入「今日热榜」「近7天热榜」等即可查询，无需记忆命令参数 - **🔒 三级鉴权回退**：API Key 优先从环境变量读取，自动回退到 Shell 配置文件 - **✅ 数据一致性**：表格、洞察、HTML、PDF 全链路数据一致，不做加工或美化 - **🎬 创作者视角**：每条洞察都回答「怎么用」，给出可执行的行动建议 --- ## 一键安装 ### 前置条件 - 已安装 Python 3.x 及 `requests` 库 - 已注册 [红狐Hub官网](https://redfox.hk/login?source=github) 账号并获取 API Key（格式 `ak_xxxxxxxx`） - 新注册用户将获赠免费积分，可立即开始使用 ### 安装方式 #### 方式一：WorkBuddy（龙虾）技能安装（推荐） 1. 将 `douyin-hot-trend` 技能文件夹复制到 WorkBuddy 的 skills 目录下 2. 在 WorkBuddy 对话中直接说「抖音热榜」或「今日热榜」，Agent 将自动加载本技能 3. 配置 API Key（见下方「环境变量配置」） 4. 安装 Python 依赖： ```bash pip install requests ``` #### 方式二：Cursor / 其他 Agent 环境手动安装 1. 将技能文件夹放置到对应环境的 skills 目录 2. 确保 Agent 可读取 `SKILL.md` 与 `references/core_workflow.md` 3. 配置 `REDFOX_API_KEY` 环境变量 4. 执行 `pip install requests` ### 环境变量配置