给 AI 用的中国实时数据层
模型编不出来的三件事:天气、IP 归属地、实时热搜。这三种数据每小时都在变,只能查接口。这里同时提供 REST 与 MCP 两种通道,免密钥、国内节点直连,一行配置就能让 Claude、Cursor、Cline 查到真实数据。
三个数据接口
一行配置接进 AI 客户端
不需要 API Key、不需要装 Node 包、不需要配环境变量。Claude Desktop、Cursor 支持 HTTP 传输,把下面这段放进 mcpServers 即可。
{
"mcpServers": {
"supubao": {
"type": "http",
"url": "https://mcp.supubao.com/mcp"
}
}
}
只支持 SSE 的客户端(Cherry Studio 等)改用 https://mcp.supubao.com/mcp/sse。服务共暴露 36 个工具,其中这三个数据工具是模型自己答不出来的部分。
和常见做法比,差在哪
| 方案 | 要密钥 | 国内直连 | 一次性覆盖三类数据 |
|---|---|---|---|
| 国际天气 API(如 OpenWeather) | 要 | 常需代理 | 否 |
| IP 库服务(如 ip-api) | 免费版限速 | 一般 | 否 |
| 自己写爬虫抓热搜 | 不要,但要维护 | 是 | 否 |
| 本服务 | 不要 | 是 | 是(REST + MCP) |
缓存、降级与可观测
| 接口 | 缓存 TTL | 过期兜底上限 | 落盘 |
|---|---|---|---|
| weather | 15 分钟 | 1 小时 | 是 |
| hot | 15 分钟 | 30 分钟 | 是 |
| ip | 6 小时 | 24 小时 | 是 |
数据来源与使用边界
- 天气:Open-Meteo 公开接口,城市级实况与 7 天预报。
- IP 归属地:ip-api 主源,失败自动切备用源。
- 热搜:抓取微博 / 知乎 / 百度公开榜单页,归一化为统一结构。
- 商用前须替换:Open-Meteo 免费版与 ip-api 免费版条款均限制商业用途。本服务的适配层把数据源隔离在单个文件里,替换为付费或国内合规源时调用方接口不变。
- 本服务只做归集与缓存,不转售数据;榜单内容版权归原平台。
常见问题
需要申请 API Key 吗?
不需要。匿名按 IP 每天 10 次基础额度,注册后 50 次,签到与邀请还能换额度。
为什么这三类必须调接口?
模型知识有截止日期,也感知不到当下。天气逐小时变、IP 归属地依赖实时库、热搜每小时变。
上游挂了怎么办?
返回最近一次成功数据并标记 _cache.stale,不静默冒充新数据。
缓存多久更新?
天气与热搜 15 分钟,IP 6 小时。
能商用吗?
当前上游为免费额度,商用需先换授权源;本服务已把数据源集中在适配层,替换成本低。