trending-hub

全网热点追踪

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 的数据。

查询历史热榜

# 查询昨日热榜（假设今天是2026-04-16）
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

对比查询场景：当用户需要对比多天数据时，需分别查询多天的热榜：

# 对比昨天和今天的热榜（假设今天是2026-04-16）
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 整数除法）
  • 示例：百度热度 7904508 → 790万
• 热度值格式必须为"数字+万"，禁止包含其他字符

订阅推送服务

• 每日推送：每天定时推送最新热榜（如早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",
    "end_date": "2026-05-08 07:00:00"
  }
}

フィールド	説明
hotspots	ホットスポットのリスト。全プラットフォームのホットスポットデータを含みます
title	ホットスポットのタイトル（空白処理済み）
url	ホットスポットのリンク（空白は%20に変換済み）
hotCount	熱量値（純粋な数値。「万熱度」などの文字は除去済み）
index	プラットフォーム内のランキング
gmtCreate	作成日時
platCode	プラットフォームコード：bd/bz/dy/ks/tt/wb/zh
platName	プラットフォーム名：百度/B站/抖音/快手/头条/微博/知乎

5. 利用シーン

シーン1：コンテンツクリエイターがホットスポットを追う

役割：セルフメディアクリエイター ニーズ：毎朝、全ネットのホットスポットを素早く把握し、その日のテーマの方向性を決定する 利用方法：「今日のホットスポット」と入力し、7大プラットフォームのリアルタイム人気ランキングTOP10を取得する 期待される効果：5分以内に全ネットのホットスポット動向を把握し、価値の高いテーマを正確に見つけ出す

シーン2：マーケティング担当者の競合分析

役割：ブランドマーケティング担当者 ニーズ：同一の出来事に対するプラットフォームごとの議論の差異を比較し、世論の生態を把握する 利用方法：指定したキーワードのホットスポットを検索し、プラットフォームをまたいだ議論の焦点を観察する 期待される効果：プラットフォームごとのユーザー議論の差異を深く洞察し、差別化された運営戦略を策定する

シーン3：PRクライシスモニタリング

役割：広報マネージャー ニーズ：特定のブランドや出来事のマルチプラットフォームでの熱量変化をリアルタイムで監視する 利用方法：キーワードフィルタリング + 購読プッシュにより、関連するホットスポットを継続的に追跡する 期待される効果：いち早く世論のシグナルを発見し、クライシス対応の窓を確保する

シーン4：ホットスポットトレンドの研究

役割：データアナリスト ニーズ：複数日分のホットスポットデータを比較し、ホットスポットの変遷トレンドを分析する 利用方法：比較クエリを使い複数日分のデータをそれぞれ検索し、熱量の変化を分析する 期待される効果：データに基づいてホットスポットのライフサイクルを判断し、トレンド分析レポートを出力する

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テーブルとまとめの書式を規定します

リソースインデックス

• スクリプト: scripts/fetch_hotspot.py を参照（用途と引数：APIからホットスポットデータを取得し、プラットフォームのフィルタリングをサポート）
• 参考: references/output-templates.md を参照（読み込むタイミング：対話出力時に書式テンプレートを参照）

7. よくある質問

インストール関連

Q: スクリプトの実行時に "ModuleNotFoundError: No module named 'dateutil'" というエラーが出ます A: 依存関係をインストールしてください：pip install python-dateutil

Q: "REDFOX_API_KEY not found" と表示されます A: 環境変数 REDFOX_API_KEY が設定されていることを確認してください。上記の認証の章を参考に設定できます。

使用関連

Q: なぜ「今日のホットスポット」を検索しても今日のデータが表示されないのですか？ A: データは時間単位で更新されるため、最新のランキング検索では直前の完全な1時間分のデータが対象となります。今日のデータを検索する場合は、--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 パラメータを使ってキーワードを汎化拡張し、検索範囲を広げてみてください。