wttr.in

简介

wttr.in 是命令行友好的天气服务：用 curl 指向城市名，终端里直接渲染出漂亮的 ANSI 天气预报。同时支持 JSON、纯文本和 PNG 输出，完全不需要 API 密钥。

它是经典的“终端天气”工具——非常适合 shell 脚本、状态栏、登录提示和快速查询。

快速开始

查询本机 IP 所在位置天气：

curl wttr.in

指定城市：

curl wttr.in/London
curl wttr.in/Shanghai

JSON 输出（适合脚本解析）：

curl "wttr.in/London?format=j1"

紧凑单行格式：

curl "wttr.in/London?format=3"

自定义占位符格式：

curl "wttr.in/London?format=%c+%t+%w"

支持的能力

• 城市名、lat,lon 坐标或 ICAO 机场代码（wttr.in/EGLL）
• ?format=j1 完整 JSON，程序化使用
• ?format=3 / 4 / 5 紧凑文本变体
• PNG 输出可嵌入网页：wttr.in/London.png
• 多日预报（默认 3 天）

认证方式

无需认证——wttr.in 免注册、免密钥。

速率限制与注意事项

• 免费且无 key；重度自动化请节制使用（这是免费的社区服务）。
• 全球覆盖；部分站点的数据更新频率较低。
• ?format=j1 返回的 JSON 较大——高频轮询请加缓存。

常见问题

wttr.in 需要 API 密钥吗？ 不需要——完全免密钥。

能返回 JSON 而不是终端图案吗？ 可以——加 ?format=j1 获取完整 JSON，或 ?format=3 获取紧凑文本。

能嵌入网页吗？ 可以——PNG 输出（wttr.in/London.png）以图片形式渲染预报。