{"id":"4dde764b-44d9-4a26-90a7-872f51bf0c3e","entityType":"agent","slug":"clawhub-if530770-dy-hot-trend","name":"抖音实时热点榜","canonicalUrl":"https://www.xpersona.co/agent/clawhub-if530770-dy-hot-trend","canonicalPath":"/agent/clawhub-if530770-dy-hot-trend","generatedAt":"2026-10-14T02:51:00.505Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-12T02:38:50.680Z","emptyReason":null},"description":"专注于获取抖音最新的热榜数据，每小时更新，包含热点事件、热度值和跳转链接；支持查询近7天、近30天历史热榜，并支持订阅定时推送。 Skill: 抖音实时热点榜 Owner: if530770 Summary: 专注于获取抖音最新的热榜数据，每小时更新，包含热点事件、热度值和跳转链接；支持查询近7天、近30天历史热榜，并支持订阅定时推送。 Tags: latest:1.0.3 Version history: v1.0.3 | 2026-06-05T03:41:32.871Z | user douyin-hot-trend 1.0.3 版本主要优化文档结构与资源指向，提升可用性与集成便捷性： - 更新并扩展 SKILL.md，优化指令说明、场景用法及常见问答，增强用户引导。 - 新增英文与中文 README 文件，标准化多语言文档支持。 - 新增 references/core_workflow.md，替换原 assets/core-workflow.md，规范 Agent 执行流程入口。 - 移除冗余文件（如_skillhub_meta.json、skil","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 953 downloads reported by the source. Last updated 10/12/2026.","installCommand":"clawhub skill install s17dj64hf08x3mak1j99vesphd84gs9c:dy-hot-trend","sourceUrl":"https://clawhub.ai/if530770/dy-hot-trend","homepage":"https://clawhub.ai/if530770/skills/dy-hot-trend","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/if530770/dy-hot-trend","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/if530770/skills/dy-hot-trend","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"专注于获取抖音最新的热榜数据，每小时更新，包含热点事件、热度值和跳转链接；支持查询近7天、近30天历史热榜，并支持订阅定时推送。 Skill: 抖音实时热点榜 Owner: if530770 Summary: 专注于获取抖音最新的热榜数据，每小时更新，包含热点事件、热度值和跳转链接；支持查询近7天、近30天历史热榜，并"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-12T02:38:50.680Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-12T02:38:50.680Z","emptyReason":null},"stars":null,"forks":null,"downloads":953,"likes":null,"task":null,"library":null,"packageName":null,"latestVersion":"1.0.3","tractionLabel":"953 downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-12T02:38:50.665Z","emptyReason":null},"lastUpdatedAt":"2026-10-12T02:38:50.680Z","lastCrawledAt":"2026-10-12T02:38:50.665Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-13T02:38:50.665Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.3","createdAt":"2026-06-05T03:41:32.871Z","changelog":"douyin-hot-trend 1.0.3 版本主要优化文档结构与资源指向，提升可用性与集成便捷性： - 更新并扩展 SKILL.md，优化指令说明、场景用法及常见问答，增强用户引导。 - 新增英文与中文 README 文件，标准化多语言文档支持。 - 新增 references/core_workflow.md，替换原 assets/core-workflow.md，规范 Agent 执行流程入口。 - 移除冗余文件（如_skillhub_meta.json、skill-card.md等），目录更清晰。 - 明确依赖与环境变量配置，完善一键安装及集成指导。 - 详细罗列使用场景、架构说明与技术栈，方便开发和维护。","fileCount":8,"zipByteSize":30765},{"version":"1.0.2","createdAt":"2026-04-27T06:46:03.321Z","changelog":"- 项目名称由 \"douyin-hot-trend\" 修正为 \"dy-hot-trend\" - 其他功能和描述保持不变，无新增或移除特性 - 未检测到文件内容更改，仅名称进行了统一调整","fileCount":7,"zipByteSize":23077},{"version":"1.0.1","createdAt":"2026-04-27T06:44:13.898Z","changelog":"- Initial release of version 1.0.1. - No file changes detected from the previous version.","fileCount":6,"zipByteSize":21930},{"version":"1.0.0","createdAt":"2026-04-27T06:27:39.574Z","changelog":"- Significant update: skill refactored for a more creator/operations workflow, with enhanced history analysis and automated reports. - Legacy Node.js scripts and related output files removed; now driven by new Python scripts. - Added support for retrieving and analyzing up to 30 days of historical Douyin hot trend data. - Introduced an executable workflow defined in assets/core-workflow.md and automated HTML report generation. - Documentation rewritten to focus on practical usage, including push subscription, topic analysis, and creator-centric tools.","fileCount":6,"zipByteSize":21804}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17dj64hf08x3mak1j99vesphd84gs9c:dy-hot-trend","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-if530770-dy-hot-trend/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-if530770-dy-hot-trend/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-if530770-dy-hot-trend/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-if530770-dy-hot-trend/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-if530770-dy-hot-trend/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-if530770-dy-hot-trend/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-14T02:51:00.504Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-if530770-dy-hot-trend/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-if530770-dy-hot-trend/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-if530770-dy-hot-trend/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-if530770-dy-hot-trend/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-12T02:38:50.680Z","emptyReason":null},"readme":"Skill: 抖音实时热点榜\n\nOwner: if530770\n\nSummary: 专注于获取抖音最新的热榜数据，每小时更新，包含热点事件、热度值和跳转链接；支持查询近7天、近30天历史热榜，并支持订阅定时推送。\n\nTags: latest:1.0.3\n\nVersion history:\n\nv1.0.3 | 2026-06-05T03:41:32.871Z | user\n\ndouyin-hot-trend 1.0.3 版本主要优化文档结构与资源指向，提升可用性与集成便捷性：\n\n- 更新并扩展 SKILL.md，优化指令说明、场景用法及常见问答，增强用户引导。\n- 新增英文与中文 README 文件，标准化多语言文档支持。\n- 新增 references/core_workflow.md，替换原 assets/core-workflow.md，规范 Agent 执行流程入口。\n- 移除冗余文件（如_skillhub_meta.json、skill-card.md等），目录更清晰。\n- 明确依赖与环境变量配置，完善一键安装及集成指导。\n- 详细罗列使用场景、架构说明与技术栈，方便开发和维护。\n\nv1.0.2 | 2026-04-27T06:46:03.321Z | user\n\n- 项目名称由 \"douyin-hot-trend\" 修正为 \"dy-hot-trend\"\n- 其他功能和描述保持不变，无新增或移除特性\n- 未检测到文件内容更改，仅名称进行了统一调整\n\nv1.0.1 | 2026-04-27T06:44:13.898Z | user\n\n- Initial release of version 1.0.1.\n- No file changes detected from the previous version.\n\nv1.0.0 | 2026-04-27T06:27:39.574Z | user\n\n- Significant update: skill refactored for a more creator/operations workflow, with enhanced history analysis and automated reports.\n- Legacy Node.js scripts and related output files removed; now driven by new Python scripts.\n- Added support for retrieving and analyzing up to 30 days of historical Douyin hot trend data.\n- Introduced an executable workflow defined in assets/core-workflow.md and automated HTML report generation.\n- Documentation rewritten to focus on practical usage, including push subscription, topic analysis, and creator-centric tools.\n\nArchive index:\n\nArchive v1.0.3: 8 files, 30765 bytes\n\nFiles: README.en.md (6312b), README.md (5038b), references/core_workflow.md (11828b), scripts/gen_douyin_hot_html.py (32937b), scripts/hotspot_fetcher.py (6546b), skill-card.md (2539b), SKILL.md (12437b), _meta.json (131b)\n\nFile v1.0.3:SKILL.md\n\n---\r\nname: douyin-hot-trend\r\ndescription: 专注于获取抖音最新的热榜数据，每小时更新，包含热点事件、热度值和跳转链接；支持查询近7天、近30天历史热榜，并支持订阅定时推送。\r\n---\r\n\r\n# 抖音热榜\r\n\r\n## 简介\r\n\r\n抖音热榜是一款实时追踪抖音平台热点趋势的数据工具，对接 [红狐Hub](https://redfox.hk/) 数据 API，每小时更新热榜内容，并提供创作者视角的深度分析。\r\n\r\n通过简单的自然语言指令，你可以：\r\n\r\n- 📊 **实时热榜查询**：每 60 分钟抓取抖音 TOP 50 榜单，同步热度值与跳转链接\r\n- 📅 **历史热榜回溯**：覆盖近 7 天、近 30 天历史数据，支持按日期与关键词检索\r\n- 🔀 **热榜数据对比**：对比任意两个时间点（如昨天 vs 今天）的热榜变化\r\n- 💡 **深度洞察分析**：从创作者视角提供选题机会、标题套路与趋势预判\r\n- 🔔 **个性化订阅**：支持每小时或每日定时推送热榜数据\r\n\r\n适用于内容创作者、短视频运营、MCN 机构、品牌营销人员等需要追踪抖音热点、寻找创作灵感、制定内容策略的场景。\r\n\r\n**技术基础**：Python 3.x + `requests` 库，通过 红狐Hub APIKey获取数据。\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 🎯 核心功能\r\n\r\n- **📊 实时热榜**：获取抖音当前 TOP 50 热榜，每小时刷新，展示排名、热度值、话题标题和跳转链接\r\n- **📅 历史回溯**：支持查询近 7 天或近 30 天历史热榜，最长覆盖 30 天\r\n- **💡 创作者洞察**：自动生成选题机会分析、标题套路拆解、趋势预判与行动建议\r\n- **📄 可视化报告**：一键生成紫色极简风格 HTML 页面，支持导出 PDF，每条记录可点击跳转\r\n- **🔔 订阅推送**：支持每小时或每日定时推送，自动追踪热点变化\r\n\r\n### ✨ 特色亮点\r\n\r\n- **⚡ 自然语言交互**：输入「今日热榜」「近7天热榜」等即可查询，无需记忆命令参数\r\n- **🔒 三级鉴权回退**：API Key 优先从环境变量读取，自动回退到 Shell 配置文件\r\n- **✅ 数据一致性**：表格、洞察、HTML、PDF 全链路数据一致，不做加工或美化\r\n- **🎬 创作者视角**：每条洞察都回答「怎么用」，给出可执行的行动建议\r\n\r\n---\r\n\r\n## 一键安装\r\n\r\n### 前置条件\r\n\r\n- 已安装 Python 3.x 及 `requests` 库\r\n- 已注册 [红狐Hub官网](https://redfox.hk/login) 账号并获取 API Key（格式 `ak_xxxxxxxx`）\r\n- 新注册用户将获赠免费积分，可立即开始使用\r\n\r\n### 安装方式\r\n\r\n#### 方式一：WorkBuddy（龙虾）技能安装（推荐）\r\n\r\n1. 将 `douyin-hot-trend` 技能文件夹复制到 WorkBuddy 的 skills 目录下\r\n2. 在 WorkBuddy 对话中直接说「抖音热榜」或「今日热榜」，Agent 将自动加载本技能\r\n3. 配置 API Key（见下方「环境变量配置」）\r\n4. 安装 Python 依赖：\r\n\r\n```bash\r\npip install requests\r\n```\r\n\r\n#### 方式二：Cursor / 其他 Agent 环境手动安装\r\n\r\n1. 将技能文件夹放置到对应环境的 skills 目录\r\n2. 确保 Agent 可读取 `SKILL.md` 与 `references/core_workflow.md`\r\n3. 配置 `REDFOX_API_KEY` 环境变量\r\n4. 执行 `pip install requests`\r\n\r\n### 环境变量配置\r\n\r\n| 变量名 | 必填 | 说明 |\r\n|------|------|------|\r\n| `REDFOX_API_KEY` | 是 | 红狐Hub API 访问密钥，格式 `ak_xxxxxxxx` |\r\n\r\n**配置方式**（任选其一）：\r\n\r\n```bash\r\n# 方式一：直接设置环境变量（推荐）\r\nexport REDFOX_API_KEY=ak_xxxxxxxx\r\n\r\n# 方式二：写入 Shell 配置文件（~/.bashrc / ~/.bash_profile / ~/.zshrc）\r\necho 'export REDFOX_API_KEY=ak_xxxxxxxx' >> ~/.bashrc\r\nsource ~/.bashrc\r\n```\r\n\r\n若未配置环境变量，技能将自动从 Shell 配置文件读取；若仍未获取到，会在运行时提示配置。\r\n\r\n**在 WorkBuddy 中配置 Key**：可在系统环境变量中设置 `REDFOX_API_KEY`，或在 Shell 配置文件中写入后重启 WorkBuddy，无需在每次对话中手动传入。\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n### 基础使用\r\n\r\n#### 1. 查看实时热榜\r\n\r\n告诉助手你想查看当前抖音热点：\r\n\r\n> **用户**：抖音热榜\r\n> **助手**：为您展示抖音实时热榜 TOP 20（含排名、热度值、话题链接），并附创作者洞察报告。\r\n\r\n#### 2. 查看历史热榜\r\n\r\n查询指定时间范围的历史数据：\r\n\r\n> **用户**：近7天热榜\r\n> **助手**：为您展示近 7 天抖音历史热榜，支持按日期回溯热点演变。\r\n\r\n> **用户**：4月15日热榜\r\n> **助手**：为您查询 4 月 15 日当天的热榜数据。\r\n\r\n#### 3. 加载完整榜单\r\n\r\n默认展示 TOP 20，可继续加载至 TOP 50：\r\n\r\n> **用户**：继续加载\r\n> **助手**：为您展示 TOP 21–50，并生成包含完整 TOP 50 的 HTML 报告。\r\n\r\n### 高级使用\r\n\r\n#### 1. 创作者洞察\r\n\r\n热榜展示后自动输出深度分析：\r\n\r\n> **用户**：今日热榜\r\n> **助手**：（展示表格后）输出爆款选题机会、标题套路破解、趋势预判与行动建议。\r\n\r\n#### 2. 热榜对比\r\n\r\n对比两个时间点的热榜变化：\r\n\r\n> **用户**：对比昨天和今天的热榜\r\n> **助手**：为您对比两日热榜排名与热度变化，标注新进榜与掉榜话题。\r\n\r\n#### 3. 订阅推送\r\n\r\n设置定时自动推送：\r\n\r\n> **用户**：订阅每日热榜推送\r\n> **助手**：已设置每日推送，将在指定时间自动推送 TOP 50 完整热榜数据。\r\n\r\n> **用户**：取消订阅\r\n> **助手**：已取消定时推送。\r\n\r\n#### 4. 生成报告\r\n\r\n每次查询自动生成可视化报告：\r\n\r\n> **用户**：今日热榜\r\n> **助手**：（查询完成后）已生成 HTML 页面与 PDF 文件，数据与表格展示完全一致，支持点击跳转。\r\n\r\n### 常用指令速查\r\n\r\n| 指令 | 功能 |\r\n|------|------|\r\n| 抖音热榜 / 今日热榜 | 查询实时热榜 TOP 20 |\r\n| 昨日热榜 | 查询昨日热榜 |\r\n| 近7天热榜 | 查询近 7 天历史热榜 |\r\n| 近30天热榜 | 查询近 30 天历史热榜 |\r\n| X月X日热榜 | 查询指定日期热榜 |\r\n| 继续加载 / 加载更多 | 加载 TOP 21–50 完整榜单 |\r\n| 订阅每日/每小时推送 | 设置定时推送 |\r\n| 取消订阅 | 停止定时推送 |\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n### 场景一：内容创作者找选题\r\n\r\n**角色**：抖音短视频创作者\r\n\r\n**需求**：每天快速了解平台热点，找到适合自己赛道的创作方向\r\n\r\n**使用方式**：\r\n1. 每天早晨说「今日热榜」，获取最新热点\r\n2. 查看创作者洞察报告，获取选题建议和标题公式\r\n3. 直接套用可迁移选题，快速产出内容\r\n\r\n**预期收益**：缩短选题时间，提高内容命中率\r\n\r\n---\r\n\r\n### 场景二：MCN 机构运营管理\r\n\r\n**角色**：MCN 运营人员\r\n\r\n**需求**：监控平台热点趋势，为旗下达人提供选题指导和内容策略\r\n\r\n**使用方式**：\r\n1. 订阅每日热榜推送，自动获取最新热点\r\n2. 查看历史热榜，分析热点演变规律\r\n3. 将洞察报告分享给达人团队，指导内容创作\r\n\r\n**预期收益**：提升团队内容策略的时效性和精准度\r\n\r\n---\r\n\r\n### 场景三：品牌营销热点借势\r\n\r\n**角色**：品牌营销经理\r\n\r\n**需求**：及时发现可借势的热点话题，制定蹭热点营销方案\r\n\r\n**使用方式**：\r\n1. 关注每日热榜，筛选与品牌调性匹配的热点\r\n2. 分析趋势预判，提前布局内容\r\n3. 导出 HTML/PDF 报告，用于团队沟通和方案汇报\r\n\r\n**预期收益**：提升品牌热点的响应速度和借势效果\r\n\r\n---\r\n\r\n### 场景四：短视频运营学习研究\r\n\r\n**角色**：短视频运营新手\r\n\r\n**需求**：学习爆款内容的创作规律，提升运营能力\r\n\r\n**使用方式**：\r\n1. 定期查看热榜和创作者洞察\r\n2. 学习标题套路和情绪触发词\r\n3. 模仿可迁移选题进行练习\r\n\r\n**预期收益**：快速建立内容 sense，掌握爆款创作方法论\r\n\r\n---\r\n\r\n## 项目架构\r\n\r\n### 目录结构\r\n\r\n```\r\ndouyin-hot-trend/\r\n├── SKILL.md                          # 技能说明文档（当前文件）\r\n├── references/\r\n│   └── core_workflow.md              # Agent 核心工作流指令\r\n├── scripts/\r\n│   ├── hotspot_fetcher.py            # 热榜数据获取脚本\r\n│   └── gen_douyin_hot_html.py        # HTML 可视化报告生成脚本\r\n└── assets/\r\n    └── douyin_hot_trend_template.html # HTML 页面模板\r\n```\r\n\r\n### 核心模块说明\r\n\r\n| 模块 | 文件 | 职责 |\r\n|------|------|------|\r\n| 数据获取 | `hotspot_fetcher.py` | 调用 红狐Hub API 获取抖音热榜 JSON，支持实时与历史查询 |\r\n| 报告生成 | `gen_douyin_hot_html.py` | 将热榜数据渲染为紫色极简风格 HTML，支持导出 PDF |\r\n| 页面模板 | `douyin_hot_trend_template.html` | 独立 HTML 模板，支持占位符快速替换生成 |\r\n\r\n### 技术栈\r\n\r\n| 类别 | 说明 |\r\n|------|------|\r\n| 运行环境 | Python 3.x |\r\n| HTTP 请求 | 原生 `requests` 库 |\r\n| 认证方式 | `X-API-KEY` 请求头，三级回退（环境变量 → Shell 配置 → 提示配置） |\r\n| 数据来源 | [红狐Hub API](https://redfox.hk/) |\r\n| 部署平台 | WorkBuddy / Cursor 等 Agent 环境 |\r\n\r\n\r\n## 常见问答\r\n\r\n### 安装相关问题\r\n\r\n**Q1: 运行时提示「缺少 REDFOX_API_KEY 配置」怎么办？**\r\n\r\nA: 请按以下步骤排查：\r\n1. 确认已注册 红狐Hub 账号并在个人中心获取 API Key\r\n2. 设置环境变量：`export REDFOX_API_KEY=ak_xxxxxxxx`\r\n3. 或写入 Shell 配置文件后执行 `source ~/.bashrc` 使其生效\r\n4. 确认 API Key 格式正确，以 `ak_` 开头\r\n\r\n**Q2: 需要安装哪些 Python 依赖？**\r\n\r\nA: 仅需 `requests` 库：`pip install requests`\r\n\r\n**Q3: 如何在 WorkBuddy（龙虾）中启用本技能？**\r\n\r\nA: 将技能文件夹放入 WorkBuddy 的 skills 目录，配置好 `REDFOX_API_KEY` 后，在对话中说「抖音热榜」即可触发。Agent 将按 `references/core_workflow.md` 执行完整工作流。\r\n\r\n---\r\n\r\n### 使用相关问题\r\n\r\n**Q4: 热榜数据多久更新一次？**\r\n\r\nA: 每小时更新一次。每次查询都会调用 API 获取最新数据，不依赖本地缓存。\r\n\r\n**Q5: 可以查询多久之前的历史数据？**\r\n\r\nA: 最长支持查询近 30 天的历史热榜。超过 30 天的数据暂不支持。\r\n\r\n\r\n---\r\n\r\n### 故障排除\r\n\r\n**Q6: API 调用失败怎么办？**\r\n\r\nA: 请按以下顺序排查：\r\n1. 检查网络连接，确认可以访问 `https://redfox.hk`\r\n2. 确认 API Key 未过期，账户积分是否充足\r\n3. 检查环境变量：`echo $REDFOX_API_KEY`\r\n4. 稍后重试，API 服务可能存在临时波动\r\n\r\n**Q7: 订阅推送没有收到怎么办？**\r\n\r\nA: 确认订阅已成功设置。如需重新设置，说「取消订阅」后重新订阅。如仍有问题，检查WorkBuddy等系统的自动化任务是否正常运行。\r\n\r\n**Q8: HTML 报告预览不成功或显示空白怎么办？**\r\n\r\nA: 请按以下方式处理：\r\n1. 确认 HTML 文件已成功生成（脚本会输出 `✅ 已生成` 提示）\r\n2. 直接双击打开交付的 HTML 文件，用 Chrome/Edge 浏览器查看，不依赖WorkBuddy等系统内置预览\r\n3. 若文件已交付但内置预览空白，属于已知限制——Windows 中文用户名路径可能导致预览组件兼容性问题，直接用浏览器打开即可正常显示\r\n\r\n---\r\n\r\n### 安全与许可\r\n\r\n**Q9: API Key 如何安全存储？**\r\n\r\nA: 建议通过环境变量或 Shell 配置文件存储，不要将 Key 写入代码仓库或公开分享。本技能支持三级鉴权回退，优先读取环境变量，避免在对话中明文传递。\r\n\r\n**Q10: 数据来源与使用许可？**\r\n\r\nA: 热榜数据来自 [红狐Hub](https://redfox.hk/) 官方 API，使用时须遵守 红狐Hub 平台服务条款及抖音平台相关规定。本技能仅作数据展示与分析辅助，不保证数据的商业用途合规性。\r\n\r\n---\r\n\r\n### 获取帮助\r\n\r\n如有其他问题，可通过以下方式获取帮助：\r\n\r\n- 📖 查阅 Agent 执行参考：`references/core_workflow.md`\r\n- 🌐 红狐Hub 官网：[https://redfox.hk](https://redfox.hk/)\r\n- 📧 联系 红狐Hub 平台客服获取 API 相关问题支持\r\n\r\n---\r\n\r\n**Agent 执行参考**：完整的操作步骤、输出格式、数据规则等执行层指令，请查阅 `references/core_workflow.md`。\n\nFile v1.0.3:README.md\n\n# 抖音热榜神器 / douyin-hot-trend\r\n\r\n---\r\n\r\n## 简介\r\n\r\n实时追踪抖音热点、挖掘爆款规律，帮助内容创作者和运营者高效蹭热点、找选题的智能热榜工具。\r\n\r\n**核心价值**\r\n\r\n- 每小时自动更新抖音 TOP 50 榜单，热度值与跳转链接一键可见\r\n- 覆盖近 7 天、近 30 天历史热榜，随时回溯过往热点演变\r\n- 从创作者视角自动生成选题机会、标题套路与趋势预判\r\n- 支持任意两个时间点热榜对比，清晰标注新进榜与掉榜话题\r\n- 支持每小时或每日定时推送，无需手动触发\r\n\r\n**适用对象**\r\n\r\n- 🎬 **短视频创作者** — 每天快速锁定热点方向，缩短选题时间\r\n- 📣 **MCN 机构运营** — 统一监控平台趋势，高效指导达人内容策略\r\n- 🏷️ **品牌营销人员** — 发现可借势话题，提升热点响应速度\r\n- 📚 **运营新手** — 学习爆款标题套路，快速建立内容感知\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 核心功能\r\n\r\n- **实时热榜查询**：获取抖音当前 TOP 50 热榜，包含排名、热度值、话题标题和跳转链接，每 60 分钟刷新\r\n- **历史热榜回溯**：支持查询近 7 天或近 30 天历史数据，可按日期指定查看特定某天\r\n- **热榜对比**：对比任意两个时间点的热榜排名与热度变化，自动标注新进榜与掉榜话题\r\n- **创作者洞察报告**：热榜展示后自动输出爆款选题机会、标题套路拆解、趋势预判与行动建议\r\n- **可视化报告导出**：一键生成紫色极简风格 HTML 页面，支持导出 PDF，每条话题可点击跳转\r\n- **定时订阅推送**：支持每小时或每日定时推送，自动追踪热点变化\r\n\r\n---\r\n\r\n## 密钥获取与安全说明\r\n\r\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\r\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`)提供。\r\n- 请前往 [红狐 hub](https://redfox.hk?source=github) 注册账号，获取 `REDFOX_API_KEY`。\r\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\r\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\r\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n直接用自然语言描述需求，无需记忆命令。\r\n\r\n### 常用说法速查\r\n\r\n| 意图         | 示例话术               | 效果                                                  |\r\n| ------------ | ---------------------- | ----------------------------------------------------- |\r\n| 查看实时热榜 | 抖音热榜 / 今日热榜    | 展示当前 TOP 20，含热度值与话题链接，附创作者洞察报告 |\r\n| 查看昨日热榜 | 昨日热榜               | 查询昨天全天热榜数据                                  |\r\n| 查看历史热榜 | 近7天热榜 / 近30天热榜 | 按时间范围回溯历史热点                                |\r\n| 查看指定日期 | 5月15日热榜            | 查询特定日期的榜单数据                                |\r\n| 加载完整榜单 | 继续加载 / 加载更多    | 从 TOP 20 扩展至完整 TOP 50                           |\r\n| 对比热榜变化 | 对比昨天和今天的热榜   | 输出两日热榜差异，标注新进榜与掉榜话题                |\r\n| 订阅推送     | 订阅每日热榜推送       | 设置定时自动推送，每日获取最新热榜                    |\r\n| 取消订阅     | 取消订阅               | 停止定时推送                                          |\r\n\r\n### 输出示例\r\n\r\n查询「今日热榜」后，你将收到：\r\n\r\n1. **热榜表格**：序号、话题标题、热度值、跳转链接（TOP 20，可继续加载至 50）\r\n2. **创作者洞察报告**：\r\n   - 🔥 爆款选题机会（可迁移话题与创作方向）\r\n   - 🎯 标题套路拆解（情绪词、句式结构）\r\n   - 📈 趋势预判（哪些话题正在上升/下降）\r\n   - 💡 行动建议（可执行的内容策略）\r\n3. **可视化报告**：自动生成 HTML 页面，支持导出 PDF\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n| 场景         | 角色         | 示例问法                       | 收益                                         |\r\n| ------------ | ------------ | ------------------------------ | -------------------------------------------- |\r\n| 每日选题灵感 | 短视频创作者 | 「今日热榜」                   | 快速锁定热点方向，获取可迁移选题与标题公式   |\r\n| 热点趋势监控 | MCN 运营人员 | 「近7天热榜」                  | 掌握一周热点演变规律，为达人提供内容策略参考 |\r\n| 热点借势营销 | 品牌营销经理 | 「对比本周热榜变化」           | 发现持续发酵话题，提前布局品牌借势内容       |\r\n| 运营学习研究 | 短视频新手   | 「今日热榜，帮我分析标题套路」 | 学习爆款句式结构，快速建立内容感知           |\r\n\r\n---\n\nFile v1.0.3:_meta.json\n\n{\n  \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n  \"slug\": \"dy-hot-trend\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1780630892871\n}\n\nFile v1.0.3:references/core_workflow.md\n\n# 核心工作流（Agent 执行参考）\r\n\r\n本文档为 Agent 执行层的详细工作流指令，包含数据获取、展示、分析、订阅、HTML 生成等完整步骤。\r\n\r\n## 任务目标\r\n\r\n- 获取抖音平台热榜数据，并提供创作者视角的深度洞察\r\n- 触发条件：用户询问抖音热榜、热门话题、热搜榜单、历史热榜、订阅热榜推送等\r\n\r\n## 操作步骤\r\n\r\n### 1. 获取热榜数据\r\n\r\n**Python 执行说明**：\r\n\r\n- 优先使用系统默认 `python` 命令\r\n- 若 `python` 不可用（Windows Git Bash 常见），使用 WorkBuddy 管理的 Python 全路径：`\"C:/Users/马祯/.workbuddy/binaries/python/versions/3.13.12/python.exe\"`\r\n- 始终先 `cd` 到技能根目录再执行\r\n\r\n#### 1.1 实时热榜（默认）\r\n\r\n```bash\r\ncd \"C:/Users/马祯/.workbuddy/skills/douyin-hot-trend\" && python scripts/hotspot_fetcher.py\r\n```\r\n\r\n#### 1.2 历史热榜查询\r\n\r\n支持查询近7天、近30天的历史热榜数据：\r\n\r\n```bash\r\n# 查询昨日热榜（假设今天是2026-04-16）\r\ncd \"C:/Users/马祯/.workbuddy/skills/douyin-hot-trend\" && python scripts/hotspot_fetcher.py --start-date 2026-04-15 --end-date 2026-04-16\r\n\r\n# 查询近7天热榜（假设今天是2026-04-16）\r\ncd \"C:/Users/马祯/.workbuddy/skills/douyin-hot-trend\" && python scripts/hotspot_fetcher.py --start-date 2026-04-09 --end-date 2026-04-16\r\n\r\n# 查询近30天热榜（假设今天是2026-04-16）\r\ncd \"C:/Users/马祯/.workbuddy/skills/douyin-hot-trend\" && python scripts/hotspot_fetcher.py --start-date 2026-03-17 --end-date 2026-04-16\r\n\r\n# 查询4月1日热榜\r\ncd \"C:/Users/马祯/.workbuddy/skills/douyin-hot-trend\" && python scripts/hotspot_fetcher.py --start-date 2026-04-01 --end-date 2026-04-02\r\n```\r\n\r\n**日期范围规则**：\r\n- 日期范围是 **[start_date, end_date)** 左闭右开区间\r\n- 例如：`start-date 2026-04-01 --end-date 2026-04-02` 查询的是4月1日当天的数据\r\n- 例如：`start-date 2026-04-09 --end-date 2026-04-16` 查询的是4月9日至4月15日共7天的数据\r\n\r\n**参数说明**：\r\n- `--start-date`：开始日期（包含），格式 YYYY-MM-DD\r\n- `--end-date`：结束日期（不包含），格式 YYYY-MM-DD\r\n- `--days`：查询天数，自动计算日期范围（end_date为今天）\r\n- **最长查询范围：30天**\r\n\r\n#### 1.3 意图判断逻辑\r\n\r\n根据用户意图自动选择查询方式（假设今天日期为T）：\r\n\r\n| 用户表达 | start_date | end_date | 查询范围 |\r\n|---------|-----------|----------|---------|\r\n| \"今日热榜\" / \"最新热榜\" / \"热榜\" | 无（实时） | 无（实时） | 实时 |\r\n| \"昨日热榜\" / \"昨天热榜\" | T-1 | T | 昨日当天 |\r\n| \"近7天热榜\" / \"一周热榜\" | T-7 | T | 近7天 |\r\n| \"近30天热榜\" / \"本月热榜\" | T-30 | T | 近30天 |\r\n| \"X月X日热榜\" | X月X日 | X月X日+1 | 指定日期当天 |\r\n\r\n### 2. 展示热榜数据表格\r\n\r\n将脚本返回的JSON数据转换为表格形式展示。\r\n\r\n**标题格式**：\r\n\r\n实时热榜：`抖音实时热榜（2026-04-14 16:00 每小时更新）`\r\n\r\n历史热榜：`抖音历史热榜（2026-04-14 至 2026-04-15）`\r\n\r\n**表格格式**（默认展示TOP20数据）：\r\n\r\n| 排名 | 热度值 | 话题 | 核心内容 |\r\n|-----|-------|------|---------|\r\n\r\n**表格绘制规则**：\r\n1. 排名：默认 `TOP01` 到 `TOP20`（双数字符）；加载更多 `TOP21` 到 `TOP50`\r\n2. 热度值：保留一位小数，单位统一为 `w`（小写），示例 `1109.6w`\r\n3. 话题：使用 Markdown 链接格式 `[标题](URL)`\r\n4. 核心内容：30-80字，概括话题主要内容\r\n\r\n**加载更多**：\r\n\r\n表格下方展示：\r\n> 抖音实时热榜为你提供TOP50的数据，是否继续加载剩余30条？\r\n\r\n- 确认后仅输出 TOP21-TOP50，不重复 TOP1-20\r\n- 确认后必须生成新的 HTML 文件，包含完整 TOP50 数据\r\n\r\n### 3. 创作者洞察报告\r\n\r\n展示数据后自动输出创作者视角的深度洞察：\r\n\r\n#### 3.1 爆款选题机会\r\n\r\n分析热榜内容的共同规律，提供可迁移的选题建议。\r\n\r\n输出格式：\r\n\r\n```\r\n📌 爆款选题机会\r\n\r\n发现：[核心发现]\r\n- 数据支撑：[具体数据]\r\n- 核心公式：[拆解出的公式]\r\n\r\n🔄 可迁移选题：\r\n· 美妆赛道：[具体选题建议]\r\n· 穿搭赛道：[具体选题建议]\r\n· 其他赛道：[具体选题建议]\r\n```\r\n\r\n#### 3.2 标题套路破解\r\n\r\n提炼爆款标题模式和情绪触发词。\r\n\r\n输出格式：\r\n\r\n```\r\n✏️ 标题套路破解\r\n\r\n爆款标题模式TOP3：\r\n1. [类型名称]：[示例]\r\n2. [类型名称]：[示例]\r\n3. [类型名称]：[示例]\r\n\r\n立即可用的标题公式：\r\n· \"用[方法]，[效果]\" → 例：用万能旅行拍照姿势美美出片\r\n· \"耗时[时间]，拍下[成果]\" → 例：耗时三年拍下古诗词里的中国\r\n· \"原来[认知]，真的存在\" → 例：原来古诗词里的河南真的存在\r\n\r\n情绪触发词：\r\n[高频词列表]\r\n```\r\n\r\n#### 3.3 趋势预判与行动建议\r\n\r\n基于热榜数据给出前瞻性判断。\r\n\r\n输出格式：\r\n\r\n```\r\n📈 趋势预判\r\n\r\n一、[预判点1]\r\n   [具体分析内容和依据]\r\n   行动建议：[具体建议]\r\n\r\n二、[预判点2]\r\n   [具体分析内容和依据]\r\n   行动建议：[具体建议]\r\n\r\n三、[预判点3]\r\n   [具体分析内容和依据]\r\n   行动建议：[具体建议]\r\n```\r\n\r\n#### 3.4 分析原则\r\n\r\n- 基于实际数据，不编造\r\n- 给出可执行的行动建议，不泛泛而谈\r\n- 从创作者视角出发，每条洞察都要回答\"怎么用\"\r\n- 保持专业但易懂，避免术语堆砌\r\n\r\n### 4. 询问订阅\r\n\r\n分析完成后必须主动询问是否需要订阅。\r\n\r\n```\r\n🔔 订阅服务\r\n\r\n是否需要订阅每日/每小时热榜推送？\r\n\r\n1. 每小时推送 - 实时追踪热点变化（默认推送TOP50完整数据）\r\n2. 每日推送 - 每天早/晚获取一次热榜汇总（默认推送TOP50完整数据）\r\n3. 暂不需要 - 仅本次查询\r\n\r\n请回复数字或\"取消\"，如有其他推送时间偏好请说明。\r\n```\r\n\r\n**订阅处理流程**：\r\n- 用户选择1（每小时推送）：记录偏好，后续每小时自动推送TOP50数据\r\n- 用户选择2（每日推送）：询问具体推送时间（早/晚），记录偏好，推送TOP50数据\r\n- 用户选择3或\"取消\"：结束本次交互，不记录\r\n- 用户有其他偏好：灵活记录并确认\r\n\r\n订阅数据默认推送TOP50完整数据；如用户特别要求TOP20，按用户要求执行。\r\n\r\n### 5. 生成热榜HTML页面（强制执行）\r\n\r\nHTML文件生成是必须执行的强制步骤，不等待用户回复，立即执行。\r\n\r\n**执行顺序**：获取数据（保存JSON） → 展示表格 → 创作者洞察 → 询问订阅 → 立即执行HTML生成（从JSON读取）\r\n\r\n**关键优化**：HTML生成器通过 `--json-file` 参数直接读取第一步保存的JSON文件，不再重复调用API。确保 API 调用次数始终为 1 次。\r\n\r\n**触发场景**：\r\n\r\n| 场景 | HTML数据范围 | 文件命名 |\r\n|-----|------------|---------|\r\n| 查询实时热榜 | TOP20（严格20条） | `douyin_hot_YYYYMMDD_HHMM.html` |\r\n| 查询历史热榜 | TOP20（严格20条） | `douyin_hot_YYYYMMDD_YYYYMMDD.html` |\r\n| 用户加载更多 | TOP50（严格50条） | `douyin_hot_top50_YYYYMMDD_HHMM.html` |\r\n\r\n**HTML数据展示规则**：\r\n- 默认展示TOP20，仅用户明确要求时展示TOP50\r\n- 数据条数严格控制：TOP20模式20条，TOP50模式50条\r\n- 禁止自动扩展数据范围\r\n\r\n**执行流程**（两步，共1次API调用）：\r\n\r\n```bash\r\n# 步骤1：获取数据并保存为JSON文件\r\ncd \"C:/Users/马祯/.workbuddy/skills/douyin-hot-trend\" && python scripts/hotspot_fetcher.py > scripts/temp_hot_data.json\r\n\r\n# 步骤2：从JSON文件生成HTML（不再调用API）\r\n# 实时热榜（TOP20）\r\ncd \"C:/Users/马祯/.workbuddy/skills/douyin-hot-trend\" && python scripts/gen_douyin_hot_html.py --json-file scripts/temp_hot_data.json --output scripts/douyin_hot_20260529_1000.html\r\n\r\n# 加载更多（TOP50）\r\ncd \"C:/Users/马祯/.workbuddy/skills/douyin-hot-trend\" && python scripts/gen_douyin_hot_html.py --json-file scripts/temp_hot_data.json --top 50 --output scripts/douyin_hot_top50_20260529_1000.html\r\n```\r\n\r\n**Agent执行注意事项**：\r\n- 第一步获取数据时，将 `hotspot_fetcher.py` 的 stdout 输出重定向保存到临时JSON文件\r\n- 第二步 HTML 生成时，必须使用 `--json-file` 参数指向临时JSON文件，禁止省略该参数\r\n- 临时 JSON 文件可在 HTML 生成后保留或清理，不影响功能\r\n\r\n**文件命名规则**：\r\n- 实时热榜：`douyin_hot_YYYYMMDD_HHMM.html`\r\n- 历史热榜：`douyin_hot_起始日期_结束日期.html`\r\n- 加载更多：`douyin_hot_top50_YYYYMMDD_HHMM.html`\r\n\r\n**加载更多场景**：仅输出TOP21-TOP50表格，立即生成新HTML文件（含完整TOP50）。\r\n\r\n**HTML输出要求**：\r\n- 必须直接输出完整HTML文件内容（使用代码块展示HTML源码）\r\n- 同时告知文件路径\r\n- 无论实时还是历史查询，都必须输出完整HTML\r\n\r\n**HTML 交付与预览流程**（强制执行）：\r\n\r\n1. **生成 HTML**：执行 `gen_douyin_hot_html.py` 脚本，确认 stderr 输出 `✅ 已生成` 和 `📊 共 X 条`\r\n2. **尝试预览**：调用 `preview_url` 工具，传入 `file:///C:/Users/马祯/.workbuddy/skills/douyin-hot-trend/scripts/文件名.html`\r\n3. **交付文件**：调用 `deliver_attachments` 工具，将 HTML 文件作为附件交付给用户\r\n4. **预览失败备用方案**：若 `preview_url` 因中文路径或 `file://` 协议限制未能正常渲染，提示用户直接双击打开交付的 HTML 文件。不要反复重试 `preview_url`\r\n\r\n**预览注意事项**：\r\n- Windows 中文用户名路径（如 `马祯`）可能导致 `file://` 协议预览失败，这是已知限制\r\n- `deliver_attachments` 交付的文件用户可直接下载并在浏览器中打开，不受路径编码影响\r\n- 优先确保文件交付成功，预览仅作为辅助手段\r\n\r\n**PDF输出要求**：\r\n- 必须输出PDF文件\r\n- 生成方式：先生成HTML，再转换为PDF\r\n- PDF内容支持点击跳转到对应话题页面\r\n\r\n**数据一致性要求**：\r\n- HTML数据必须完全来自脚本执行的API返回数据\r\n- 禁止修改排名、热度值、话题标题、跳转链接\r\n- 禁止重新排序、美化或编造数据\r\n- HTML中每条数据必须与表格输出完全一致\r\n\r\n**HTML统计数据**：\r\n- 话题总数 = 实际展示数据条数（TOP20或TOP50）\r\n- 最高热度 = 所有展示热度值的最大值\r\n- 平均热度 = 所有展示热度值的平均值\r\n- 禁止编造统计数据\r\n\r\n### 6. 可选操作\r\n\r\n- 用户可点击标题直接跳转到对应热点页面\r\n- 可根据热度值排序或筛选特定话题\r\n- 可随时发送\"取消订阅\"停止推送\r\n\r\n## 资源索引\r\n\r\n- 数据获取脚本：`scripts/hotspot_fetcher.py` — 获取抖音热榜JSON数据\r\n- HTML生成脚本：`scripts/gen_douyin_hot_html.py` — 生成热榜可视化HTML页面\r\n- HTML模板文件：`assets/douyin_hot_trend_template.html` — HTML页面模板，支持占位符快速生成\r\n\r\n## 模板使用说明\r\n\r\n`douyin_hot_trend_template.html` 支持以下占位符：\r\n\r\n| 占位符 | 说明 | 示例值 |\r\n|-------|------|-------|\r\n| `{{PAGE_TITLE}}` | 页面标题 | 抖音实时热榜 |\r\n| `{{FETCH_TIME}}` | 获取时间 | 2026-04-17 10:00:00 |\r\n| `{{HOT_LIST_DATA}}` | 热榜数据JSON | `[{...}, {...}]` |\r\n\r\n将占位符替换为实际数据即可生成完整HTML页面。\r\n\r\n## 注意事项\r\n\r\n- API调用需要网络连接\r\n- 热榜数据实时更新，每次调用获取最新数据\r\n- 历史热榜最长查询范围为30天\r\n- 如遇API调用失败，提示用户稍后重试\r\n- 订阅偏好需要用户明确确认后记录\r\n- 分析必须基于实际数据，给出可执行的行动建议\n\nFile v1.0.3:README.en.md\n\n# Douyin Hot Trend Tracker / douyin-hot-trend\r\n\r\n---\r\n\r\n## Introduction\r\n\r\nA smart hot trend tool that tracks Douyin trending topics in real time, uncovers viral content patterns, and helps creators and operators catch hot topics and find content ideas efficiently.\r\n\r\n**Core Value**\r\n\r\n- Automatically updates the Douyin TOP 50 chart every hour, with heat scores and direct links at a glance\r\n- Covers up to 30 days of historical charts so you can trace past trend shifts anytime\r\n- Automatically generates topic opportunity analysis, title pattern breakdowns, and trend forecasts from a creator's perspective\r\n- Supports side-by-side comparison of any two time points, clearly marking newly-entered and dropped topics\r\n- Supports hourly or daily scheduled delivery — no manual triggering needed\r\n\r\n**Who It's For**\r\n\r\n- 🎬 **Short-video Creators** — Quickly lock in daily hot topics and shorten your ideation time\r\n- 📣 **MCN Operations Teams** — Monitor platform trends centrally and guide creator content strategies efficiently\r\n- 🏷️ **Brand Marketing Managers** — Identify leverage-worthy topics and respond to hot trends faster\r\n- 📚 **Operations Beginners** — Learn viral title patterns and quickly build content intuition\r\n\r\n---\r\n\r\n## Features\r\n\r\n### Core Functions\r\n\r\n- **Real-Time Chart Query**: Fetch the current Douyin TOP 50 trending topics with rankings, heat scores, titles, and clickable links — refreshed every 60 minutes\r\n- **Historical Chart Lookup**: Query up to the past 7 days or 30 days of trending data, with support for specifying an exact date\r\n- **Chart Comparison**: Compare rankings and heat score changes between any two time points, with new entrants and dropped topics automatically flagged\r\n- **Creator Insights Report**: After displaying the chart, automatically outputs viral topic opportunities, title pattern analysis, trend forecasts, and actionable recommendations\r\n- **Visual Report Export**: One-click generation of a minimal-purple-style HTML page with PDF export support and clickable links for every topic\r\n- **Scheduled Subscription Push**: Set up hourly or daily automated delivery to stay on top of trending topics without manual effort\r\n\r\n---\r\n\r\n## API Key Acquisition & Security\r\n\r\n- This skill requires the environment variable: `REDFOX_API_KEY`.\r\n- `REDFOX_API_KEY` is provided by [RedFoxHub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`).\r\n- Register an account at [RedFoxHub](https://redfox.hk?source=github) to obtain your `REDFOX_API_KEY`.\r\n- Configure the device environment variable `REDFOX_API_KEY` before using this skill.\r\n- Before providing a key, confirm its source, scope, expiration, and whether it supports reset/revocation.\r\n- Never hardcode or expose the key in plaintext in code, prompts, logs, or output files.\r\n\r\n---\r\n\r\n## Usage Guide\r\n\r\nJust describe your need in plain language — no commands to memorize.\r\n\r\n### Quick Reference\r\n\r\n| Intent                  | Example Phrase                                   | Result                                                                          |\r\n| ----------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------- |\r\n| Check real-time chart   | \"Douyin trending\" / \"Today's hot list\"           | Shows current TOP 20 with heat scores and links, plus a creator insights report |\r\n| Check yesterday's chart | \"Yesterday's hot list\"                           | Retrieves all-day trending data from yesterday                                  |\r\n| View historical chart   | \"Hot list from the past 7 days\" / \"Past 30 days\" | Traces trending topics over the selected time range                             |\r\n| View a specific date    | \"Hot list from May 15\"                           | Retrieves the chart for that specific date                                      |\r\n| Load the full chart     | \"Load more\" / \"Continue loading\"                 | Expands from TOP 20 to the full TOP 50                                          |\r\n| Compare chart changes   | \"Compare today's and yesterday's hot list\"       | Outputs differences between the two days with flagged new entrants and dropouts |\r\n| Subscribe to updates    | \"Subscribe to daily hot list push\"               | Sets up scheduled automatic delivery every day                                  |\r\n| Cancel subscription     | \"Cancel subscription\"                            | Stops scheduled delivery                                                        |\r\n\r\n### Sample Output\r\n\r\nAfter querying \"Today's hot list\", you will receive:\r\n\r\n1. **Trending Table**: Rank, topic title, heat score, and direct links (TOP 20; expandable to 50)\r\n2. **Creator Insights Report**:\r\n   - 🔥 Viral Topic Opportunities (transferable topics and content angles)\r\n   - 🎯 Title Pattern Breakdown (emotional hooks, sentence structures)\r\n   - 📈 Trend Forecast (which topics are rising or falling)\r\n   - 💡 Action Recommendations (executable content strategy suggestions)\r\n3. **Visual Report**: Auto-generated HTML page with PDF export support\r\n\r\n---\r\n\r\n## Use Cases\r\n\r\n| Scenario                 | Role                    | Example Query                                   | Benefit                                                                         |\r\n| ------------------------ | ----------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------- |\r\n| Daily content ideation   | Short-video Creator     | \"Today's hot list\"                              | Quickly identify hot directions and get transferable topics with title formulas |\r\n| Trend monitoring         | MCN Operations          | \"Past 7 days hot list\"                          | Track a week's trend shifts and inform creator content strategy                 |\r\n| Brand hot-topic leverage | Brand Marketing Manager | \"Compare this week's chart changes\"             | Spot sustained topics and plan brand content in advance                         |\r\n| Operations learning      | Short-video Beginner    | \"Today's hot list — analyze the title patterns\" | Learn viral sentence structures and rapidly build content intuition             |\r\n\r\n---\n\nFile v1.0.3:skill-card.md\n\n## Description:\n\n专注于获取抖音最新的热榜数据，每小时更新，包含热点事件、热度值和跳转链接；支持查询近7天、近30天历史热榜，并支持订阅定时推送。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[if530770](https://clawhub.ai/user/if530770)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal content creators, MCN operations teams, brand marketers, and short-video operators use this skill to query current and recent Douyin hot trends, compare trend movement, and generate creator-oriented content guidance and reports.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill requires a REDFOX_API_KEY and sends that key to redfox.hk.\n\nMitigation: Use a narrowly scoped, revocable key; set it as an environment variable; and avoid placing it in prompts, logs, generated files, or source code.\n\nRisk: The skill can read shell startup files while looking for REDFOX_API_KEY.\n\nMitigation: Review before installing and prefer environment-only key configuration instead of storing credentials in shell startup files.\n\nRisk: The skill writes local JSON, HTML, and PDF report artifacts.\n\nMitigation: Review generated artifacts before sharing them and remove any files that contain sensitive or unwanted trend data.\n\nRisk: Generated HTML reports can execute JavaScript from embedded data and cdnjs when opened.\n\nMitigation: Open generated reports only in a controlled browser context and review report contents before distribution.\n\n## Reference(s):\n\n- [Agent execution workflow](references/core_workflow.md)\n- [RedFoxHub](https://redfox.hk/)\n- [RedFoxHub API key settings](https://redfox.hk/settings/api-keys?source=clawhub)\n- [RedFoxHub Douyin hotspot API endpoint](https://redfox.hk/story/api/hotSpot/getListByPlatform)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, JSON, Files, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown trend tables and guidance, JSON API data, and generated HTML/PDF report files]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires a REDFOX_API_KEY and may create local JSON, HTML, and PDF report artifacts.]\n\n## Skill Version(s):\n\n1.0.3 (source: release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.2: 7 files, 23077 bytes\n\nFiles: _skillhub_meta.json (86b), assets/core-workflow.md (19867b), scripts/gen_douyin_hot_html.py (28775b), scripts/hotspot_fetcher.py (6089b), skill-card.md (2160b), SKILL.md (2741b), _meta.json (131b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: douyin-hot-trend\ndescription: >\n  抖音热榜神器 — 可以实时追踪抖音热点、挖掘爆款规律，并支持历史热榜数据回溯。使用时只需输入“查抖音热榜”“抖音热搜”“今日热榜”“近7天热榜”“历史热榜”等触发词，或订阅热榜推送，即可快速获取当前及过往的热门话题，帮助内容创作者和运营者高效蹭热点、找选题。\n---\n\n# 🔥 抖音热榜\n\n## 这是什么\n\n一个帮你搞定抖音热点全流程的小助手。\n\n**能做什么：**\n\n- 📡 实时获取抖音热榜数据，每小时自动更新\n- 📅 查询近7天、近30天历史热榜，回溯热点轨迹\n- 🧠 从创作者视角拆解爆款规律，给出可落地的选题和标题公式\n- 📊 生成紫色极简风 HTML 可视化页面，支持导出 PDF\n- 🔔 可订阅每日/每小时热榜推送，不错过任何一个流量密码\n\n## 什么时候用它\n\n| 场景                   | 举例                           |\n| ---------------------- | ------------------------------ |\n| 想知道今天抖音在火什么 | \"帮我看看抖音热榜\"             |\n| 追踪某个话题的历史热度 | \"查一下这周的热榜变化\"         |\n| 写内容前找选题灵感     | \"最近什么话题最热？\"           |\n| 研究爆款标题的套路     | \"分析下最近热榜标题有什么规律\" |\n| 定期追踪热点做运营     | \"每天早上给我推送热榜\"         |\n\n## 怎么用\n\n```\n查今日抖音热榜\n查近7天热榜\n看看4月1日的热榜\n分析热榜标题规律\n帮我订阅每天早上9点的热榜推送\n```\n\n## 快速开始\n\n> **⚠️ 触发本技能时，必须先读取以下文件获取完整执行流程：**\n>\n> 📄 **[assets/core-workflow.md](assets/core-workflow.md)**\n\n读取方式：用 `read_file` 工具读取 `assets/core-workflow.md`（相对于本技能根目录），然后严格按照其中定义的步骤依次执行。\n\n## 注意事项\n\n- 🌐 需要网络连接，请确保网络通畅\n- ⏰ 历史热榜最长查询30天，超出范围会报错\n- 📌 分析结论全部基于真实数据，不编造，给出的建议都是可执行的\n- 💾 订阅偏好需要你明确回复确认才会记录\n- 📄 HTML 和 PDF 生成是自动执行的，不需要你额外操作\n\n## 资源一览\n\n| 资源                 | 路径                                    |\n| -------------------- | --------------------------------------- |\n| 核心执行流程（必读） | `assets/core-workflow.md`               |\n| 数据获取脚本         | `scripts/hotspot_fetcher.py`            |\n| HTML 生成脚本        | `scripts/gen_douyin_hot_html.py`        |\n| HTML 模板            | `assets/douyin_hot_trend_template.html` |\n\nFile v1.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n  \"slug\": \"dy-hot-trend\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1777272363321\n}\n\nFile v1.0.2:assets/core-workflow.md\n\n# 抖音热榜 — 核心执行流程\r\n\r\n## 操作步骤\r\n\r\n### 1. 获取热榜数据\r\n\r\n#### 1.1 实时热榜（默认）\r\n\r\n```bash\r\npython scripts/hotspot_fetcher.py\r\n```\r\n\r\n#### 1.2 历史热榜查询\r\n\r\n支持查询近7天、近30天的历史热榜数据：\r\n\r\n```bash\r\n# 查询昨日热榜（假设今天是2026-04-16）\r\npython scripts/hotspot_fetcher.py --start-date 2026-04-15 --end-date 2026-04-16\r\n\r\n# 查询近7天热榜（假设今天是2026-04-16）\r\npython scripts/hotspot_fetcher.py --start-date 2026-04-09 --end-date 2026-04-16\r\n\r\n# 查询近30天热榜（假设今天是2026-04-16）\r\npython scripts/hotspot_fetcher.py --start-date 2026-03-17 --end-date 2026-04-16\r\n\r\n# 查询4月1日热榜\r\npython scripts/hotspot_fetcher.py --start-date 2026-04-01 --end-date 2026-04-02\r\n```\r\n\r\n**日期范围规则**：\r\n\r\n- 日期范围是 **[start_date, end_date)** 左闭右开区间\r\n- 例如：`start-date 2026-04-01 --end-date 2026-04-02` 查询的是4月1日当天的数据\r\n- 例如：`start-date 2026-04-09 --end-date 2026-04-16` 查询的是4月9日至4月15日共7天的数据\r\n\r\n**参数说明**：\r\n\r\n- `--start-date`：开始日期（包含），格式 YYYY-MM-DD\r\n- `--end-date`：结束日期（不包含），格式 YYYY-MM-DD\r\n- `--days`：查询天数，自动计算日期范围（end_date为今天）\r\n- **最长查询范围：30天**\r\n\r\n#### 1.3 智能体判断逻辑\r\n\r\n根据用户意图自动选择查询方式（假设今天日期为T）：\r\n\r\n- \"今日热榜\" / \"最新热榜\" / \"热榜\" → 实时热榜（不传日期参数）\r\n- \"昨日热榜\" / \"昨天热榜\" → `--start-date T-1 --end-date T`\r\n- \"近7天热榜\" / \"一周热榜\" → `--start-date T-7 --end-date T`\r\n- \"近30天热榜\" / \"本月热榜\" → `--start-date T-30 --end-date T`\r\n- \"X月X日热榜\" → `--start-date X月X日 --end-date X月X日的下一天`\r\n\r\n**示例**（假设今天是2026-04-16）：\r\n\r\n| 用户表达     | start_date | end_date   | 查询范围             |\r\n| ------------ | ---------- | ---------- | -------------------- |\r\n| \"昨日热榜\"   | 2026-04-15 | 2026-04-16 | 4月15日当天          |\r\n| \"近7天热榜\"  | 2026-04-09 | 2026-04-16 | 4月9日至4月15日共7天 |\r\n| \"4月1日热榜\" | 2026-04-01 | 2026-04-02 | 4月1日当天           |\r\n\r\n### 2. 展示热榜数据表格\r\n\r\n智能体将脚本返回的JSON数据转换为表格形式展示：\r\n\r\n**标题格式**：\r\n\r\n```\r\n抖音实时热榜（2026-04-14 16:00 每小时更新）\r\n```\r\n\r\n或历史热榜：\r\n\r\n```\r\n抖音历史热榜（2026-04-14 至 2026-04-15）\r\n```\r\n\r\n**表格格式**（默认展示TOP20数据，每条数据必须严格按规则输出）：\r\n\r\n| 排名  | 热度值 | 话题                              | 核心内容                                                                           |\r\n| ----- | ------ | --------------------------------- | ---------------------------------------------------------------------------------- |\r\n| TOP01 | 902.4w | [用万能旅行拍照姿势美美出片](URL) | 旅行博主分享多种万能拍照姿势，帮助女生在旅行中拍出好看的照片，解决拍照不自然的问题 |\r\n| TOP02 | 892.6w | [耗时三年拍下古诗词里的中国](URL) | 摄影师历时三年走遍中国，用镜头还原古诗词中的意境美景，展现传统文化之美             |\r\n| TOP03 | 875.8w | [我拍到了海鸥雨](URL)             | 摄影爱好者在海边偶遇海鸥群飞，拍下壮观的海鸥雨画面，记录大自然的神奇瞬间           |\r\n| TOP04 | 853.2w | [超日常美食教程速来get](URL)      | 美食博主分享简单易学的日常美食制作教程，教大家快速上手做出美味家常菜               |\r\n| TOP05 | 843.7w | [定格这一刻的日照金山](URL)       | 旅行者在日照金山时刻拍下震撼美景，记录下日照金山的壮丽景色和难忘瞬间               |\r\n| TOP06 | 832.1w | [你可以永远相信赛里木湖](URL)     | 旅游达人推荐新疆赛里木湖景点，展示湖泊的绝美风光，被称为大西洋最后一滴眼泪         |\r\n| TOP07 | 818.7w | [拼豆上也可以作画了](URL)         | 手工达人用拼豆创作精美画作，将像素艺术与手工结合，展示创意手工制作过程             |\r\n| TOP08 | 796.4w | [我的家庭旅行更像是打副本](URL)   | 博主分享带家人旅行的有趣经历，将家庭旅行比作游戏打副本，记录旅途中的欢乐时光       |\r\n| TOP09 | 785.4w | [原来古诗词里的河南真的存在](URL) | 文化旅行博主探访河南古诗词中的景点，发现诗中描绘的美景真实存在，感受文化魅力       |\r\n| TOP10 | 771.0w | [蒸出了奶香爆米花馒头](URL)       | 美食创作者创新制作奶香爆米花馒头，分享独特的面食做法，展示创意美食成果             |\r\n| TOP11 | 758.6w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n| TOP12 | 745.2w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n| TOP13 | 732.8w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n| TOP14 | 718.5w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n| TOP15 | 705.3w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n| TOP16 | 692.7w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n| TOP17 | 680.1w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n| TOP18 | 668.9w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n| TOP19 | 655.4w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n| TOP20 | 642.8w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n\r\n**加载更多**：\r\n表格下方显示可点击文案：\r\n\r\n```\r\n抖音实时热榜为你提供TOP50的数据，是否继续加载剩余30条？\r\n```\r\n\r\n- 用户点击确认后，**仅输出TOP21至TOP50的表格**（从TOP21开始，不重复输出TOP1-20）\r\n- 用户拒绝则仅展示TOP20数据\r\n- **用户确认加载更多后，必须生成新的HTML文件，HTML中展示完整的TOP50数据**\r\n\r\n**加载更多表格示例**（用户确认后输出）：\r\n\r\n| 排名  | 热度值 | 话题            | 核心内容                                                       |\r\n| ----- | ------ | --------------- | -------------------------------------------------------------- |\r\n| TOP21 | 632.5w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n| TOP22 | 628.1w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n| ...   | ...    | ...             | ...                                                            |\r\n| TOP49 | 505.3w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n| TOP50 | 498.7w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n\r\n**表格绘制规则（严格执行）**：\r\n\r\n1. **排名**：\r\n   - 默认查询：`TOP01` 到 `TOP20` 格式（双数字符）\r\n   - 加载更多：`TOP21` 到 `TOP50` 格式（从TOP21开始，不重复输出TOP1-20）\r\n2. **热度值**：\r\n   - 格式：保留一位小数，单位统一为 `w`（小写）\r\n   - 示例：`1109.6w`、`923.4w`、`85.2w`\r\n   - HTML页面与表格显示必须完全一致\r\n3. **话题**：使用Markdown链接格式 `[标题](URL)`，用户点击可直接跳转\r\n4. **核心内容**：总结话题里的主要内容信息，主要讲的是什么人/事件/事情，控制字数不低于30字，不超过80字\r\n\r\n### 3. 🔍 创作者洞察报告（核心功能）\r\n\r\n展示完条形图后，**必须自动输出创作者视角的深度洞察**：\r\n\r\n#### 3.1 📌 爆款选题机会\r\n\r\n分析当前热榜内容，回答：\r\n\r\n- **爆款公式拆解**：这些热点背后有什么共同规律？\r\n  - 标题结构是什么？\r\n  - 内容形式是什么？\r\n  - 用户痛点是什么？\r\n- **🔄 可迁移选题**：其他赛道创作者如何蹭这个热点？\r\n\r\n输出格式：\r\n\r\n```\r\n📌 爆款选题机会\r\n\r\n发现：[核心发现]\r\n- 数据支撑：[具体数据]\r\n- 核心公式：[拆解出的公式]\r\n\r\n🔄 可迁移选题：\r\n· 美妆赛道：[具体选题建议]\r\n· 穿搭赛道：[具体选题建议]\r\n· 其他赛道：[具体选题建议]\r\n```\r\n\r\n#### 3.2 ✏️ 标题套路破解\r\n\r\n分析热榜标题，提炼：\r\n\r\n- **爆款标题模式**：统计出现频率最高的标题类型\r\n- **立即可用的标题公式**：给出填空式的标题模板\r\n- **情绪触发词清单**：提取能触发用户行动冲动的高频词汇\r\n\r\n输出格式：\r\n\r\n```\r\n✏️ 标题套路破解\r\n\r\n爆款标题模式TOP3：\r\n1. [类型名称]：[示例]\r\n2. [类型名称]：[示例]\r\n3. [类型名称]：[示例]\r\n\r\n立即可用的标题公式：\r\n· \"用[方法]，[效果]\" → 例：用万能旅行拍照姿势美美出片\r\n· \"耗时[时间]，拍下[成果]\" → 例：耗时三年拍下古诗词里的中国\r\n· \"原来[认知]，真的存在\" → 例：原来古诗词里的河南真的存在\r\n\r\n情绪触发词：\r\n[高频词列表]\r\n```\r\n\r\n#### 3.3 📈 趋势预判与行动建议\r\n\r\n基于当前热榜数据，逐点给出前瞻性判断：\r\n\r\n输出格式：\r\n\r\n```\r\n📈 趋势预判\r\n\r\n一、[预判点1]\r\n   [具体分析内容和依据]\r\n   行动建议：[具体建议]\r\n\r\n二、[预判点2]\r\n   [具体分析内容和依据]\r\n   行动建议：[具体建议]\r\n\r\n三、[预判点3]\r\n   [具体分析内容和依据]\r\n   行动建议：[具体建议]\r\n```\r\n\r\n#### 3.4 分析原则\r\n\r\n- 基于实际数据，不编造\r\n- 给出可执行的行动建议，不泛泛而谈\r\n- 从创作者视角出发，每条洞察都要回答\"怎么用\"\r\n- 保持专业但易懂，避免术语堆砌\r\n\r\n### 4. 🔔 询问订阅（关键步骤）\r\n\r\n分析完成后，**必须主动询问用户**是否需要订阅：\r\n\r\n```\r\n🔔 订阅服务\r\n\r\n是否需要订阅每日/每小时热榜推送？\r\n\r\n1. 每小时推送 - 实时追踪热点变化（默认推送TOP50完整数据）\r\n2. 每日推送 - 每天早/晚获取一次热榜汇总（默认推送TOP50完整数据）\r\n3. 暂不需要 - 仅本次查询\r\n\r\n请回复数字或\"取消\"，如有其他推送时间偏好请说明。\r\n```\r\n\r\n#### 订阅处理流程\r\n\r\n- **用户选择1（每小时推送）**：记录偏好，后续每小时自动推送TOP50数据\r\n- **用户选择2（每日推送）**：询问具体推送时间（早/晚），记录偏好，推送TOP50数据\r\n- **用户选择3或\"取消\"**：结束本次交互，不记录\r\n- **用户有其他偏好**：灵活记录并确认\r\n\r\n**订阅数据输出规则**：\r\n\r\n- 默认推送TOP50完整数据（无需用户确认加载更多）\r\n- 如用户特别要求TOP20，则按用户要求执行\r\n\r\n### 5. 📄 生成热榜HTML页面（必须立即执行）\r\n\r\n**⚠️ 强制规则：HTML文件生成是必须执行的强制步骤，不等待用户回复，立即执行**\r\n\r\n**⚠️ 禁止行为**：\r\n\r\n- ❌ 禁止跳过HTML生成步骤\r\n- ❌ 禁止等待用户回复后再生成HTML\r\n- ❌ 禁止询问用户是否生成HTML\r\n- ❌ 禁止在HTML生成前结束对话\r\n- ❌ 禁止在表格、洞察、订阅询问之前生成HTML\r\n\r\n**执行顺序（严格按序执行，HTML必须是最后一步，立即执行）**：\r\n1️⃣ 获取数据 → 2️⃣ 展示表格 → 3️⃣ 创作者洞察 → 4️⃣ 询问订阅 → **5️⃣ 立即执行HTML生成（不等待用户回复）**\r\n\r\n**触发场景**：\r\n| 场景 | 是否生成HTML | 数据范围 | 文件命名 |\r\n|-----|-------------|---------|---------|\r\n| 查询实时热榜 | ✅ 必须立即生成 | TOP20（严格20条） | `douyin_hot_YYYYMMDD_HHMM.html` |\r\n| 查询历史热榜 | ✅ 必须立即生成 | TOP20（严格20条） | `douyin_hot_YYYYMMDD_YYYYMMDD.html` |\r\n| 用户加载更多 | ✅ 必须立即生成 | TOP50（严格50条） | `douyin_hot_top50_YYYYMMDD_HHMM.html` |\r\n\r\n**⚠️ HTML数据展示规则（最高优先级）**：\r\n\r\n- **默认展示TOP20**：查询实时/历史热榜时，HTML只展示TOP20数据\r\n- **加载更多展示TOP50**：只有用户明确要求加载更多时，HTML才展示TOP50数据\r\n- **数据条数严格控制**：HTML中的数据条数必须与展示条数完全一致\r\n  - TOP20模式：HTML中只能有20条数据，话题总数显示20\r\n  - TOP50模式：HTML中只能有50条数据，话题总数显示50\r\n- **禁止自动扩展**：禁止在用户未要求时自动展示更多数据\r\n\r\n**智能体必须立即执行（不等待用户回复）**：\r\n\r\n```bash\r\n# 实时热榜（默认只生成TOP20）\r\npython scripts/gen_douyin_hot_html.py --output scripts/douyin_hot_20260417_1000.html\r\n\r\n# 历史热榜（默认只生成TOP20）\r\npython scripts/gen_douyin_hot_html.py --start-date 2026-04-15 --end-date 2026-04-16 --output scripts/douyin_hot_20260415_20260416.html\r\n\r\n# 用户加载更多时才生成TOP50（使用--top 50参数）\r\npython scripts/gen_douyin_hot_html.py --top 50 --output scripts/douyin_hot_top50_20260417_1000.html\r\n```\r\n\r\n**⚠️ 文件命名规则**：\r\n\r\n- 实时热榜：`douyin_hot_YYYYMMDD_HHMM.html`（如 `douyin_hot_20260417_1000.html`）\r\n- 历史热榜：`douyin_hot_起始日期_结束日期.html`（如 `douyin_hot_20260415_20260416.html`）\r\n- 加载更多：`douyin_hot_top50_YYYYMMDD_HHMM.html`\r\n\r\n**⚠️ 加载更多场景特殊处理**：\r\n当用户确认加载更多（TOP21-TOP50）时：\r\n\r\n1. **仅输出TOP21-TOP50的表格**（不重复输出TOP01-TOP20）\r\n2. **立即生成新的HTML文件**，使用 `--top 50` 参数\r\n3. HTML中必须包含完整的TOP50数据（TOP01-TOP50）\r\n\r\n**⚠️ HTML文件输出要求（强制执行）**：\r\n\r\n- **必须直接输出HTML文件内容**：生成HTML后，智能体必须在回复中直接输出完整的HTML文件内容\r\n- **输出方式**：使用代码块直接展示HTML源码\r\n  ```html\r\n  <!DOCTYPE html>\r\n  <html lang=\"zh-CN\">\r\n    ...（完整HTML内容）\r\n  </html>\r\n  ```\r\n- **同时告知文件路径**：在HTML内容前后说明文件保存路径\r\n\r\n  ````\r\n  📄 已生成热榜HTML页面：\r\n  文件路径：./scripts/douyin_hot_20260417_1000.html\r\n\r\n  HTML内容：\r\n  ```html\r\n  [完整HTML代码]\r\n  ````\r\n\r\n  可直接用浏览器打开查看，或导出PDF保存。\r\n\r\n  ```\r\n\r\n  ```\r\n\r\n- **禁止遗漏**：无论实时查询还是历史查询，都必须输出完整HTML内容\r\n- **禁止截断**：必须输出完整的HTML文件，不得省略或截断\r\n\r\n**⚠️ PDF文件输出要求（强制执行）**：\r\n\r\n- **必须输出PDF文件**：智能体必须在回复中输出PDF文件\r\n- **PDF生成方式**：\r\n  1. 先生成HTML文件\r\n  2. 使用浏览器工具或其他方式将HTML转换为PDF\r\n  3. 输出PDF文件路径\r\n- **PDF输出格式**：\r\n\r\n  ```\r\n  📄 已生成热榜PDF文件：\r\n  文件路径：./scripts/douyin_hot_20260417_1000.pdf\r\n\r\n  PDF内容支持点击跳转到对应话题页面。\r\n  ```\r\n\r\n- **禁止遗漏**：无论实时查询还是历史查询，都必须输出PDF文件\r\n\r\n**⚠️ 数据一致性要求（严格执行，禁止数据对齐/修改）**：\r\n\r\n- **数据来源唯一**：HTML中的数据必须完全来自脚本执行返回的API数据，禁止使用其他来源\r\n- **禁止数据对齐**：API返回什么数据就输出什么数据，禁止为了\"对齐\"而修改任何字段\r\n- **原始数据输出**：\r\n  - 排名：按API返回的原始顺序，禁止重新排序\r\n  - 热度值：按API返回的原始数值，禁止修改格式或数值\r\n  - 话题标题：按API返回的原始标题，禁止修改或美化\r\n  - 跳转链接：按API返回的原始URL，禁止替换或伪造\r\n- **禁止任何修改**：智能体不得在生成HTML时修改、添加、删除、重排、美化任何数据\r\n- **禁止编造内容**：核心内容摘要必须严格基于话题标题生成，禁止编造不存在的内容\r\n- **一一对应**：HTML中的每一条数据必须与智能体输出的榜单表格完全一致\r\n\r\n**HTML页面统计数据要求**：\r\n\r\n- **话题总数**：必须是HTML页面中实际展示的榜单数据条数（TOP20或TOP50）\r\n- **最高热度**：必须是HTML页面中展示的所有热度值的最大值\r\n- **平均热度**：必须是HTML页面中展示的所有热度值的平均值\r\n- **禁止伪造统计**：统计数据必须根据实际展示的榜单数据计算，禁止编造或使用其他数据\r\n\r\n**HTML页面特性**（紫色极简卡片风格）：\r\n\r\n- **数据一致性**：展示数据与API返回数据完全一致，不做任何修改\r\n- **统计数据准确**：话题总数、最高热度、平均热度必须根据实际榜单数据计算\r\n- **支持TOP20或TOP50数据**：默认TOP20，可通过 `--top 50` 显示完整TOP50\r\n- **保持原生排名顺序**（禁止重新排序）\r\n- **核心内容完整展示**（不使用省略号截断）\r\n- **整行点击跳转**：链接为API返回的真实URL，点击直接跳转到对应话题页面\r\n- **PDF链接跳转**：导出的PDF中每一行都支持点击跳转\r\n  - 使用PDF规范的标准链接注解（Link Annotation）\r\n  - 支持大多数现代PDF阅读器（Adobe Reader、Chrome PDF Viewer、Edge PDF等）\r\n  - 点击任意榜单行即可跳转到对应的抖音话题页面\r\n  - 链接URL与榜单数据完全一致，使用API返回的真实链接\r\n\r\n### 6. 可选操作\r\n\r\n- 用户可以点击标题直接跳转到对应热点页面\r\n- 可根据热度值排序或筛选特定话题\r\n- 可随时发送\"取消订阅\"停止推送\r\n\r\n## 资源索引\r\n\r\n- 数据获取脚本：见 [scripts/hotspot_fetcher.py](../scripts/hotspot_fetcher.py)（获取抖音热榜JSON数据）\r\n- HTML生成脚本：见 [scripts/gen_douyin_hot_html.py](../scripts/gen_douyin_hot_html.py)（生成热榜可视化HTML页面）\r\n- HTML模板文件：见 [assets/douyin_hot_trend_template.html](douyin_hot_trend_template.html)（HTML页面模板，支持快速生成）\r\n\r\n## 模板使用说明\r\n\r\n`douyin_hot_trend_template.html` 是一个独立的HTML模板文件，支持以下占位符快速生成：\r\n\r\n| 占位符              | 说明         | 示例值              |\r\n| ------------------- | ------------ | ------------------- |\r\n| `{{PAGE_TITLE}}`    | 页面标题     | 抖音实时热榜        |\r\n| `{{FETCH_TIME}}`    | 获取时间     | 2026-04-17 10:00:00 |\r\n| `{{HOT_LIST_DATA}}` | 热榜数据JSON | `[{...}, {...}]`    |\r\n\r\n**快速生成方式**：将占位符替换为实际数据即可生成完整HTML页面。\r\n\r\n## 注意事项\r\n\r\n- API调用需要网络连接，请确保网络通畅\r\n- 热榜数据实时更新，每次调用获取最新数据\r\n- 历史热榜最长查询范围为30天\r\n- 如遇API调用失败，提示用户稍后重试\r\n- 订阅偏好需要用户明确确认后记录\r\n- 分析必须基于实际数据，给出可执行的行动建议\n\nFile v1.0.2:skill-card.md\n\n## Description: <br>\nThis skill helps agents fetch Douyin hot-trend rankings, summarize topic patterns, and produce trend reports for content planning. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[if530770](https://clawhub.ai/user/if530770) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal creators, operators, and content teams use this skill to query current or recent Douyin hot lists, review Markdown summaries, and generate HTML/PDF reports for topic selection and trend analysis. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill contacts a third-party service and the security evidence reports disabled TLS certificate verification. <br>\nMitigation: Review the network code before deployment, prefer normal HTTPS verification, and use only trusted network environments. <br>\nRisk: The skill automatically creates HTML/PDF report files from fetched content. <br>\nMitigation: Inspect generated files before sharing or opening them in privileged contexts, and treat fetched links and report contents cautiously. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/if530770/dy-hot-trend) <br>\n- [Publisher profile](https://clawhub.ai/user/if530770) <br>\n- [Douyin hot-list API endpoint used by the skill](https://onetotenvip.com/story/hotSpot/getListByPlatform) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, code, guidance] <br>\n**Output Format:** [Markdown tables and analysis, plus generated HTML and PDF report files.] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Fetches live or recent trend data, supports up to 30 days of history, and may generate TOP20 or TOP50 report files.] <br>\n\n## Skill Version(s): <br>\n1.0.2 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v1.0.2:_skillhub_meta.json\n\n{\n  \"name\": \"douyin-hot-trend\",\n  \"installedAt\": 1777261886760,\n  \"source\": \"import\"\n}\n\nArchive v1.0.1: 6 files, 21930 bytes\n\nFiles: _skillhub_meta.json (86b), assets/core-workflow.md (19867b), scripts/gen_douyin_hot_html.py (28775b), scripts/hotspot_fetcher.py (6090b), SKILL.md (2741b), _meta.json (131b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: douyin-hot-trend\ndescription: >\n  抖音热榜神器 — 可以实时追踪抖音热点、挖掘爆款规律，并支持历史热榜数据回溯。使用时只需输入“查抖音热榜”“抖音热搜”“今日热榜”“近7天热榜”“历史热榜”等触发词，或订阅热榜推送，即可快速获取当前及过往的热门话题，帮助内容创作者和运营者高效蹭热点、找选题。\n---\n\n# 🔥 抖音热榜\n\n## 这是什么\n\n一个帮你搞定抖音热点全流程的小助手。\n\n**能做什么：**\n\n- 📡 实时获取抖音热榜数据，每小时自动更新\n- 📅 查询近7天、近30天历史热榜，回溯热点轨迹\n- 🧠 从创作者视角拆解爆款规律，给出可落地的选题和标题公式\n- 📊 生成紫色极简风 HTML 可视化页面，支持导出 PDF\n- 🔔 可订阅每日/每小时热榜推送，不错过任何一个流量密码\n\n## 什么时候用它\n\n| 场景                   | 举例                           |\n| ---------------------- | ------------------------------ |\n| 想知道今天抖音在火什么 | \"帮我看看抖音热榜\"             |\n| 追踪某个话题的历史热度 | \"查一下这周的热榜变化\"         |\n| 写内容前找选题灵感     | \"最近什么话题最热？\"           |\n| 研究爆款标题的套路     | \"分析下最近热榜标题有什么规律\" |\n| 定期追踪热点做运营     | \"每天早上给我推送热榜\"         |\n\n## 怎么用\n\n```\n查今日抖音热榜\n查近7天热榜\n看看4月1日的热榜\n分析热榜标题规律\n帮我订阅每天早上9点的热榜推送\n```\n\n## 快速开始\n\n> **⚠️ 触发本技能时，必须先读取以下文件获取完整执行流程：**\n>\n> 📄 **[assets/core-workflow.md](assets/core-workflow.md)**\n\n读取方式：用 `read_file` 工具读取 `assets/core-workflow.md`（相对于本技能根目录），然后严格按照其中定义的步骤依次执行。\n\n## 注意事项\n\n- 🌐 需要网络连接，请确保网络通畅\n- ⏰ 历史热榜最长查询30天，超出范围会报错\n- 📌 分析结论全部基于真实数据，不编造，给出的建议都是可执行的\n- 💾 订阅偏好需要你明确回复确认才会记录\n- 📄 HTML 和 PDF 生成是自动执行的，不需要你额外操作\n\n## 资源一览\n\n| 资源                 | 路径                                    |\n| -------------------- | --------------------------------------- |\n| 核心执行流程（必读） | `assets/core-workflow.md`               |\n| 数据获取脚本         | `scripts/hotspot_fetcher.py`            |\n| HTML 生成脚本        | `scripts/gen_douyin_hot_html.py`        |\n| HTML 模板            | `assets/douyin_hot_trend_template.html` |\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n  \"slug\": \"dy-hot-trend\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1777272253898\n}\n\nFile v1.0.1:assets/core-workflow.md\n\n# 抖音热榜 — 核心执行流程\r\n\r\n## 操作步骤\r\n\r\n### 1. 获取热榜数据\r\n\r\n#### 1.1 实时热榜（默认）\r\n\r\n```bash\r\npython scripts/hotspot_fetcher.py\r\n```\r\n\r\n#### 1.2 历史热榜查询\r\n\r\n支持查询近7天、近30天的历史热榜数据：\r\n\r\n```bash\r\n# 查询昨日热榜（假设今天是2026-04-16）\r\npython scripts/hotspot_fetcher.py --start-date 2026-04-15 --end-date 2026-04-16\r\n\r\n# 查询近7天热榜（假设今天是2026-04-16）\r\npython scripts/hotspot_fetcher.py --start-date 2026-04-09 --end-date 2026-04-16\r\n\r\n# 查询近30天热榜（假设今天是2026-04-16）\r\npython scripts/hotspot_fetcher.py --start-date 2026-03-17 --end-date 2026-04-16\r\n\r\n# 查询4月1日热榜\r\npython scripts/hotspot_fetcher.py --start-date 2026-04-01 --end-date 2026-04-02\r\n```\r\n\r\n**日期范围规则**：\r\n\r\n- 日期范围是 **[start_date, end_date)** 左闭右开区间\r\n- 例如：`start-date 2026-04-01 --end-date 2026-04-02` 查询的是4月1日当天的数据\r\n- 例如：`start-date 2026-04-09 --end-date 2026-04-16` 查询的是4月9日至4月15日共7天的数据\r\n\r\n**参数说明**：\r\n\r\n- `--start-date`：开始日期（包含），格式 YYYY-MM-DD\r\n- `--end-date`：结束日期（不包含），格式 YYYY-MM-DD\r\n- `--days`：查询天数，自动计算日期范围（end_date为今天）\r\n- **最长查询范围：30天**\r\n\r\n#### 1.3 智能体判断逻辑\r\n\r\n根据用户意图自动选择查询方式（假设今天日期为T）：\r\n\r\n- \"今日热榜\" / \"最新热榜\" / \"热榜\" → 实时热榜（不传日期参数）\r\n- \"昨日热榜\" / \"昨天热榜\" → `--start-date T-1 --end-date T`\r\n- \"近7天热榜\" / \"一周热榜\" → `--start-date T-7 --end-date T`\r\n- \"近30天热榜\" / \"本月热榜\" → `--start-date T-30 --end-date T`\r\n- \"X月X日热榜\" → `--start-date X月X日 --end-date X月X日的下一天`\r\n\r\n**示例**（假设今天是2026-04-16）：\r\n\r\n| 用户表达     | start_date | end_date   | 查询范围             |\r\n| ------------ | ---------- | ---------- | -------------------- |\r\n| \"昨日热榜\"   | 2026-04-15 | 2026-04-16 | 4月15日当天          |\r\n| \"近7天热榜\"  | 2026-04-09 | 2026-04-16 | 4月9日至4月15日共7天 |\r\n| \"4月1日热榜\" | 2026-04-01 | 2026-04-02 | 4月1日当天           |\r\n\r\n### 2. 展示热榜数据表格\r\n\r\n智能体将脚本返回的JSON数据转换为表格形式展示：\r\n\r\n**标题格式**：\r\n\r\n```\r\n抖音实时热榜（2026-04-14 16:00 每小时更新）\r\n```\r\n\r\n或历史热榜：\r\n\r\n```\r\n抖音历史热榜（2026-04-14 至 2026-04-15）\r\n```\r\n\r\n**表格格式**（默认展示TOP20数据，每条数据必须严格按规则输出）：\r\n\r\n| 排名  | 热度值 | 话题                              | 核心内容                                                                           |\r\n| ----- | ------ | --------------------------------- | ---------------------------------------------------------------------------------- |\r\n| TOP01 | 902.4w | [用万能旅行拍照姿势美美出片](URL) | 旅行博主分享多种万能拍照姿势，帮助女生在旅行中拍出好看的照片，解决拍照不自然的问题 |\r\n| TOP02 | 892.6w | [耗时三年拍下古诗词里的中国](URL) | 摄影师历时三年走遍中国，用镜头还原古诗词中的意境美景，展现传统文化之美             |\r\n| TOP03 | 875.8w | [我拍到了海鸥雨](URL)             | 摄影爱好者在海边偶遇海鸥群飞，拍下壮观的海鸥雨画面，记录大自然的神奇瞬间           |\r\n| TOP04 | 853.2w | [超日常美食教程速来get](URL)      | 美食博主分享简单易学的日常美食制作教程，教大家快速上手做出美味家常菜               |\r\n| TOP05 | 843.7w | [定格这一刻的日照金山](URL)       | 旅行者在日照金山时刻拍下震撼美景，记录下日照金山的壮丽景色和难忘瞬间               |\r\n| TOP06 | 832.1w | [你可以永远相信赛里木湖](URL)     | 旅游达人推荐新疆赛里木湖景点，展示湖泊的绝美风光，被称为大西洋最后一滴眼泪         |\r\n| TOP07 | 818.7w | [拼豆上也可以作画了](URL)         | 手工达人用拼豆创作精美画作，将像素艺术与手工结合，展示创意手工制作过程             |\r\n| TOP08 | 796.4w | [我的家庭旅行更像是打副本](URL)   | 博主分享带家人旅行的有趣经历，将家庭旅行比作游戏打副本，记录旅途中的欢乐时光       |\r\n| TOP09 | 785.4w | [原来古诗词里的河南真的存在](URL) | 文化旅行博主探访河南古诗词中的景点，发现诗中描绘的美景真实存在，感受文化魅力       |\r\n| TOP10 | 771.0w | [蒸出了奶香爆米花馒头](URL)       | 美食创作者创新制作奶香爆米花馒头，分享独特的面食做法，展示创意美食成果             |\r\n| TOP11 | 758.6w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n| TOP12 | 745.2w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n| TOP13 | 732.8w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n| TOP14 | 718.5w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n| TOP15 | 705.3w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n| TOP16 | 692.7w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n| TOP17 | 680.1w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n| TOP18 | 668.9w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n| TOP19 | 655.4w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n| TOP20 | 642.8w | [话题标题](URL)                   | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整                     |\r\n\r\n**加载更多**：\r\n表格下方显示可点击文案：\r\n\r\n```\r\n抖音实时热榜为你提供TOP50的数据，是否继续加载剩余30条？\r\n```\r\n\r\n- 用户点击确认后，**仅输出TOP21至TOP50的表格**（从TOP21开始，不重复输出TOP1-20）\r\n- 用户拒绝则仅展示TOP20数据\r\n- **用户确认加载更多后，必须生成新的HTML文件，HTML中展示完整的TOP50数据**\r\n\r\n**加载更多表格示例**（用户确认后输出）：\r\n\r\n| 排名  | 热度值 | 话题            | 核心内容                                                       |\r\n| ----- | ------ | --------------- | -------------------------------------------------------------- |\r\n| TOP21 | 632.5w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n| TOP22 | 628.1w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n| ...   | ...    | ...             | ...                                                            |\r\n| TOP49 | 505.3w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n| TOP50 | 498.7w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n\r\n**表格绘制规则（严格执行）**：\r\n\r\n1. **排名**：\r\n   - 默认查询：`TOP01` 到 `TOP20` 格式（双数字符）\r\n   - 加载更多：`TOP21` 到 `TOP50` 格式（从TOP21开始，不重复输出TOP1-20）\r\n2. **热度值**：\r\n   - 格式：保留一位小数，单位统一为 `w`（小写）\r\n   - 示例：`1109.6w`、`923.4w`、`85.2w`\r\n   - HTML页面与表格显示必须完全一致\r\n3. **话题**：使用Markdown链接格式 `[标题](URL)`，用户点击可直接跳转\r\n4. **核心内容**：总结话题里的主要内容信息，主要讲的是什么人/事件/事情，控制字数不低于30字，不超过80字\r\n\r\n### 3. 🔍 创作者洞察报告（核心功能）\r\n\r\n展示完条形图后，**必须自动输出创作者视角的深度洞察**：\r\n\r\n#### 3.1 📌 爆款选题机会\r\n\r\n分析当前热榜内容，回答：\r\n\r\n- **爆款公式拆解**：这些热点背后有什么共同规律？\r\n  - 标题结构是什么？\r\n  - 内容形式是什么？\r\n  - 用户痛点是什么？\r\n- **🔄 可迁移选题**：其他赛道创作者如何蹭这个热点？\r\n\r\n输出格式：\r\n\r\n```\r\n📌 爆款选题机会\r\n\r\n发现：[核心发现]\r\n- 数据支撑：[具体数据]\r\n- 核心公式：[拆解出的公式]\r\n\r\n🔄 可迁移选题：\r\n· 美妆赛道：[具体选题建议]\r\n· 穿搭赛道：[具体选题建议]\r\n· 其他赛道：[具体选题建议]\r\n```\r\n\r\n#### 3.2 ✏️ 标题套路破解\r\n\r\n分析热榜标题，提炼：\r\n\r\n- **爆款标题模式**：统计出现频率最高的标题类型\r\n- **立即可用的标题公式**：给出填空式的标题模板\r\n- **情绪触发词清单**：提取能触发用户行动冲动的高频词汇\r\n\r\n输出格式：\r\n\r\n```\r\n✏️ 标题套路破解\r\n\r\n爆款标题模式TOP3：\r\n1. [类型名称]：[示例]\r\n2. [类型名称]：[示例]\r\n3. [类型名称]：[示例]\r\n\r\n立即可用的标题公式：\r\n· \"用[方法]，[效果]\" → 例：用万能旅行拍照姿势美美出片\r\n· \"耗时[时间]，拍下[成果]\" → 例：耗时三年拍下古诗词里的中国\r\n· \"原来[认知]，真的存在\" → 例：原来古诗词里的河南真的存在\r\n\r\n情绪触发词：\r\n[高频词列表]\r\n```\r\n\r\n#### 3.3 📈 趋势预判与行动建议\r\n\r\n基于当前热榜数据，逐点给出前瞻性判断：\r\n\r\n输出格式：\r\n\r\n```\r\n📈 趋势预判\r\n\r\n一、[预判点1]\r\n   [具体分析内容和依据]\r\n   行动建议：[具体建议]\r\n\r\n二、[预判点2]\r\n   [具体分析内容和依据]\r\n   行动建议：[具体建议]\r\n\r\n三、[预判点3]\r\n   [具体分析内容和依据]\r\n   行动建议：[具体建议]\r\n```\r\n\r\n#### 3.4 分析原则\r\n\r\n- 基于实际数据，不编造\r\n- 给出可执行的行动建议，不泛泛而谈\r\n- 从创作者视角出发，每条洞察都要回答\"怎么用\"\r\n- 保持专业但易懂，避免术语堆砌\r\n\r\n### 4. 🔔 询问订阅（关键步骤）\r\n\r\n分析完成后，**必须主动询问用户**是否需要订阅：\r\n\r\n```\r\n🔔 订阅服务\r\n\r\n是否需要订阅每日/每小时热榜推送？\r\n\r\n1. 每小时推送 - 实时追踪热点变化（默认推送TOP50完整数据）\r\n2. 每日推送 - 每天早/晚获取一次热榜汇总（默认推送TOP50完整数据）\r\n3. 暂不需要 - 仅本次查询\r\n\r\n请回复数字或\"取消\"，如有其他推送时间偏好请说明。\r\n```\r\n\r\n#### 订阅处理流程\r\n\r\n- **用户选择1（每小时推送）**：记录偏好，后续每小时自动推送TOP50数据\r\n- **用户选择2（每日推送）**：询问具体推送时间（早/晚），记录偏好，推送TOP50数据\r\n- **用户选择3或\"取消\"**：结束本次交互，不记录\r\n- **用户有其他偏好**：灵活记录并确认\r\n\r\n**订阅数据输出规则**：\r\n\r\n- 默认推送TOP50完整数据（无需用户确认加载更多）\r\n- 如用户特别要求TOP20，则按用户要求执行\r\n\r\n### 5. 📄 生成热榜HTML页面（必须立即执行）\r\n\r\n**⚠️ 强制规则：HTML文件生成是必须执行的强制步骤，不等待用户回复，立即执行**\r\n\r\n**⚠️ 禁止行为**：\r\n\r\n- ❌ 禁止跳过HTML生成步骤\r\n- ❌ 禁止等待用户回复后再生成HTML\r\n- ❌ 禁止询问用户是否生成HTML\r\n- ❌ 禁止在HTML生成前结束对话\r\n- ❌ 禁止在表格、洞察、订阅询问之前生成HTML\r\n\r\n**执行顺序（严格按序执行，HTML必须是最后一步，立即执行）**：\r\n1️⃣ 获取数据 → 2️⃣ 展示表格 → 3️⃣ 创作者洞察 → 4️⃣ 询问订阅 → **5️⃣ 立即执行HTML生成（不等待用户回复）**\r\n\r\n**触发场景**：\r\n| 场景 | 是否生成HTML | 数据范围 | 文件命名 |\r\n|-----|-------------|---------|---------|\r\n| 查询实时热榜 | ✅ 必须立即生成 | TOP20（严格20条） | `douyin_hot_YYYYMMDD_HHMM.html` |\r\n| 查询历史热榜 | ✅ 必须立即生成 | TOP20（严格20条） | `douyin_hot_YYYYMMDD_YYYYMMDD.html` |\r\n| 用户加载更多 | ✅ 必须立即生成 | TOP50（严格50条） | `douyin_hot_top50_YYYYMMDD_HHMM.html` |\r\n\r\n**⚠️ HTML数据展示规则（最高优先级）**：\r\n\r\n- **默认展示TOP20**：查询实时/历史热榜时，HTML只展示TOP20数据\r\n- **加载更多展示TOP50**：只有用户明确要求加载更多时，HTML才展示TOP50数据\r\n- **数据条数严格控制**：HTML中的数据条数必须与展示条数完全一致\r\n  - TOP20模式：HTML中只能有20条数据，话题总数显示20\r\n  - TOP50模式：HTML中只能有50条数据，话题总数显示50\r\n- **禁止自动扩展**：禁止在用户未要求时自动展示更多数据\r\n\r\n**智能体必须立即执行（不等待用户回复）**：\r\n\r\n```bash\r\n# 实时热榜（默认只生成TOP20）\r\npython scripts/gen_douyin_hot_html.py --output scripts/douyin_hot_20260417_1000.html\r\n\r\n# 历史热榜（默认只生成TOP20）\r\npython scripts/gen_douyin_hot_html.py --start-date 2026-04-15 --end-date 2026-04-16 --output scripts/douyin_hot_20260415_20260416.html\r\n\r\n# 用户加载更多时才生成TOP50（使用--top 50参数）\r\npython scripts/gen_douyin_hot_html.py --top 50 --output scripts/douyin_hot_top50_20260417_1000.html\r\n```\r\n\r\n**⚠️ 文件命名规则**：\r\n\r\n- 实时热榜：`douyin_hot_YYYYMMDD_HHMM.html`（如 `douyin_hot_20260417_1000.html`）\r\n- 历史热榜：`douyin_hot_起始日期_结束日期.html`（如 `douyin_hot_20260415_20260416.html`）\r\n- 加载更多：`douyin_hot_top50_YYYYMMDD_HHMM.html`\r\n\r\n**⚠️ 加载更多场景特殊处理**：\r\n当用户确认加载更多（TOP21-TOP50）时：\r\n\r\n1. **仅输出TOP21-TOP50的表格**（不重复输出TOP01-TOP20）\r\n2. **立即生成新的HTML文件**，使用 `--top 50` 参数\r\n3. HTML中必须包含完整的TOP50数据（TOP01-TOP50）\r\n\r\n**⚠️ HTML文件输出要求（强制执行）**：\r\n\r\n- **必须直接输出HTML文件内容**：生成HTML后，智能体必须在回复中直接输出完整的HTML文件内容\r\n- **输出方式**：使用代码块直接展示HTML源码\r\n  ```html\r\n  <!DOCTYPE html>\r\n  <html lang=\"zh-CN\">\r\n    ...（完整HTML内容）\r\n  </html>\r\n  ```\r\n- **同时告知文件路径**：在HTML内容前后说明文件保存路径\r\n\r\n  ````\r\n  📄 已生成热榜HTML页面：\r\n  文件路径：./scripts/douyin_hot_20260417_1000.html\r\n\r\n  HTML内容：\r\n  ```html\r\n  [完整HTML代码]\r\n  ````\r\n\r\n  可直接用浏览器打开查看，或导出PDF保存。\r\n\r\n  ```\r\n\r\n  ```\r\n\r\n- **禁止遗漏**：无论实时查询还是历史查询，都必须输出完整HTML内容\r\n- **禁止截断**：必须输出完整的HTML文件，不得省略或截断\r\n\r\n**⚠️ PDF文件输出要求（强制执行）**：\r\n\r\n- **必须输出PDF文件**：智能体必须在回复中输出PDF文件\r\n- **PDF生成方式**：\r\n  1. 先生成HTML文件\r\n  2. 使用浏览器工具或其他方式将HTML转换为PDF\r\n  3. 输出PDF文件路径\r\n- **PDF输出格式**：\r\n\r\n  ```\r\n  📄 已生成热榜PDF文件：\r\n  文件路径：./scripts/douyin_hot_20260417_1000.pdf\r\n\r\n  PDF内容支持点击跳转到对应话题页面。\r\n  ```\r\n\r\n- **禁止遗漏**：无论实时查询还是历史查询，都必须输出PDF文件\r\n\r\n**⚠️ 数据一致性要求（严格执行，禁止数据对齐/修改）**：\r\n\r\n- **数据来源唯一**：HTML中的数据必须完全来自脚本执行返回的API数据，禁止使用其他来源\r\n- **禁止数据对齐**：API返回什么数据就输出什么数据，禁止为了\"对齐\"而修改任何字段\r\n- **原始数据输出**：\r\n  - 排名：按API返回的原始顺序，禁止重新排序\r\n  - 热度值：按API返回的原始数值，禁止修改格式或数值\r\n  - 话题标题：按API返回的原始标题，禁止修改或美化\r\n  - 跳转链接：按API返回的原始URL，禁止替换或伪造\r\n- **禁止任何修改**：智能体不得在生成HTML时修改、添加、删除、重排、美化任何数据\r\n- **禁止编造内容**：核心内容摘要必须严格基于话题标题生成，禁止编造不存在的内容\r\n- **一一对应**：HTML中的每一条数据必须与智能体输出的榜单表格完全一致\r\n\r\n**HTML页面统计数据要求**：\r\n\r\n- **话题总数**：必须是HTML页面中实际展示的榜单数据条数（TOP20或TOP50）\r\n- **最高热度**：必须是HTML页面中展示的所有热度值的最大值\r\n- **平均热度**：必须是HTML页面中展示的所有热度值的平均值\r\n- **禁止伪造统计**：统计数据必须根据实际展示的榜单数据计算，禁止编造或使用其他数据\r\n\r\n**HTML页面特性**（紫色极简卡片风格）：\r\n\r\n- **数据一致性**：展示数据与API返回数据完全一致，不做任何修改\r\n- **统计数据准确**：话题总数、最高热度、平均热度必须根据实际榜单数据计算\r\n- **支持TOP20或TOP50数据**：默认TOP20，可通过 `--top 50` 显示完整TOP50\r\n- **保持原生排名顺序**（禁止重新排序）\r\n- **核心内容完整展示**（不使用省略号截断）\r\n- **整行点击跳转**：链接为API返回的真实URL，点击直接跳转到对应话题页面\r\n- **PDF链接跳转**：导出的PDF中每一行都支持点击跳转\r\n  - 使用PDF规范的标准链接注解（Link Annotation）\r\n  - 支持大多数现代PDF阅读器（Adobe Reader、Chrome PDF Viewer、Edge PDF等）\r\n  - 点击任意榜单行即可跳转到对应的抖音话题页面\r\n  - 链接URL与榜单数据完全一致，使用API返回的真实链接\r\n\r\n### 6. 可选操作\r\n\r\n- 用户可以点击标题直接跳转到对应热点页面\r\n- 可根据热度值排序或筛选特定话题\r\n- 可随时发送\"取消订阅\"停止推送\r\n\r\n## 资源索引\r\n\r\n- 数据获取脚本：见 [scripts/hotspot_fetcher.py](../scripts/hotspot_fetcher.py)（获取抖音热榜JSON数据）\r\n- HTML生成脚本：见 [scripts/gen_douyin_hot_html.py](../scripts/gen_douyin_hot_html.py)（生成热榜可视化HTML页面）\r\n- HTML模板文件：见 [assets/douyin_hot_trend_template.html](douyin_hot_trend_template.html)（HTML页面模板，支持快速生成）\r\n\r\n## 模板使用说明\r\n\r\n`douyin_hot_trend_template.html` 是一个独立的HTML模板文件，支持以下占位符快速生成：\r\n\r\n| 占位符              | 说明         | 示例值              |\r\n| ------------------- | ------------ | ------------------- |\r\n| `{{PAGE_TITLE}}`    | 页面标题     | 抖音实时热榜        |\r\n| `{{FETCH_TIME}}`    | 获取时间     | 2026-04-17 10:00:00 |\r\n| `{{HOT_LIST_DATA}}` | 热榜数据JSON | `[{...}, {...}]`    |\r\n\r\n**快速生成方式**：将占位符替换为实际数据即可生成完整HTML页面。\r\n\r\n## 注意事项\r\n\r\n- API调用需要网络连接，请确保网络通畅\r\n- 热榜数据实时更新，每次调用获取最新数据\r\n- 历史热榜最长查询范围为30天\r\n- 如遇API调用失败，提示用户稍后重试\r\n- 订阅偏好需要用户明确确认后记录\r\n- 分析必须基于实际数据，给出可执行的行动建议\n\nFile v1.0.1:_skillhub_meta.json\n\n{\n  \"name\": \"douyin-hot-trend\",\n  \"installedAt\": 1777261886760,\n  \"source\": \"import\"\n}\n\nArchive v1.0.0: 6 files, 21804 bytes\n\nFiles: _skillhub_meta.json (86b), assets/core-workflow.md (18676b), scripts/gen_douyin_hot_html.py (28951b), scripts/hotspot_fetcher.py (6069b), SKILL.md (2741b), _meta.json (131b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: douyin-hot-trend\ndescription: >\n  抖音热榜神器 — 可以实时追踪抖音热点、挖掘爆款规律，并支持历史热榜数据回溯。使用时只需输入“查抖音热榜”“抖音热搜”“今日热榜”“近7天热榜”“历史热榜”等触发词，或订阅热榜推送，即可快速获取当前及过往的热门话题，帮助内容创作者和运营者高效蹭热点、找选题。\n---\n\n# 🔥 抖音热榜\n\n## 这是什么\n\n一个帮你搞定抖音热点全流程的小助手。\n\n**能做什么：**\n\n- 📡 实时获取抖音热榜数据，每小时自动更新\n- 📅 查询近7天、近30天历史热榜，回溯热点轨迹\n- 🧠 从创作者视角拆解爆款规律，给出可落地的选题和标题公式\n- 📊 生成紫色极简风 HTML 可视化页面，支持导出 PDF\n- 🔔 可订阅每日/每小时热榜推送，不错过任何一个流量密码\n\n## 什么时候用它\n\n| 场景                   | 举例                           |\n| ---------------------- | ------------------------------ |\n| 想知道今天抖音在火什么 | \"帮我看看抖音热榜\"             |\n| 追踪某个话题的历史热度 | \"查一下这周的热榜变化\"         |\n| 写内容前找选题灵感     | \"最近什么话题最热？\"           |\n| 研究爆款标题的套路     | \"分析下最近热榜标题有什么规律\" |\n| 定期追踪热点做运营     | \"每天早上给我推送热榜\"         |\n\n## 怎么用\n\n```\n查今日抖音热榜\n查近7天热榜\n看看4月1日的热榜\n分析热榜标题规律\n帮我订阅每天早上9点的热榜推送\n```\n\n## 快速开始\n\n> **⚠️ 触发本技能时，必须先读取以下文件获取完整执行流程：**\n>\n> 📄 **[assets/core-workflow.md](assets/core-workflow.md)**\n\n读取方式：用 `read_file` 工具读取 `assets/core-workflow.md`（相对于本技能根目录），然后严格按照其中定义的步骤依次执行。\n\n## 注意事项\n\n- 🌐 需要网络连接，请确保网络通畅\n- ⏰ 历史热榜最长查询30天，超出范围会报错\n- 📌 分析结论全部基于真实数据，不编造，给出的建议都是可执行的\n- 💾 订阅偏好需要你明确回复确认才会记录\n- 📄 HTML 和 PDF 生成是自动执行的，不需要你额外操作\n\n## 资源一览\n\n| 资源                 | 路径                                    |\n| -------------------- | --------------------------------------- |\n| 核心执行流程（必读） | `assets/core-workflow.md`               |\n| 数据获取脚本         | `scripts/hotspot_fetcher.py`            |\n| HTML 生成脚本        | `scripts/gen_douyin_hot_html.py`        |\n| HTML 模板            | `assets/douyin_hot_trend_template.html` |\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n  \"slug\": \"dy-hot-trend\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1777271259574\n}\n\nFile v1.0.0:assets/core-workflow.md\n\n# 抖音热榜 — 核心执行流程\r\n\r\n## 操作步骤\r\n\r\n### 1. 获取热榜数据\r\n\r\n#### 1.1 实时热榜（默认）\r\n```bash\r\npython scripts/hotspot_fetcher.py\r\n```\r\n\r\n#### 1.2 历史热榜查询\r\n支持查询近7天、近30天的历史热榜数据：\r\n\r\n```bash\r\n# 查询昨日热榜（假设今天是2026-04-16）\r\npython scripts/hotspot_fetcher.py --start-date 2026-04-15 --end-date 2026-04-16\r\n\r\n# 查询近7天热榜（假设今天是2026-04-16）\r\npython scripts/hotspot_fetcher.py --start-date 2026-04-09 --end-date 2026-04-16\r\n\r\n# 查询近30天热榜（假设今天是2026-04-16）\r\npython scripts/hotspot_fetcher.py --start-date 2026-03-17 --end-date 2026-04-16\r\n\r\n# 查询4月1日热榜\r\npython scripts/hotspot_fetcher.py --start-date 2026-04-01 --end-date 2026-04-02\r\n```\r\n\r\n**日期范围规则**：\r\n- 日期范围是 **[start_date, end_date)** 左闭右开区间\r\n- 例如：`start-date 2026-04-01 --end-date 2026-04-02` 查询的是4月1日当天的数据\r\n- 例如：`start-date 2026-04-09 --end-date 2026-04-16` 查询的是4月9日至4月15日共7天的数据\r\n\r\n**参数说明**：\r\n- `--start-date`：开始日期（包含），格式 YYYY-MM-DD\r\n- `--end-date`：结束日期（不包含），格式 YYYY-MM-DD\r\n- `--days`：查询天数，自动计算日期范围（end_date为今天）\r\n- **最长查询范围：30天**\r\n\r\n#### 1.3 智能体判断逻辑\r\n根据用户意图自动选择查询方式（假设今天日期为T）：\r\n- \"今日热榜\" / \"最新热榜\" / \"热榜\" → 实时热榜（不传日期参数）\r\n- \"昨日热榜\" / \"昨天热榜\" → `--start-date T-1 --end-date T`\r\n- \"近7天热榜\" / \"一周热榜\" → `--start-date T-7 --end-date T`\r\n- \"近30天热榜\" / \"本月热榜\" → `--start-date T-30 --end-date T`\r\n- \"X月X日热榜\" → `--start-date X月X日 --end-date X月X日的下一天`\r\n\r\n**示例**（假设今天是2026-04-16）：\r\n\r\n| 用户表达 | start_date | end_date | 查询范围 |\r\n|---------|-----------|----------|---------|\r\n| \"昨日热榜\" | 2026-04-15 | 2026-04-16 | 4月15日当天 |\r\n| \"近7天热榜\" | 2026-04-09 | 2026-04-16 | 4月9日至4月15日共7天 |\r\n| \"4月1日热榜\" | 2026-04-01 | 2026-04-02 | 4月1日当天 |\r\n\r\n### 2. 展示热榜数据表格\r\n智能体将脚本返回的JSON数据转换为表格形式展示：\r\n\r\n**标题格式**：\r\n```\r\n抖音实时热榜（2026-04-14 16:00 每小时更新）\r\n```\r\n或历史热榜：\r\n```\r\n抖音历史热榜（2026-04-14 至 2026-04-15）\r\n```\r\n\r\n**表格格式**（默认展示TOP20数据，每条数据必须严格按规则输出）：\r\n\r\n| 排名 | 热度值 | 话题 | 核心内容 |\r\n|-----|-------|------|---------|\r\n| TOP01 | 902.4w | [用万能旅行拍照姿势美美出片](URL) | 旅行博主分享多种万能拍照姿势，帮助女生在旅行中拍出好看的照片，解决拍照不自然的问题 |\r\n| TOP02 | 892.6w | [耗时三年拍下古诗词里的中国](URL) | 摄影师历时三年走遍中国，用镜头还原古诗词中的意境美景，展现传统文化之美 |\r\n| TOP03 | 875.8w | [我拍到了海鸥雨](URL) | 摄影爱好者在海边偶遇海鸥群飞，拍下壮观的海鸥雨画面，记录大自然的神奇瞬间 |\r\n| TOP04 | 853.2w | [超日常美食教程速来get](URL) | 美食博主分享简单易学的日常美食制作教程，教大家快速上手做出美味家常菜 |\r\n| TOP05 | 843.7w | [定格这一刻的日照金山](URL) | 旅行者在日照金山时刻拍下震撼美景，记录下日照金山的壮丽景色和难忘瞬间 |\r\n| TOP06 | 832.1w | [你可以永远相信赛里木湖](URL) | 旅游达人推荐新疆赛里木湖景点，展示湖泊的绝美风光，被称为大西洋最后一滴眼泪 |\r\n| TOP07 | 818.7w | [拼豆上也可以作画了](URL) | 手工达人用拼豆创作精美画作，将像素艺术与手工结合，展示创意手工制作过程 |\r\n| TOP08 | 796.4w | [我的家庭旅行更像是打副本](URL) | 博主分享带家人旅行的有趣经历，将家庭旅行比作游戏打副本，记录旅途中的欢乐时光 |\r\n| TOP09 | 785.4w | [原来古诗词里的河南真的存在](URL) | 文化旅行博主探访河南古诗词中的景点，发现诗中描绘的美景真实存在，感受文化魅力 |\r\n| TOP10 | 771.0w | [蒸出了奶香爆米花馒头](URL) | 美食创作者创新制作奶香爆米花馒头，分享独特的面食做法，展示创意美食成果 |\r\n| TOP11 | 758.6w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n| TOP12 | 745.2w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n| TOP13 | 732.8w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n| TOP14 | 718.5w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n| TOP15 | 705.3w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n| TOP16 | 692.7w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n| TOP17 | 680.1w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n| TOP18 | 668.9w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n| TOP19 | 655.4w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n| TOP20 | 642.8w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n\r\n**加载更多**：\r\n表格下方显示可点击文案：\r\n```\r\n抖音实时热榜为你提供TOP50的数据，是否继续加载剩余30条？\r\n```\r\n- 用户点击确认后，**仅输出TOP21至TOP50的表格**（从TOP21开始，不重复输出TOP1-20）\r\n- 用户拒绝则仅展示TOP20数据\r\n- **用户确认加载更多后，必须生成新的HTML文件，HTML中展示完整的TOP50数据**\r\n\r\n**加载更多表格示例**（用户确认后输出）：\r\n\r\n| 排名 | 热度值 | 话题 | 核心内容 |\r\n|-----|-------|------|---------|\r\n| TOP21 | 632.5w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n| TOP22 | 628.1w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n| ... | ... | ... | ... |\r\n| TOP49 | 505.3w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n| TOP50 | 498.7w | [话题标题](URL) | 话题核心内容摘要，主要讲述什么人做了什么事，内容丰富且信息完整 |\r\n\r\n**表格绘制规则（严格执行）**：\r\n1. **排名**：\r\n   - 默认查询：`TOP01` 到 `TOP20` 格式（双数字符）\r\n   - 加载更多：`TOP21` 到 `TOP50` 格式（从TOP21开始，不重复输出TOP1-20）\r\n2. **热度值**：\r\n   - 格式：保留一位小数，单位统一为 `w`（小写）\r\n   - 示例：`1109.6w`、`923.4w`、`85.2w`\r\n   - HTML页面与表格显示必须完全一致\r\n3. **话题**：使用Markdown链接格式 `[标题](URL)`，用户点击可直接跳转\r\n4. **核心内容**：总结话题里的主要内容信息，主要讲的是什么人/事件/事情，控制字数不低于30字，不超过80字\r\n\r\n### 3. 🔍 创作者洞察报告（核心功能）\r\n展示完条形图后，**必须自动输出创作者视角的深度洞察**：\r\n\r\n#### 3.1 📌 爆款选题机会\r\n分析当前热榜内容，回答：\r\n- **爆款公式拆解**：这些热点背后有什么共同规律？\r\n  - 标题结构是什么？\r\n  - 内容形式是什么？\r\n  - 用户痛点是什么？\r\n- **🔄 可迁移选题**：其他赛道创作者如何蹭这个热点？\r\n\r\n输出格式：\r\n```\r\n📌 爆款选题机会\r\n\r\n发现：[核心发现]\r\n- 数据支撑：[具体数据]\r\n- 核心公式：[拆解出的公式]\r\n\r\n🔄 可迁移选题：\r\n· 美妆赛道：[具体选题建议]\r\n· 穿搭赛道：[具体选题建议]\r\n· 其他赛道：[具体选题建议]\r\n```\r\n\r\n#### 3.2 ✏️ 标题套路破解\r\n分析热榜标题，提炼：\r\n- **爆款标题模式**：统计出现频率最高的标题类型\r\n- **立即可用的标题公式**：给出填空式的标题模板\r\n- **情绪触发词清单**：提取能触发用户行动冲动的高频词汇\r\n\r\n输出格式：\r\n```\r\n✏️ 标题套路破解\r\n\r\n爆款标题模式TOP3：\r\n1. [类型名称]：[示例]\r\n2. [类型名称]：[示例]\r\n3. [类型名称]：[示例]\r\n\r\n立即可用的标题公式：\r\n· \"用[方法]，[效果]\" → 例：用万能旅行拍照姿势美美出片\r\n· \"耗时[时间]，拍下[成果]\" → 例：耗时三年拍下古诗词里的中国\r\n· \"原来[认知]，真的存在\" → 例：原来古诗词里的河南真的存在\r\n\r\n情绪触发词：\r\n[高频词列表]\r\n```\r\n\r\n#### 3.3 📈 趋势预判与行动建议\r\n基于当前热榜数据，逐点给出前瞻性判断：\r\n\r\n输出格式：\r\n```\r\n📈 趋势预判\r\n\r\n一、[预判点1]\r\n   [具体分析内容和依据]\r\n   行动建议：[具体建议]\r\n\r\n二、[预判点2]\r\n   [具体分析内容和依据]\r\n   行动建议：[具体建议]\r\n\r\n三、[预判点3]\r\n   [具体分析内容和依据]\r\n   行动建议：[具体建议]\r\n```\r\n\r\n#### 3.4 分析原则\r\n- 基于实际数据，不编造\r\n- 给出可执行的行动建议，不泛泛而谈\r\n- 从创作者视角出发，每条洞察都要回答\"怎么用\"\r\n- 保持专业但易懂，避免术语堆砌\r\n\r\n### 4. 🔔 询问订阅（关键步骤）\r\n分析完成后，**必须主动询问用户**是否需要订阅：\r\n\r\n```\r\n🔔 订阅服务\r\n\r\n是否需要订阅每日/每小时热榜推送？\r\n\r\n1. 每小时推送 - 实时追踪热点变化（默认推送TOP50完整数据）\r\n2. 每日推送 - 每天早/晚获取一次热榜汇总（默认推送TOP50完整数据）\r\n3. 暂不需要 - 仅本次查询\r\n\r\n请回复数字或\"取消\"，如有其他推送时间偏好请说明。\r\n```\r\n\r\n#### 订阅处理流程\r\n- **用户选择1（每小时推送）**：记录偏好，后续每小时自动推送TOP50数据\r\n- **用户选择2（每日推送）**：询问具体推送时间（早/晚），记录偏好，推送TOP50数据\r\n- **用户选择3或\"取消\"**：结束本次交互，不记录\r\n- **用户有其他偏好**：灵活记录并确认\r\n\r\n**订阅数据输出规则**：\r\n- 默认推送TOP50完整数据（无需用户确认加载更多）\r\n- 如用户特别要求TOP20，则按用户要求执行\r\n\r\n### 5. 📄 生成热榜HTML页面（必须立即执行）\r\n\r\n**⚠️ 强制规则：HTML文件生成是必须执行的强制步骤，不等待用户回复，立即执行**\r\n\r\n**⚠️ 禁止行为**：\r\n- ❌ 禁止跳过HTML生成步骤\r\n- ❌ 禁止等待用户回复后再生成HTML\r\n- ❌ 禁止询问用户是否生成HTML\r\n- ❌ 禁止在HTML生成前结束对话\r\n- ❌ 禁止在表格、洞察、订阅询问之前生成HTML\r\n\r\n**执行顺序（严格按序执行，HTML必须是最后一步，立即执行）**：\r\n1️⃣ 获取数据 → 2️⃣ 展示表格 → 3️⃣ 创作者洞察 → 4️⃣ 询问订阅 → **5️⃣ 立即执行HTML生成（不等待用户回复）**\r\n\r\n**触发场景**：\r\n| 场景 | 是否生成HTML | 数据范围 | 文件命名 |\r\n|-----|-------------|---------|---------|\r\n| 查询实时热榜 | ✅ 必须立即生成 | TOP20（严格20条） | `douyin_hot_YYYYMMDD_HHMM.html` |\r\n| 查询历史热榜 | ✅ 必须立即生成 | TOP20（严格20条） | `douyin_hot_YYYYMMDD_YYYYMMDD.html` |\r\n| 用户加载更多 | ✅ 必须立即生成 | TOP50（严格50条） | `douyin_hot_top50_YYYYMMDD_HHMM.html` |\r\n\r\n**⚠️ HTML数据展示规则（最高优先级）**：\r\n- **默认展示TOP20**：查询实时/历史热榜时，HTML只展示TOP20数据\r\n- **加载更多展示TOP50**：只有用户明确要求加载更多时，HTML才展示TOP50数据\r\n- **数据条数严格控制**：HTML中的数据条数必须与展示条数完全一致\r\n  - TOP20模式：HTML中只能有20条数据，话题总数显示20\r\n  - TOP50模式：HTML中只能有50条数据，话题总数显示50\r\n- **禁止自动扩展**：禁止在用户未要求时自动展示更多数据\r\n\r\n**智能体必须立即执行（不等待用户回复）**：\r\n```bash\r\n# 实时热榜（默认只生成TOP20）\r\npython scripts/gen_douyin_hot_html.py --output scripts/douyin_hot_20260417_1000.html\r\n\r\n# 历史热榜（默认只生成TOP20）\r\npython scripts/gen_douyin_hot_html.py --start-date 2026-04-15 --end-date 2026-04-16 --output scripts/douyin_hot_20260415_20260416.html\r\n\r\n# 用户加载更多时才生成TOP50（使用--top 50参数）\r\npython scripts/gen_douyin_hot_html.py --top 50 --output scripts/douyin_hot_top50_20260417_1000.html\r\n```\r\n\r\n**⚠️ 文件命名规则**：\r\n- 实时热榜：`douyin_hot_YYYYMMDD_HHMM.html`（如 `douyin_hot_20260417_1000.html`）\r\n- 历史热榜：`douyin_hot_起始日期_结束日期.html`（如 `douyin_hot_20260415_20260416.html`）\r\n- 加载更多：`douyin_hot_top50_YYYYMMDD_HHMM.html`\r\n\r\n**⚠️ 加载更多场景特殊处理**：\r\n当用户确认加载更多（TOP21-TOP50）时：\r\n1. **仅输出TOP21-TOP50的表格**（不重复输出TOP01-TOP20）\r\n2. **立即生成新的HTML文件**，使用 `--top 50` 参数\r\n3. HTML中必须包含完整的TOP50数据（TOP01-TOP50）\r\n\r\n**⚠️ HTML文件输出要求（强制执行）**：\r\n- **必须直接输出HTML文件内容**：生成HTML后，智能体必须在回复中直接输出完整的HTML文件内容\r\n- **输出方式**：使用代码块直接展示HTML源码\r\n  ```html\r\n  <!DOCTYPE html>\r\n  <html lang=\"zh-CN\">\r\n  ...（完整HTML内容）\r\n  </html>\r\n  ```\r\n- **同时告知文件路径**：在HTML内容前后说明文件保存路径\r\n  ```\r\n  📄 已生成热榜HTML页面：\r\n  文件路径：./scripts/douyin_hot_20260417_1000.html\r\n  \r\n  HTML内容：\r\n  ```html\r\n  [完整HTML代码]\r\n  ```\r\n  \r\n  可直接用浏览器打开查看，或导出PDF保存。\r\n  ```\r\n- **禁止遗漏**：无论实时查询还是历史查询，都必须输出完整HTML内容\r\n- **禁止截断**：必须输出完整的HTML文件，不得省略或截断\r\n\r\n**⚠️ PDF文件输出要求（强制执行）**：\r\n- **必须输出PDF文件**：智能体必须在回复中输出PDF文件\r\n- **PDF生成方式**：\r\n  1. 先生成HTML文件\r\n  2. 使用浏览器工具或其他方式将HTML转换为PDF\r\n  3. 输出PDF文件路径\r\n- **PDF输出格式**：\r\n  ```\r\n  📄 已生成热榜PDF文件：\r\n  文件路径：./scripts/douyin_hot_20260417_1000.pdf\r\n  \r\n  PDF内容支持点击跳转到对应话题页面。\r\n  ```\r\n- **禁止遗漏**：无论实时查询还是历史查询，都必须输出PDF文件\r\n\r\n**⚠️ 数据一致性要求（严格执行，禁止数据对齐/修改）**：\r\n- **数据来源唯一**：HTML中的数据必须完全来自脚本执行返回的API数据，禁止使用其他来源\r\n- **禁止数据对齐**：API返回什么数据就输出什么数据，禁止为了\"对齐\"而修改任何字段\r\n- **原始数据输出**：\r\n  - 排名：按API返回的原始顺序，禁止重新排序\r\n  - 热度值：按API返回的原始数值，禁止修改格式或数值\r\n  - 话题标题：按API返回的原始标题，禁止修改或美化\r\n  - 跳转链接：按API返回的原始URL，禁止替换或伪造\r\n- **禁止任何修改**：智能体不得在生成HTML时修改、添加、删除、重排、美化任何数据\r\n- **禁止编造内容**：核心内容摘要必须严格基于话题标题生成，禁止编造不存在的内容\r\n- **一一对应**：HTML中的每一条数据必须与智能体输出的榜单表格完全一致\r\n\r\n**HTML页面统计数据要求**：\r\n- **话题总数**：必须是HTML页面中实际展示的榜单数据条数（TOP20或TOP50）\r\n- **最高热度**：必须是HTML页面中展示的所有热度值的最大值\r\n- **平均热度**：必须是HTML页面中展示的所有热度值的平均值\r\n- **禁止伪造统计**：统计数据必须根据实际展示的榜单数据计算，禁止编造或使用其他数据\r\n\r\n**HTML页面特性**（紫色极简卡片风格）：\r\n- **数据一致性**：展示数据与API返回数据完全一致，不做任何修改\r\n- **统计数据准确**：话题总数、最高热度、平均热度必须根据实际榜单数据计算\r\n- **支持TOP20或TOP50数据**：默认TOP20，可通过 `--top 50` 显示完整TOP50\r\n- **保持原生排名顺序**（禁止重新排序）\r\n- **核心内容完整展示**（不使用省略号截断）\r\n- **整行点击跳转**：链接为API返回的真实URL，点击直接跳转到对应话题页面\r\n- **PDF链接跳转**：导出的PDF中每一行都支持点击跳转\r\n  - 使用PDF规范的标准链接注解（Link Annotation）\r\n  - 支持大多数现代PDF阅读器（Adobe Reader、Chrome PDF Viewer、Edge PDF等）\r\n  - 点击任意榜单行即可跳转到对应的抖音话题页面\r\n  - 链接URL与榜单数据完全一致，使用API返回的真实链接\r\n\r\n### 6. 可选操作\r\n- 用户可以点击标题直接跳转到对应热点页面\r\n- 可根据热度值排序或筛选特定话题\r\n- 可随时发送\"取消订阅\"停止推送\r\n\r\n## 资源索引\r\n- 数据获取脚本：见 [scripts/hotspot_fetcher.py](../scripts/hotspot_fetcher.py)（获取抖音热榜JSON数据）\r\n- HTML生成脚本：见 [scripts/gen_douyin_hot_html.py](../scripts/gen_douyin_hot_html.py)（生成热榜可视化HTML页面）\r\n- HTML模板文件：见 [assets/douyin_hot_trend_template.html](douyin_hot_trend_template.html)（HTML页面模板，支持快速生成）\r\n\r\n## 模板使用说明\r\n`douyin_hot_trend_template.html` 是一个独立的HTML模板文件，支持以下占位符快速生成：\r\n\r\n| 占位符 | 说明 | 示例值 |\r\n|-------|------|-------|\r\n| `{{PAGE_TITLE}}` | 页面标题 | 抖音实时热榜 |\r\n| `{{FETCH_TIME}}` | 获取时间 | 2026-04-17 10:00:00 |\r\n| `{{HOT_LIST_DATA}}` | 热榜数据JSON | `[{...}, {...}]` |\r\n\r\n**快速生成方式**：将占位符替换为实际数据即可生成完整HTML页面。\r\n\r\n## 注意事项\r\n- API调用需要网络连接，请确保网络通畅\r\n- 热榜数据实时更新，每次调用获取最新数据\r\n- 历史热榜最长查询范围为30天\r\n- 如遇API调用失败，提示用户稍后重试\r\n- 订阅偏好需要用户明确确认后记录\r\n- 分析必须基于实际数据，给出可执行的行动建议\n\nFile v1.0.0:_skillhub_meta.json\n\n{\n  \"name\": \"douyin-hot-trend\",\n  \"installedAt\": 1777261886760,\n  \"source\": \"import\"\n}","readmeExcerpt":"Skill: 抖音实时热点榜 Owner: if530770 Summary: 专注于获取抖音最新的热榜数据，每小时更新，包含热点事件、热度值和跳转链接；支持查询近7天、近30天历史热榜，并支持订阅定时推送。 Tags: latest:1.0.3 Version history: v1.0.3 | 2026-06-05T03:41:32.871Z | user douyin-hot-trend 1.0.3 版本主要优化文档结构与资源指向，提升可用性与集成便捷性： - 更新并扩展 SKILL.md，优化指令说明、场景用法及常见问答，增强用户引导。 - 新增英文与中文 README 文件，标准化多语言文档支持。 - 新增 references/core_workflow.md，替换原 assets/core-workflow.md，规范 Agent 执行流程入口。 - 移除冗余文件（如_skillhub_meta.json、skil","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"查今日抖音热榜\n查近7天热榜\n看看4月1日的热榜\n分析热榜标题规律\n帮我订阅每天早上9点的热榜推送"},{"language":"text","snippet":"查今日抖音热榜\n查近7天热榜\n看看4月1日的热榜\n分析热榜标题规律\n帮我订阅每天早上9点的热榜推送"},{"language":"text","snippet":"查今日抖音热榜\n查近7天热榜\n看看4月1日的热榜\n分析热榜标题规律\n帮我订阅每天早上9点的热榜推送"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\r\nname: douyin-hot-trend\r\ndescription: 专注于获取抖音最新的热榜数据，每小时更新，包含热点事件、热度值和跳转链接；支持查询近7天、近30天历史热榜，并支持订阅定时推送。\r\n---\r\n\r\n# 抖音热榜\r\n\r\n## 简介\r\n\r\n抖音热榜是一款实时追踪抖音平台热点趋势的数据工具，对接 [红狐Hub](https://redfox.hk/) 数据 API，每小时更新热榜内容，并提供创作者视角的深度分析。\r\n\r\n通过简单的自然语言指令，你可以：\r\n\r\n- 📊 **实时热榜查询**：每 60 分钟抓取抖音 TOP 50 榜单，同步热度值与跳转链接\r\n- 📅 **历史热榜回溯**：覆盖近 7 天、近 30 天历史数据，支持按日期与关键词检索\r\n- 🔀 **热榜数据对比**：对比任意两个时间点（如昨天 vs 今天）的热榜变化\r\n- 💡 **深度洞察分析**：从创作者视角提供选题机会、标题套路与趋势预判\r\n- 🔔 **个性化订阅**：支持每小时或每日定时推送热榜数据\r\n\r\n适用于内容创作者、短视频运营、MCN 机构、品牌营销人员等需要追踪抖音热点、寻找创作灵感、制定内容策略的场景。\r\n\r\n**技术基础**：Python 3.x + `requests` 库，通过 红狐Hub APIKey获取数据。\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 🎯 核心功能\r\n\r\n- **📊 实时热榜**：获取抖音当前 TOP 50 热榜，每小时刷新，展示排名、热度值、话题标题和跳转链接\r\n- **📅 历史回溯**：支持查询近 7 天或近 30 天历史热榜，最长覆盖 30 天\r\n- **💡 创作者洞察**：自动生成选题机会分析、标题套路拆解、趋势预判与行动建议\r\n- **📄 可视化报告**：一键生成紫色极简风格 HTML 页面，支持导出 PDF，每条记录可点击跳转\r\n- **🔔 订阅推送**：支持每小时或每日定时推送，自动追踪热点变化\r\n\r\n### ✨ 特色亮点\r\n\r\n- **⚡ 自然语言交互**：输入「今日热榜」「近7天热榜」等即可查询，无需记忆命令参数\r\n- **🔒 三级鉴权回退**：API Key 优先从环境变量读取，自动回退到 Shell 配置文件\r\n- **✅ 数据一致性**：表格、洞察、HTML、PDF 全链路数据一致，不做加工或美化\r\n- **🎬 创作者视角**：每条洞察都回答「怎么用」，给出可执行的行动建议\r\n\r\n---\r\n\r\n## 一键安装\r\n\r\n### 前置条件\r\n\r\n- 已安装 Python 3.x 及 `requests` 库\r\n- 已注册 [红狐Hub官网](https://redfox.hk/login) 账号并获取 API Key（格式 `ak_xxxxxxxx`）\r\n- 新注册用户将获赠免费积分，可立即开始使用\r\n\r\n### 安装方式\r\n\r\n#### 方式一：WorkBuddy（龙虾）技能安装（推荐）\r\n\r\n1. 将 `douyin-hot-trend` 技能文件夹复制到 WorkBuddy 的 skills 目录下\r\n2. 在 WorkBuddy 对话中直接说「抖音热榜」或「今日热榜」，Agent 将自动加载本技能\r\n3. 配置 API Key（见下方「环境变量配置」）\r\n4. 安装 Python 依赖：\r\n\r\n```bash\r\npip install requests\r\n```\r\n\r\n#### 方式二：Cursor / 其他 Agent 环境手动安装\r\n\r\n1. 将技能文件夹放置到对应环境的 skills 目录\r\n2. 确保 Agent 可读取 `SKILL.md` 与 `references/core_workflow.md`\r\n3. 配置 `REDFOX_API_KEY` 环境变量\r\n4. 执行 `pip install requests`\r\n\r\n### 环境变量配置\r\n\r\n| 变量名 | 必填 | 说明 |\r\n|------|------|------|\r\n| `REDFOX_API_KEY` | 是 | 红狐Hub API 访问密钥，格式 `ak_xxxxxxxx` |\r\n\r\n**配置方式**（任选其一）：\r\n\r\n```bash\r\n# 方式一：直接设置环境变量（推荐）\r\nexport REDFOX_API_KEY=ak_xxxxxxxx\r\n\r\n# 方式二：写入 Shell 配置文件（~/.bashrc / ~/.bash_profile / ~/.zshrc）\r\necho 'export REDFOX_API_KEY=ak_xxxxxxxx' >> ~/.bashrc\r\nsource ~/.bashrc\r\n```\r\n\r\n若未配置环境变量，技能将自动从 Shell 配置文件读取；若仍未获取到，会在运行时提示配置。\r\n\r\n**在 WorkBuddy 中配置 Key**：可在系统环境变量中设置 `REDFOX_API_KEY`，或在 Shell 配置文件中写入后重启 WorkBuddy，无需在每次对话中手动传入。\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n### 基础使用\r\n\r\n#### 1. 查看实时热榜\r\n\r\n告诉助手你想查看当前抖音热点：\r\n\r\n> **用户**：抖音热榜\r\n> **助手**：为您展示抖音实时热榜 TOP 20（含排名、热度值、话题链接），并附创作者洞察报告。\r\n\r\n#### 2. 查看历史热榜\r\n\r\n查询指定时间范围的历史数据：\r\n\r\n> **用户**：近7天热榜\r\n> **助手**：为您展示近 7 天抖音历史热榜，支持按日期回溯热点演变。\r\n\r\n> **用户**：4月15日热榜\r\n> **助手**：为您查询 4 月 15 日当天的热榜数据。\r\n\r\n#### 3. 加载完整榜单\r\n\r\n默认展示 TOP 20，可继续加载至 TOP 50：\r\n\r\n> **用户**：继续加载\r\n> **助手**：为您展示 TOP 21–50，并生成包含完整 TOP 50 的 HTML 报告。\r\n\r\n### 高级使用\r\n\r\n#### 1. 创作者洞察\r\n\r\n热榜展示后自动输出深度分析：\r\n\r\n> **用户**：今日热榜\r\n> **助手**：（展示表格后）输出爆款选题机会、标题套路破解、趋势预判与行动建议。\r\n\r\n#### 2. 热榜对比\r\n\r\n对比两个时间点的热榜变化：\r\n\r\n> **用户**：对比昨天和今天的热榜\r\n> **助手**：为您对比两日热榜排名与热度变化，标注新进榜与掉榜话题。\r\n\r\n#### 3. 订阅推送\r\n\r\n设置定时自动推送：\r\n\r\n> **用户**：订阅每日热榜推送\r\n> **助手**：已设置每日推送，将在指定时间自动推送 TOP 50 完整热榜数据。\r\n\r\n> **用户**：取消订阅\r\n> **助手**：已取消定时推送。\r\n\r\n#### 4. 生成报告\r\n\r\n每次查询自动生成可视化报告：\r\n\r\n> **用户**：今日热榜\r\n> **助手**：（查询完成后）已生成 HTML 页面与 PDF 文件，数据与表格展示完全一致，支持点击跳转。\r\n\r\n### 常用指令速查\r\n\r\n| 指令 | 功能 |"},{"path":"README.md","content":"# 抖音热榜神器 / douyin-hot-trend\r\n\r\n---\r\n\r\n## 简介\r\n\r\n实时追踪抖音热点、挖掘爆款规律，帮助内容创作者和运营者高效蹭热点、找选题的智能热榜工具。\r\n\r\n**核心价值**\r\n\r\n- 每小时自动更新抖音 TOP 50 榜单，热度值与跳转链接一键可见\r\n- 覆盖近 7 天、近 30 天历史热榜，随时回溯过往热点演变\r\n- 从创作者视角自动生成选题机会、标题套路与趋势预判\r\n- 支持任意两个时间点热榜对比，清晰标注新进榜与掉榜话题\r\n- 支持每小时或每日定时推送，无需手动触发\r\n\r\n**适用对象**\r\n\r\n- 🎬 **短视频创作者** — 每天快速锁定热点方向，缩短选题时间\r\n- 📣 **MCN 机构运营** — 统一监控平台趋势，高效指导达人内容策略\r\n- 🏷️ **品牌营销人员** — 发现可借势话题，提升热点响应速度\r\n- 📚 **运营新手** — 学习爆款标题套路，快速建立内容感知\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 核心功能\r\n\r\n- **实时热榜查询**：获取抖音当前 TOP 50 热榜，包含排名、热度值、话题标题和跳转链接，每 60 分钟刷新\r\n- **历史热榜回溯**：支持查询近 7 天或近 30 天历史数据，可按日期指定查看特定某天\r\n- **热榜对比**：对比任意两个时间点的热榜排名与热度变化，自动标注新进榜与掉榜话题\r\n- **创作者洞察报告**：热榜展示后自动输出爆款选题机会、标题套路拆解、趋势预判与行动建议\r\n- **可视化报告导出**：一键生成紫色极简风格 HTML 页面，支持导出 PDF，每条话题可点击跳转\r\n- **定时订阅推送**：支持每小时或每日定时推送，自动追踪热点变化\r\n\r\n---\r\n\r\n## 密钥获取与安全说明\r\n\r\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\r\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`)提供。\r\n- 请前往 [红狐 hub](https://redfox.hk?source=github) 注册账号，获取 `REDFOX_API_KEY`。\r\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\r\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\r\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n直接用自然语言描述需求，无需记忆命令。\r\n\r\n### 常用说法速查\r\n\r\n| 意图         | 示例话术               | 效果                                                  |\r\n| ------------ | ---------------------- | ----------------------------------------------------- |\r\n| 查看实时热榜 | 抖音热榜 / 今日热榜    | 展示当前 TOP 20，含热度值与话题链接，附创作者洞察报告 |\r\n| 查看昨日热榜 | 昨日热榜               | 查询昨天全天热榜数据                                  |\r\n| 查看历史热榜 | 近7天热榜 / 近30天热榜 | 按时间范围回溯历史热点                                |\r\n| 查看指定日期 | 5月15日热榜            | 查询特定日期的榜单数据                                |\r\n| 加载完整榜单 | 继续加载 / 加载更多    | 从 TOP 20 扩展至完整 TOP 50                           |\r\n| 对比热榜变化 | 对比昨天和今天的热榜   | 输出两日热榜差异，标注新进榜与掉榜话题                |\r\n| 订阅推送     | 订阅每日热榜推送       | 设置定时自动推送，每日获取最新热榜                    |\r\n| 取消订阅     | 取消订阅               | 停止定时推送                                          |\r\n\r\n### 输出示例\r\n\r\n查询「今日热榜」后，你将收到：\r\n\r\n1. **热榜表格**：序号、话题标题、热度值、跳转链接（TOP 20，可继续加载至 50）\r\n2. **创作者洞察报告**：\r\n   - 🔥 爆款选题机会（可迁移话题与创作方向）\r\n   - 🎯 标题套路拆解（情绪词、句式结构）\r\n   - 📈 趋势预判（哪些话题正在上升/下降）\r\n   - 💡 行动建议（可执行的内容策略）\r\n3. **可视化报告**：自动生成 HTML 页面，支持导出 PDF\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n| 场景         | 角色         | 示例问法                       | 收益                                         |\r\n| ------------ | ------------ | ------------------------------ | -------------------------------------------- |\r\n| 每日选题灵感 | 短视频创作者 | 「今日热榜」                   | 快速锁定热点方向，获取可迁移选题与标题公式   |\r\n| 热点趋势监控 | MCN 运营人员 | 「近7天热榜」                  | 掌握一周热点演变规律，为达人提供内容策略参考 |\r\n| 热点借势营销 | 品牌营销经理 | 「对比本周热榜变化」           | 发现持续发酵话题，提前布局品牌借势内容       |\r\n| 运营学习研究 | 短视频新手   | 「今日热榜，帮我分析标题套路」 | 学习爆款句式结构，快速建立内容感知           |\r\n\r\n---"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7bbcfey44zzvtyay8yqzq0r584h3zz\",\n  \"slug\": \"dy-hot-trend\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1780630892871\n}"},{"path":"references/core_workflow.md","content":"# 核心工作流（Agent 执行参考）\r\n\r\n本文档为 Agent 执行层的详细工作流指令，包含数据获取、展示、分析、订阅、HTML 生成等完整步骤。\r\n\r\n## 任务目标\r\n\r\n- 获取抖音平台热榜数据，并提供创作者视角的深度洞察\r\n- 触发条件：用户询问抖音热榜、热门话题、热搜榜单、历史热榜、订阅热榜推送等\r\n\r\n## 操作步骤\r\n\r\n### 1. 获取热榜数据\r\n\r\n**Python 执行说明**：\r\n\r\n- 优先使用系统默认 `python` 命令\r\n- 若 `python` 不可用（Windows Git Bash 常见），使用 WorkBuddy 管理的 Python 全路径：`\"C:/Users/马祯/.workbuddy/binaries/python/versions/3.13.12/python.exe\"`\r\n- 始终先 `cd` 到技能根目录再执行\r\n\r\n#### 1.1 实时热榜（默认）\r\n\r\n```bash\r\ncd \"C:/Users/马祯/.workbuddy/skills/douyin-hot-trend\" && python scripts/hotspot_fetcher.py\r\n```\r\n\r\n#### 1.2 历史热榜查询\r\n\r\n支持查询近7天、近30天的历史热榜数据：\r\n\r\n```bash\r\n# 查询昨日热榜（假设今天是2026-04-16）\r\ncd \"C:/Users/马祯/.workbuddy/skills/douyin-hot-trend\" && python scripts/hotspot_fetcher.py --start-date 2026-04-15 --end-date 2026-04-16\r\n\r\n# 查询近7天热榜（假设今天是2026-04-16）\r\ncd \"C:/Users/马祯/.workbuddy/skills/douyin-hot-trend\" && python scripts/hotspot_fetcher.py --start-date 2026-04-09 --end-date 2026-04-16\r\n\r\n# 查询近30天热榜（假设今天是2026-04-16）\r\ncd \"C:/Users/马祯/.workbuddy/skills/douyin-hot-trend\" && python scripts/hotspot_fetcher.py --start-date 2026-03-17 --end-date 2026-04-16\r\n\r\n# 查询4月1日热榜\r\ncd \"C:/Users/马祯/.workbuddy/skills/douyin-hot-trend\" && python scripts/hotspot_fetcher.py --start-date 2026-04-01 --end-date 2026-04-02\r\n```\r\n\r\n**日期范围规则**：\r\n- 日期范围是 **[start_date, end_date)** 左闭右开区间\r\n- 例如：`start-date 2026-04-01 --end-date 2026-04-02` 查询的是4月1日当天的数据\r\n- 例如：`start-date 2026-04-09 --end-date 2026-04-16` 查询的是4月9日至4月15日共7天的数据\r\n\r\n**参数说明**：\r\n- `--start-date`：开始日期（包含），格式 YYYY-MM-DD\r\n- `--end-date`：结束日期（不包含），格式 YYYY-MM-DD\r\n- `--days`：查询天数，自动计算日期范围（end_date为今天）\r\n- **最长查询范围：30天**\r\n\r\n#### 1.3 意图判断逻辑\r\n\r\n根据用户意图自动选择查询方式（假设今天日期为T）：\r\n\r\n| 用户表达 | start_date | end_date | 查询范围 |\r\n|---------|-----------|----------|---------|\r\n| \"今日热榜\" / \"最新热榜\" / \"热榜\" | 无（实时） | 无（实时） | 实时 |\r\n| \"昨日热榜\" / \"昨天热榜\" | T-1 | T | 昨日当天 |\r\n| \"近7天热榜\" / \"一周热榜\" | T-7 | T | 近7天 |\r\n| \"近30天热榜\" / \"本月热榜\" | T-30 | T | 近30天 |\r\n| \"X月X日热榜\" | X月X日 | X月X日+1 | 指定日期当天 |\r\n\r\n### 2. 展示热榜数据表格\r\n\r\n将脚本返回的JSON数据转换为表格形式展示。\r\n\r\n**标题格式**：\r\n\r\n实时热榜：`抖音实时热榜（2026-04-14 16:00 每小时更新）`\r\n\r\n历史热榜：`抖音历史热榜（2026-04-14 至 2026-04-15）`\r\n\r\n**表格格式**（默认展示TOP20数据）：\r\n\r\n| 排名 | 热度值 | 话题 | 核心内容 |\r\n|-----|-------|------|---------|\r\n\r\n**表格绘制规则**：\r\n1. 排名：默认 `TOP01` 到 `TOP20`（双数字符）；加载更多 `TOP21` 到 `TOP50`\r\n2. 热度值：保留一位小数，单位统一为 `w`（小写），示例 `1109.6w`\r\n3. 话题：使用 Markdown 链接格式 `[标题](URL)`\r\n4. 核心内容：30-80字，概括话题主要内容\r\n\r\n**加载更多**：\r\n\r\n表格下方展示：\r\n> 抖音实时热榜为你提供TOP50的数据，是否继续加载剩余30条？\r\n\r\n- 确认后仅输出 TOP21-TOP50，不重复 TOP1-20\r\n- 确认后必须生成新的 HTML 文件，包含完整 TOP50 数据\r\n\r\n### 3. 创作者洞察报告\r\n\r\n展示数据后自动输出创作者视角的深度洞察：\r\n\r\n#### 3.1 爆款选题机会\r\n\r\n分析热榜内容的共同规律，提供可迁移的选题建议。\r\n\r\n输出格式：\r\n\r\n```\r\n📌 爆款选题机会\r\n\r\n发现：[核心发现]\r\n- 数据支撑：[具体数据]\r\n- 核心公式：[拆解出的公式]\r\n\r\n🔄 可迁移选题：\r\n· 美妆赛道：[具体选题建议]\r\n· 穿搭赛道：[具体选题建议]\r\n· 其他赛道：[具体选题建议]\r\n```\r\n\r\n#### 3.2 标题套路破解\r\n\r\n提炼爆款标题模式和情绪触发词。\r\n\r\n输出格式：\r\n\r\n```\r\n✏️ 标题套路破解\r\n\r\n爆款标题模式TOP3：\r\n1. [类型名称]：[示例]\r\n2. [类型名称]：[示例]\r\n3. [类型名称]：[示例]\r\n\r\n立即可用的标题公式：\r\n· \"用[方法]，[效果]\" → 例：用万能旅行拍照姿势美美出片\r\n· \"耗时[时间]，拍下[成果]\" → 例：耗时三年拍下古诗词里的中国\r\n· \"原来[认知]，真的存在\" → 例：原来古诗词里的河南真的存在\r\n\r\n情绪触发词：\r\n[高频词列表]\r\n```\r\n\r\n#### 3.3 趋势预判与行动建议\r\n\r\n基于热榜数据给出前瞻性判断。\r\n\r\n输出格式：\r\n\r\n"},{"path":"README.en.md","content":"# Douyin Hot Trend Tracker / douyin-hot-trend\r\n\r\n---\r\n\r\n## Introduction\r\n\r\nA smart hot trend tool that tracks Douyin trending topics in real time, uncovers viral content patterns, and helps creators and operators catch hot topics and find content ideas efficiently.\r\n\r\n**Core Value**\r\n\r\n- Automatically updates the Douyin TOP 50 chart every hour, with heat scores and direct links at a glance\r\n- Covers up to 30 days of historical charts so you can trace past trend shifts anytime\r\n- Automatically generates topic opportunity analysis, title pattern breakdowns, and trend forecasts from a creator's perspective\r\n- Supports side-by-side comparison of any two time points, clearly marking newly-entered and dropped topics\r\n- Supports hourly or daily scheduled delivery — no manual triggering needed\r\n\r\n**Who It's For**\r\n\r\n- 🎬 **Short-video Creators** — Quickly lock in daily hot topics and shorten your ideation time\r\n- 📣 **MCN Operations Teams** — Monitor platform trends centrally and guide creator content strategies efficiently\r\n- 🏷️ **Brand Marketing Managers** — Identify leverage-worthy topics and respond to hot trends faster\r\n- 📚 **Operations Beginners** — Learn viral title patterns and quickly build content intuition\r\n\r\n---\r\n\r\n## Features\r\n\r\n### Core Functions\r\n\r\n- **Real-Time Chart Query**: Fetch the current Douyin TOP 50 trending topics with rankings, heat scores, titles, and clickable links — refreshed every 60 minutes\r\n- **Historical Chart Lookup**: Query up to the past 7 days or 30 days of trending data, with support for specifying an exact date\r\n- **Chart Comparison**: Compare rankings and heat score changes between any two time points, with new entrants and dropped topics automatically flagged\r\n- **Creator Insights Report**: After displaying the chart, automatically outputs viral topic opportunities, title pattern analysis, trend forecasts, and actionable recommendations\r\n- **Visual Report Export**: One-click generation of a minimal-purple-style HTML page with PDF export support and clickable links for every topic\r\n- **Scheduled Subscription Push**: Set up hourly or daily automated delivery to stay on top of trending topics without manual effort\r\n\r\n---\r\n\r\n## API Key Acquisition & Security\r\n\r\n- This skill requires the environment variable: `REDFOX_API_KEY`.\r\n- `REDFOX_API_KEY` is provided by [RedFoxHub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`).\r\n- Register an account at [RedFoxHub](https://redfox.hk?source=github) to obtain your `REDFOX_API_KEY`.\r\n- Configure the device environment variable `REDFOX_API_KEY` before using this skill.\r\n- Before providing a key, confirm its source, scope, expiration, and whether it supports reset/revocation.\r\n- Never hardcode or expose the key in plaintext in code, prompts, logs, or output files.\r\n\r\n---\r\n\r\n## Usage Guide\r\n\r\nJust describe your need in plain language — no commands to memorize.\r\n\r\n### Quick Reference\r\n\r\n| Intent                  | Example Phrase                          "}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"专注于获取抖音最新的热榜数据，每小时更新，包含热点事件、热度值和跳转链接；支持查询近7天、近30天历史热榜，并支持订阅定时推送。 Skill: 抖音实时热点榜 Owner: if530770 Summary: 专注于获取抖音最新的热榜数据，每小时更新，包含热点事件、热度值和跳转链接；支持查询近7天、近30天历史热榜，并支持订阅定时推送。 Tags: latest:1.0.3 Version history: v1.0.3 | 2026-06-05T03:41:32.871Z | user douyin-hot-trend 1.0.3 版本主要优化文档结构与资源指向，提升可用性与集成便捷性： - 更新并扩展 SKILL.md，优化指令说明、场景用法及常见问答，增强用户引导。 - 新增英文与中文 README 文件，标准化多语言文档支持。 - 新增 references/core_workflow.md，替换原 assets/core-workflow.md，规范 Agent 执行流程入口。 - 移除冗余文件（如_skillhub_meta.json、skil","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1075,"uniquenessScore":53,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-12T02:38:50.680Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-12T02:38:50.680Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-14T02:51:00.505Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}