| name | trending-hub |
| description | 帮你把抖音、微博、B站、快手、知乎、头条、百度等7个平台的热搜聚合在一起，省得一个个平台去看。想知道今天全网都在聊什么、哪个热点值得追、趋势怎么走，问我准没错。查热榜、导报告、订阅推送都行 |
| dependency | {"python":["无第三方依赖（使用标准库 urllib.request）"]} |
全网热点追踪
1. 简介
一句话定位：全网热点聚合追踪工具，实时抓取抖音、微博、B站、快手、知乎、头条、百度等7大平台热搜数据，一站式查看全网热点。
核心价值：解决内容创作者、市场运营者在热点追踪中的三大痛点：
- 热点分散难整合：无需逐个平台查看，一次聚合7大平台热榜
- 跨平台对比困难：自动识别同一事件在不同平台的讨论差异和热度表现
- 趋势判断模糊：基于热度值、上榜时长、平台覆盖等维度智能预测热点走势
适用对象：内容创作者、市场运营人员、媒体编辑、品牌策划、热点追踪爱好者。
不支持：该技能不支持查询特定热词详情，仅提供全网热点榜聚合查询。
2. 功能特性
核心功能
| 功能模块 | 能力描述 | 核心价值 |
|---|
| 🔍 全网热榜聚合 | 实时抓取7大平台热搜数据 | 一键获取全网热点，告别逐平台查看 |
| 🔗 跨平台事件识别 | 智能识别同一事件在不同平台的表述 | 自动归并相似话题，避免重复统计 |
| 📊 热度趋势预测 | 基于热度值、时长、平台覆盖预测走势 | 提前判断热点生命周期，把握创作窗口 |
| 📈 TOP10榜单提供 | 按综合热度排序输出TOP10热点 | 快速定位高价值选题 |
| 💬 跨平台讨论分析 | 展示不同平台的讨论焦点和差异 | 深度洞察舆论生态，精准定位受众 |
| ⏰ 订阅推送服务 | 定时推送最新热榜/昨日热榜 | 持续追踪热点动态，不错过关键机会 |
特色亮点
- 小时级更新：数据每小时更新，保持实时性
- 智能关键词泛化：输入"体育"自动扩展为10个相关关键词
- 按平台分类输出：百度、知乎、微博、抖音、B站、快手、头条依次展示
- 完整榜单查看：每个平台最多支持查看完整50条数据
- 动态智能输出：无数据平台自动跳过，数据不足自动调整展示数量
3. 一键安装
鉴权
获取 API Key
请前往 红狐hub 获取API KEY
配置 API Key
方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中，部分内容如下：
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
方案2: 终端配置：
export REDFOX_API_KEY="ak_xxxx..."
依赖安装
pip install python-dateutil
环境变量配置
| 变量名 | 说明 | 必填 |
|---|
REDFOX_API_KEY | 红狐 API Key | 是 |
4. 使用指南
基础使用
查询最新热榜（默认）
python scripts/fetch_hotspot.py --source "全平台热点事件"
数据为小时级更新，自动查询前一个完整小时。例如：当前时间为 2026-04-16 17:42:00，则查询 2026-04-16 16:00:00 到 2026-04-16 17:00:00 的数据。
查询历史热榜
python scripts/fetch_hotspot.py --source "全平台热点事件" --start-date "2026-04-15 00:00:00" --end-date "2026-04-16 00:00:00"
日期范围规则：
- 时间格式为
YYYY-MM-DD HH:MM:SS，也可简写为 YYYY-MM-DD（自动补全为 00:00:00）
- 日期范围是
[start_date, end_date) 左闭右开区间
- 例如：
--start-date "2026-04-01 00:00:00" --end-date "2026-04-02 00:00:00" 查询的是4月1日当天的数据
- 最长查询范围：30天
高级使用
筛选特定平台
python scripts/fetch_hotspot.py --source "全平台热点事件" --platforms "wb,dy,bz"
平台代码映射：
| 平台代码 | 平台名称 | 接口枚举值 |
|---|
| bd | 百度 | 7 |
| zh | 知乎 | 9 |
| wb | 微博 | 5 |
| dy | 抖音 | 2 |
| bz | B站 | 8 |
| ks | 快手 | 1 |
| tt | 头条 | 10 |
关键词搜索与泛化
python scripts/fetch_hotspot.py --source "全平台热点事件" --keywords "体育,足球"
python scripts/fetch_hotspot.py --source "全平台热点事件" --keywords "体育" --expand-keywords
关键词泛化策略：
- 大词（如"体育"、"娱乐"、"科技"）：自动扩展为10个泛化词
- 例："体育" -> ["体育", "足球", "篮球", "运动", "健身", "奥运", "世界杯", "NBA", "CBA", "乒乓球"]
- 精确词（如"苏超"、"某明星名字"）：直接传入原词，不进行扩展
- 支持泛化的大类：体育、娱乐、科技、财经、社会、游戏、汽车、美食、旅游、时尚等
查看完整榜单
当用户回复「查看{平台名}完整榜单」时：
python scripts/fetch_hotspot.py --source "全平台热点事件" --platforms wb --output markdown
智能体时间判断逻辑
根据用户意图自动选择查询方式（假设今天日期为T）：
| 用户意图 | 查询方式 | 脚本参数 |
|---|
| "今日热点" / "今日热榜" | 查询今日0:00到当前整点 | --start-date "T 00:00:00" --end-date "T {当前小时}:00:00" |
| "最新热榜" / "热点榜" | 查询前一个完整小时 | 无需指定时间参数 |
| "昨日热榜" / "昨天热榜" | 查询昨日0:00到24:00 | --start-date "T-1 00:00:00" --end-date "T 00:00:00" |
| "本周热榜" / "这周热榜" | 查询本周一0:00到当前整点 | --start-date "{本周一日期} 00:00:00" --end-date "T {当前小时}:00:00" |
本周一时间计算规则：
- 计算公式：本周一 = 今天日期 - (今天星期几 - 1) 天
- 示例：今天是2026-05-09（周六），本周一 = 2026-05-04
对比查询场景：当用户需要对比多天数据时，需分别查询多天的热榜：
python scripts/fetch_hotspot.py --source "全平台热点事件" --start-date "2026-04-15 00:00:00" --end-date "2026-04-16 00:00:00"
python scripts/fetch_hotspot.py --source "全平台热点事件" --start-date "2026-04-16 00:00:00" --end-date "2026-04-17 00:00:00"
输出格式说明
compact模式（默认）：输出极简结构化数据（元信息+平台TOP3概览），末尾附带完整数据文件路径 dataFile: {path}。智能体应使用compact模式获取数据，从 dataFile 路径读取完整JSON数据。只允许调用1次接口。
输出格式模板：按平台分类输出，每个平台展示TOP10热点。智能输出规则：
- 如果某平台没有热点数据，则不展示该平台
- 如果某平台数据少于10条，则展示实际数量
- 数据>10条时显示"该平台还有{N}条数据未展示"
- 平台顺序：百度 → 知乎 → 微博 → 抖音 → B站 → 快手 → 头条
输出格式模板详见 references/output-templates.md。
热度值处理
- 如果热度值已包含单位（如"万"、"亿"），直接使用原始值
- 如果热度值为纯数字，转换为"数字+万"格式（
hotCount // 10000 整数除法）
- 热度值格式必须为"数字+万"，禁止包含其他字符
订阅推送服务
- 每日推送：每天定时推送最新热榜（如早8点、晚8点）
- 每周推送：每周定时推送热门汇总（如周一早上）
- 推送格式：精简版TOP10表格 + 小总结（各平台TOP3 + 全网热点小总结）
命令速查表
| 场景 | 命令 |
|---|
| 最新热榜 | python scripts/fetch_hotspot.py --source "全平台热点事件" |
| 今日热榜 | python scripts/fetch_hotspot.py --source "全平台热点事件" --start-date "T 00:00:00" --end-date "T HH:00:00" |
| 昨日热榜 | python scripts/fetch_hotspot.py --source "全平台热点事件" --start-date "T-1 00:00:00" --end-date "T 00:00:00" |
| 指定平台 | python scripts/fetch_hotspot.py --platforms "wb,dy" |
| 关键词筛选 | python scripts/fetch_hotspot.py --keywords "体育,足球" |
| 关键词泛化 | python scripts/fetch_hotspot.py --keywords "体育" --expand-keywords |
数据结构说明
{
"status": "success",
"stat_time": "2026-05-08 07:35:15",
"total_count": 330,
"hotspots": [
{
"title": "热点标题",
"url": "https://...",
"hotCount": 7904508,
"index": 1,
"gmtCreate": "2026-05-08 06:00:14",
"platCode": "bd",
"platName": "百度"
}
],
"query_range": {
"type": "realtime",
"start_date": "2026-05-08 06:00:00",
| 字段 | 说明 |
|---|
| hotspots | 热点列表，包含所有平台的热点数据 |
| title | 热点标题（已处理空格） |
| url | 热点链接（空格已转为%20） |
| hotCount | 热度值（纯数字，已移除"万热度"等字符） |
| index | 平台内排名 |
| gmtCreate | 创建时间 |
| platCode | 平台代码：bd/bz/dy/ks/tt/wb/zh |
| platName | 平台名称：百度/B站/抖音/快手/头条/微博/知乎 |
5. 使用场景
场景一：内容创作者追热点
角色：自媒体创作者
需求：每天早晨快速了解全网热点，确定当日选题方向
使用方式：输入"今日热点"，获取7大平台实时热榜TOP10
预期收益：5分钟内掌握全网热点动态，精准定位高价值选题
场景二：市场运营竞品分析
角色：品牌市场运营
需求：对比同一事件在不同平台的讨论差异，了解舆论生态
使用方式：查询指定关键词热点，观察跨平台讨论焦点
预期收益：深度洞察不同平台用户讨论差异，制定差异化运营策略
场景三：PR危机监测
角色：公关经理
需求：实时监测特定品牌或事件在多平台的热度变化
使用方式：通过关键词筛选 + 订阅推送，持续追踪相关热点
预期收益：第一时间发现舆情信号，抢占危机应对窗口
场景四：热点趋势研究
角色：数据分析师
需求：对比多天热点数据，分析热点演变趋势
使用方式：使用对比查询分别查询多天数据，分析热度变化
预期收益：基于数据判断热点生命周期，输出趋势分析报告
6. 项目架构
目录结构
trending-hub/
├── SKILL.md # 技能描述文件
├── scripts/
│ └── fetch_hotspot.py # 热点数据获取脚本
└── references/
└── output-templates.md # 输出格式模板参考
技术栈
| 组件 | 技术 | 说明 |
|---|
| 脚本语言 | Python 3 | 使用标准库 urllib.request |
| 外部依赖 | python-dateutil | 日期处理 |
| 数据接口 | Redfox API | 多平台热点数据聚合 |
| 输出格式 | JSON / Markdown | 结构化和可视化输出 |
核心模块说明
| 模块 | 功能 |
|---|
fetch_hotspot.py | 从API获取多平台热点数据，支持平台筛选、关键词搜索、时间范围查询、关键词泛化 |
output-templates.md | 定义对话输出格式模板，规范各平台TOP10表格和小结格式 |
资源索引
7. 常见问答
安装相关
Q: 脚本运行报错 "ModuleNotFoundError: No module named 'dateutil'"
A: 请安装依赖：pip install python-dateutil
Q: 提示 "REDFOX_API_KEY not found"
A: 请确保已配置环境变量 REDFOX_API_KEY，可参考上方鉴权章节配置。
使用相关
Q: 为什么查询"今日热点"显示的不是今天的数据？
A: 数据为小时级更新，最新热榜查询的是前一个完整小时的数据。如需查询今日数据，使用 --start-date 和 --end-date 参数指定今天0:00到当前整点。
Q: 支持查询多久之前的数据？
A: 最长查询范围为30天。
Q: 如何查看某个平台的完整50条榜单？
A: 回复「查看{平台名}完整榜单」即可，系统会使用 --platforms 参数筛选该平台并输出完整50条数据。
Q: 热点标题无法点击？
A: 标题以 Markdown 超链接格式 [标题](url) 输出，无URL的热点仅显示文本。
故障排除
Q: API返回空数据？
A: 可能原因：1) 网络连接问题；2) API Key 无效或过期；3) 查询时间范围超出限制。请检查网络和API Key配置。
Q: 输出被截断？
A: 默认使用compact模式避免截断。如仍被截断，从compact输出末尾的 dataFile 路径读取完整JSON数据。
Q: 关键字搜索没有结果？
A: 尝试使用 --expand-keywords 参数对关键词进行泛化扩展，扩大搜索范围。
