核心用法
本技能通过 Open-Meteo 开放 API 提供全球天气数据查询,支持两种模式:
主链路(Open-Meteo)
- 地理编码:将城市名转换为经纬度坐标
- 实时天气:温度、风速、风向、天气代码
- 7天预报:最高/最低气温、降水量等
- 输出格式:结构化 JSON,便于二次处理
备用链路(wttr.in)
- 当主链路失败时自动降级
- 支持纯文本、HTML 或 PNG 图像输出
- 无需 API 密钥,即开即用
显著优点
- 零成本:无需注册或 API 密钥
- 全球覆盖:基于 WMO 气象数据,覆盖绝大多数城市
- 双保险设计:主备链路确保可用性
- 轻量依赖:仅需
curl和jq,适合各类终端环境 - 参数安全:内置 URL 编码示例,防止注入风险
潜在局限
- 功能边界:不支持历史数据、极端天气预警、详细气候分析
- 速率限制:约 100 请求/分钟,高频场景需缓存策略
- 精度依赖:地理编码结果可能存在歧义(如同名城市)
- 备用链路限制:wttr.in 返回格式较简单,难以结构化解析
适合人群
- 需要快速集成天气功能的开发者/脚本用户
- 对 API 成本敏感的个人或小型团队
- 命令行环境为主的运维、极客用户
- 非关键业务场景(如展示、通知、个人助手)
常规风险
- 网络依赖:双链路均依赖外部服务,离线不可用
- 数据时效:Open-Meteo 更新频率约 1-3 小时,非实时
- 地理编码误差:建议优先使用明确坐标而非模糊地名
- 速率超限:生产环境建议添加指数退避重试机制
---
安全提示:本技能仅涉及公开气象数据查询,无敏感操作,但应注意避免在 URL 中硬编码敏感位置信息。