# Weibo Hot Search

> 微博热搜榜单查询工具。调用 Redfox 接口获取微博当前热搜榜单，按排名展示热搜标题及跳转链接，并对热搜内容进行创作灵感分析总结。当用户需要查看微博热搜、微博热榜、微博热门话题时使用。触发词：微博热搜、微博热榜、微博热门话题、热搜榜、微博热搜榜。

- Skill: `redfox-data/weibo-hot-search` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds add redfox-data/weibo-hot-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/redfox-data/weibo-hot-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: redfox-data (https://skillmd.com/u/redfox-data)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/redfox-data/weibo-hot-search

---


# 微博热搜

## 📝 简介

微博热搜榜单查询工具，获取微博当前热搜榜单并按排名展示，同时归纳提炼热搜话题背后的创作灵感和选题方向。

## ✨ 功能特性

| 功能模块 | 能力描述 | 核心价值 |
|---------|---------|---------|
| 热搜榜单 | 获取微博当前热搜榜单 | 一站式掌握全平台实时热点 |
| 排名展示 | 按热搜排名从 1 到 N 展示 | 直观了解热度梯度 |
| 灵感分析 | 对热搜内容进行归纳总结 | 提炼选题方向，激发创作灵感 |
| 一键跳转 | 每条热搜附带微博搜索链接 | 点击直达搜索结果页 |

## 🔑 鉴权

### 获取 API Key

请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取 API KEY

### 配置 API Key

方案1: 以 Qoder 为例，将 REDFOX_API_KEY 添加到 `~/.openclaw/openclaw.json` 中：

```bash
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
```

方案2: 终端配置

```bash
export REDFOX_API_KEY="ak_xxxx..."
```

## 🔄 工作流程

### Step 1：调用热搜脚本

```bash
python3 ~/.agents/skills/weibo-hot-search/scripts/fetch_weibo_hot.py
```

脚本以 JSON 格式输出：

| 字段       | 说明             |
| ---------- | ---------------- |
| `items`    | 热搜条目列表     |

每条热搜：

| 字段       | 说明               |
| ---------- | ------------------ |
| `rank`              | 排名（从 1 开始）         |
| `title`             | 热搜标题                  |
| `url`               | 跳转链接                  |
| `hot_score`         | 热度值（原始数值）         |
| `hot_score_display` | 热度值（格式化展示用）      |
| `tag_text`          | 标签文字（新/热/沸/暖）    |

### Step 2：判断结果并展示

#### 情况 A：items 数量 > 0（有数据）

**A1. 告知用户**

> 🔥 微博当前热搜榜，共 **N 条**热搜：

**A2. 渲染 Markdown 表格**

```markdown
| #   | 热搜标题                     | 热度    | 标签 |
| --- | ---------------------------- | ------- | ---- |
| 1   | [热搜标题](https://s.weibo.com/weibo?q=热搜标题) | 305.2w  | 热 |
```

**数字格式化规则（热度）：**
- `< 10000`：原始数字
- `≥ 10000`：`x.xw` 格式

**A3. 创作灵感分析总结（⚠️ 表格之后必须输出，不可省略）**

对热搜内容进行归纳分类和选题提炼，按以下结构输出：

> 💡 **创作灵感分析**
>
> **🔥 热点赛道分布**
>
> 将热搜按主题归类（如娱乐/体育/社会/科技/政策等），列出每个类别下的代表性热搜。
>
> **📈 内容选题建议**
>
> 基于热搜方向，提炼 3-5 条可落地的创作选题建议，每条包含：
> - **选题方向**：用 2-6 字概括
> - **切入点**：一句话说明可以从什么角度创作内容
>
> **⚠️ 风险提示**
>
> 对涉及敏感话题的热搜给出规避建议（如有）。

示例：

> 💡 **创作灵感分析**
>
> **🔥 热点赛道分布**
>
> - 🎬 **娱乐明星**（7条）：时代少年团演唱会、杨幂赢面很大、薛之谦北京演唱会...
> - ⚽ **体育赛事**（5条）：哈兰德吐槽姆巴佩、姆巴佩受伤、无论谁夺冠都来找蒙牛...
> - 🌪️ **自然灾害/天气**（4条）：台风巴威又改路线了、广西洪水、北京5区有大暴雨...
> - 🏛️ **时事政策**（3条）：习近平勉励科技工作者、防灾救灾责任、许静婉偷逃税被查...
>
> **📈 内容选题建议**
>
> - **台风天气科普**：结合巴威改动路线和广西洪水，做一份台风避险指南或极端天气生存攻略
> - **演唱会大盘点**：整理近期热门演唱会，制作观演攻略或性价比分析
> - **体育热点复盘**：姆巴佩受伤事件深度分析，结合足球话题做技术解读
> - **影视热度追踪**：百花杀热度破24000，可以做同类型剧集横向对比或追剧指南
>
> **⚠️ 风险提示**
>
> - 涉及政策/领导人相关热搜，仅做客观转载，不发表主观评论
> - 灾害类热搜需核对信息来源，避免传播未经核实的伤亡数据
> - 偷逃税、负面社会事件等热搜注意措辞，不做主观定性

**A4. 订阅提示**

> 📩 是否订阅「**微博热搜**」的每日推送？订阅后每天 09:00 自动推送最新热搜榜。回复「确认订阅」即可创建定时任务。

**⚠️ A1~A4 缺一不可，必须在同一轮输出中连续完成。**

#### 情况 B：items 数量 = 0（无数据）

> 😔 抱歉，暂时无法获取微博热搜数据，请稍后重试。

### Step 3：创建定时任务（用户回复「确认订阅」或指定推送时间时执行）

优先使用平台内置定时任务能力。

**确定推送时间：**

- 如果用户指定了时间（如"每天 08:00"、"每天 18:00"），则使用用户指定的时间
- 如果用户只说「确认订阅」未指定时间，则默认使用每天 09:00
- 支持 24 小时制时间格式，如 06:00、09:00、14:30、18:00、21:00 等

**创建调度任务：**

- 任务名称：`微博热搜订阅`
- 执行频率：每天 [用户指定时间或默认 09:00]
- 执行内容：运行脚本并将结果按 Step 2 格式展示推送到当前对话（含 A1~A4 全流程）

创建成功后告知用户："已成功订阅微博热搜推送，每天 [实际推送时间] 将自动查询热搜榜并通知你。"