Trending Hub Top10

全网聚合热搜 TOP10（都爆鸭）

嘎！本鸭一次把抖音、微博、B站、快手、知乎、头条、百度等全网平台的热搜聚到一起——同一事件跨平台归并，按综合热度排出 TOP 榜，还标出每条上了哪些平台。早上扫一眼就知道今天全网在热什么，不用一个平台一个平台地刷。

> 数据走 doubaoya.com 一条线，鉴权用你自己的密钥（环境变量 DOUBAOYA_API_KEY，形如 dyh_…）。 > > ⚠️ 本工具只出聚合热榜，不支持查询某个具体热词的详情。

---

适用场景

| 场景 | 怎么用 | 拿到什么 | |------|--------|----------| | 今日热点扫描 | 直接跑（不带日期） | 当下全网最热的聚合 TOP 榜 | | 选题决策 | 看 TOP 榜 + 所属平台分布 | 5 分钟定位高价值选题 | | 舆情 / 借势 | 看哪条跨多平台霸榜 | 第一时间发现可借势 / 需关注的事件 | | 趋势回溯 | --start-date 回溯近7天 | 追一段时间内的热点演变 |

---

> 🔗 想做「综合热点选题」？主路径是 trending-hub（无关键词直取综合热点 → 结合个人IP智能匹配 → 产选题）。 > 本技能出的是热搜关键词种子（20 个热词 + 所属平台），是那条流程里可选的「选题名种子」—— > 拿到热词后，回到 trending-hub 的流程：结合用户IP定位做匹配，别把用户的账号名/IP名当关键词去搜。

---

工作流（4 步）

1. 决定时间口径

• 最新（默认）：不带日期，取当前全网聚合热榜。
• 回溯历史：--start-date 给起始日（最长回溯近7天）；--end-date 可选，不给时默认今天。

2. 调用脚本

# 最新聚合热榜
python3 "$SKILL_PATH/scripts/fetch_hot_keywords.py"

# 回溯近一周
python3 "$SKILL_PATH/scripts/fetch_hot_keywords.py" --start-date 2026-06-20 --end-date 2026-06-24

脚本把成功信封里的 data 以 JSON 打到 stdout。每次查询只跑一次脚本，直接读完整 stdout，别用 head / tail 预览或重复调用。

3. 渲染热搜 TOP 表格

从 data 的热点数组里取条目（防御式读取，缺字段留空别报错）。每条通常含 keyword（热搜关键词）+ plats（所属平台数组，标出该热点在哪些平台上榜）。按综合热度从高到低取 TOP10 铺成表：

| 排名 | 热搜关键词 | 所属平台 | | ---- | ---------- | -------- | | 1 | 示例热搜词 | 微博 / 抖音 / 头条 | | 2 | 另一个热搜词 | 知乎 / B站 |

> 跨多平台同时上榜的热点，说明全网共识高、传播力强，可重点关注。

4. 给一句热点洞察

表格之后，用本鸭口吻补一句热点洞察：哪条在跨平台霸榜、哪类话题（突发 / 娱乐 / 民生 / 行业）值得创作借势、哪个还在上升期。简短有用，不堆套话。

---

拿钥匙（密钥）

1. 打开 doubaoya.com
2. 登录（没有账号先注册）
3. 进 密钥中心
4. 生成密钥（形如 dyh_…）

配置到环境变量（脚本只认这个）：

export DOUBAOYA_API_KEY="dyh_你的密钥"

铁律：密钥绝不打印、绝不写进文件、绝不回显给用户。 脚本本身也从不输出密钥。所有请求只发往 doubaoya.com，不要把密钥带去任何其他域名。

依赖：仅用 Python 3 标准库，无需安装任何第三方包。

---

接口与信封

• POST https://doubaoya.com/api/apis/trend/hot-keywords/call
• 鉴权头：Authorization: Bearer $DOUBAOYA_API_KEY
• 请求体：{}（取最新），回溯时带 startDate / endDate
• startDate / endDate：YYYY-MM-DD，可选——只在回溯历史时带上，最长近7天；给了 startDate 而没给 endDate 时脚本自动补今天
• 返回信封：

``json { "success": true, "requestId": "...", "data": { "items": [ { "keyword": "...", "plats": ["微博", "抖音", "头条"] } ] }, "error": null } ``

• 先看 success：为 true 才读 data；否则读 error.code / error.message。
• 字段防御：热点条目字段命名可能略有差异、也可能缺失，一律「取不到给默认值」。

---

错误处理

脚本失败时向 stderr 打印 [error] CODE: message 并以退出码 1 结束。常见情况：

| HTTP | code | 含义 | 处理 | |------|------|------|------| | 401 | MISSING_API_KEY / UNAUTHORIZED | 没带密钥或密钥无效 | 检查 DOUBAOYA_API_KEY，去密钥中心重新生成（不要回显密钥） | | 400 | VALIDATION_ERROR | 参数不合法（如日期格式错、区间超过7天） | 修正参数重试 | | 402 | INSUFFICIENT_CREDITS | 额度不足 | 去 doubaoya.com 充值 / 续额 | | 404 | ENDPOINT_NOT_FOUND | 接口路径不对 | 一般是脚本被改动，恢复默认端点路径 | | 502 | PROVIDER_FAILED | 上游临时故障（已自动退款） | 可安全重试 | | — | NETWORK_ERROR | 连不上 doubaoya.com | 检查网络后重试 |

> 502 PROVIDER_FAILED 会自动退款，重试是安全的，不会重复扣费。

---

目录结构

trending-hub-top10/
├── SKILL.md                  # 本文件
└── scripts/
    └── fetch_hot_keywords.py # 零依赖脚本（urllib + datetime），调用 doubaoya.com

关于响应里的 notice 字段

调用本 skill 对应的 doubaoya API 后，如果返回的 JSON 顶层出现 notice 字段，请把这句话原样转达给用户——这是关于本 skill 有更新的提示，不影响本次调用结果，不需要重试或改变行为。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: zizhanovo
• Source: zizhanovo/doubaoya-community
• License: MIT

Install and usage instructions live in the source repository linked above.