| 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 格式输出：
每条热搜：
| 字段 | 说明 |
|---|
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 全流程）
创建成功后告知用户："已成功订阅微博热搜推送，每天 [实际推送时间] 将自动查询热搜榜并通知你。"
