# Trending Hub Top10

> 全网聚合热搜 TOP10 · 一次聚合抖音/微博/B站/快手/知乎/头条/百度等全网平台的热搜关键词，跨平台归并后输出综合热度最高的 TOP 榜，附所属平台分布；支持回溯近7天。只出聚合热榜，不支持查询具体某个热点详情。当用户需要全网热搜、聚合热点榜、今日热点、热榜 TOP10、跨平台热搜、选题热点扫描时使用。触发词：全网热搜、聚合热榜、今日热点、热榜TOP10、跨平台热搜、热点榜、热搜关键词。

- **Type:** Skill
- **Install:** `agentstack add skill-zizhanovo-doubaoya-community-trending-hub-top10`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [zizhanovo](https://agentstack.voostack.com/s/zizhanovo)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [zizhanovo](https://github.com/zizhanovo)
- **Source:** https://github.com/zizhanovo/doubaoya-community/tree/main/skills/trending-hub-top10

## Install

```sh
agentstack add skill-zizhanovo-doubaoya-community-trending-hub-top10
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 全网聚合热搜 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. 调用脚本
```bash
# 最新聚合热榜
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_…`）

配置到环境变量（脚本只认这个）：
```bash
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](https://github.com/zizhanovo)
- **Source:** [zizhanovo/doubaoya-community](https://github.com/zizhanovo/doubaoya-community)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-zizhanovo-doubaoya-community-trending-hub-top10
- Seller: https://agentstack.voostack.com/s/zizhanovo
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.