数据接口:天气 / IP 归属地 / 实时热搜

三个模型编不出来的实时数据接口:免密钥、国内节点直连、固定 JSON 结构,AI 客户端与 MCP 工具可直接接入。

为什么单独做这三个

工具类接口(Base64、JSON 格式化、时间戳)AI 一句话就能算,不需要调服务;而天气、IP 归属地、热搜这类每分钟都在变的数据,模型的知识截止后就给不出,只能靠接口。这三件事是本站不可替代的部分,其余工具页是陪衬。

GET https://tool.supubao.com/api/v1/tool/weather?city=洛阳&days=3 GET https://tool.supubao.com/api/v1/tool/ip?ip=8.8.8.8 GET https://tool.supubao.com/api/v1/tool/hot?type=weibo POST 同样可用,参数走 JSON body: POST https://tool.supubao.com/api/v1/tool/weather {"city":"洛阳","days":3}

参数与返回字段

接口参数主要字段缓存
/weather city(必填,中文城市名)
days(1-7,默认 3)
current.temp / feels_like / humidity / wind / weather;daily[].date / temp_max / temp_min / rain_prob 15 分钟
/ip ip(必填,IPv4/IPv6) country / region / city / isp / asn / timezone 6 小时
/hot type(weibo 默认 / baidu) count、list[].rank / title / hot / url 15 分钟

接入示例

curl

curl "https://tool.supubao.com/api/v1/tool/weather?city=%E6%B4%9B%E9%98%B3&days=3"

JavaScript(浏览器 / Node)

const r = await fetch('https://tool.supubao.com/api/v1/tool/hot?type=weibo'); const j = await r.json(); if (j.code === 0) console.log(j.data.list.map(x => x.title)); // POST 写法(参数含中文或较长时推荐) await fetch('https://tool.supubao.com/api/v1/tool/weather', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ city: '洛阳', days: 3 }), });

MCP 客户端(Claude Desktop / Cursor / Cline)

{ "mcpServers": { "supubao": { "url": "https://mcp.supubao.com/mcp" } } }

接入后可直接让模型调用:查一下洛阳明天天气、查 8.8.8.8 归属地、今天微博热搜前 5 条。

缓存与降级策略

· 缓存落盘(SQLite),服务重启后仍能命中,冷启动不会瞬间打满上游 · 上游接口全部失败时,用最近一份过期数据兜底,响应里带 _cache: {stale: true, age: 秒} · 响应附带 _quota(当前额度与剩余次数),便于客户端自行退避 · 运行状态可查:GET /api/v1/stats/upstream?hours=24,返回各接口调用量、失败率与平均耗时

数据来源与使用边界

天气 Open-Meteo(免费版,条款限制非商业用途) IP ip-api.com 为主、ipapi.co 为备(免费版均限制非商业用途) 热搜 微博公开榜单接口 / 百度热搜公开页,非官方授权接口 结论:个人开发、学习、内部演示可以直接用;对外商用(收费服务、广告变现、 企业交付)必须换成对应服务的付费授权或国内合规数据源(如和风天气付费版、 商业 IP 库)。本站会在商用前完成替换,此页保留来说明当前状态。

常见问题

这三个接口和让 AI 直接回答有什么区别?

天气、IP 归属地、热搜是每分钟都在变的实时数据,模型的知识截止后就编不出来,只能靠检索或调用接口。这里提供的是免密钥、国内节点直连的固定接口,AI 客户端和 MCP 工具可以一行接入。

缓存多久,会不会拿到过期数据?

天气 15 分钟、热搜 15 分钟、IP 归属地 6 小时。缓存落盘,服务重启不会丢;当上游全部失败时会用最近的过期数据兜底,并在响应里用 _cache.stale 标记,不会悄悄给你一份旧数据。

接口有调用额度限制吗?

未登录按 IP 每日 10 次基础额度,注册后 50 次,签到与邀请可换额外额度(3 积分抵 1 次)。数据类接口走缓存,同一参数重复调用通常几毫秒返回、且不额外打上游。

能商用吗?

当前数据分别来自 Open-Meteo 免费版、ip-api 免费版与公开榜单页,这些来源均限制非商业用途。个人开发、学习与内部使用可以;要商用必须换成对应服务的付费授权或国内合规数据源。