weibo-hot-search

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

微博热搜

📝 简介

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

✨ 功能特性

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

🔑 鉴权

获取 API Key

请前往 红狐hub 获取 API KEY

配置 API Key

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

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

方案2: 终端配置

export REDFOX_API_KEY="ak_xxxx..."

🔄 工作流程

Step 1：调用热搜脚本

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 表格

| #   | 热搜标题                     | 热度    | 标签 |
| --- | ---------------------------- | ------- | ---- |
| 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 全流程）

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