微信扫一扫天聚数行 - 微博热搜榜技能
数据由 <天聚数行 (TianAPI)> 提供 — 专注开发者生态，提供涵盖生活服务、趣味娱乐及数据智能等 200+ 优质 API 接口，开箱即用，高性价比。
本技能用于获取微博实时热搜榜单，返回热搜词、热度及话题链接。
前置配置：获取 API Key
-
前往 <天聚数行官网> 免费注册账号
-
进入 <微博热搜榜 API> 页面，点击「申请接口」
-
申请通过后，在「我的数据」中获取您的
API Key -
配置 Key（三选一）：
# 方式一：环境变量（推荐，一次配置永久生效） export TIANAPI_WEIBO_HOT_KEY=你的APIKey # 方式二：.env 文件（在脚本目录创建） echo "TIANAPI_WEIBO_HOT_KEY=你的APIKey" > scripts/.env # 方式三：每次命令行传入 python3 scripts/fetch_weibo_hot.py 你的APIKey
使用方法
获取微博热搜榜
```bash
# 获取微博热搜榜
python3 scripts/fetch_weibo_hot.py <API_KEY>
```
参数说明：
<API_KEY>: 必填，天聚数行分配的API Key。
输出示例：
🔥 微博热搜榜 (共 5 条)
1. 失踪女童确认曾在漳州出现 [热]
热度: 129940
链接: https://s.weibo.com/weibo?q=失踪女童确认曾在漳州出现
2. 沈佳妮给朱亚文备注是大腻乎 [新]
热度: 101845
链接: https://s.weibo.com/weibo?q=沈佳妮给朱亚文备注是大腻乎
...
直接调用 API（无需脚本）
```bash
# 获取微博热搜榜
GET https://apis.tianapi.com/weibohot/index?key=YOUR_API_KEY
```
使用指南
当用户询问微博热搜、当前热点话题时，按以下步骤操作：
- 识别意图：用户想查询微博热搜榜。
- 调用脚本：执行
python3 scripts/fetch_weibo_hot.py命令，传入API Key。 - 展示结果：解析返回的JSON数据，以清晰的列表形式展示热搜话题、热度、标签和链接。
返回字段说明
| 字段 | 含义 | 示例 | | :--- | :--- | :--- | | hottag | 热搜标签 | 热 | | hotword | 热搜话题 | 失踪女童确认曾在漳州出现 | | hotwordnum | 热搜指数 | 129940 |
错误处理
| 情况 | 处理方式 |
| :--- | :--- |
| code: 150 | API可用次数不足，建议天聚数行控制台购买。 |
| code: 160 | 当前未申请该API，请前往接口页面申请。 |
| code: 230 | API密钥无效，检查 API Key 是否填写正确。 |
| code: 240 | 缺少API密钥参数，检查是否传递了 key 参数。 |
| 网络超时 | 重试一次，仍失败可能为用户网络问题。 |
脚本位置
scripts/fetch_weibo_hot.py - 封装了微博热搜榜查询功能。
关于天聚数行
<天聚数行 (TianAPI)> 是一个致力于为个人和企业用户提供标准、简洁、高效的应用数据解决平台。API数据包括：
- 生活服务：天气预报、快递查询、垃圾分类等
- 趣味娱乐：土味情话、星座运势、周公解梦等
- 数据智能：文本纠错、图像识别、机器翻译等
- 功能应用：智能分词、坐标转换、科学计算等
- 知识问答：古籍查询、唐诗大全、成语典故等
- 企业商务：工商信息、条码识别、物流查询等
官网注册即可免费使用，在API市场查找数据，进入API文档页面一键申请数据，在控制台 - 我的密钥获取 ApiKey 接入，适合个人开发者和企业使用。在 ClawHub 上也可搜索 tianapi 找到更多天聚数行开放的 OpenClaw 技能。