weather-api

Weather 是一款纯文档型天气查询技能，专注于提供零成本、开箱即用的全球天气数据获取方案。该技能整合了两个知名的免费天气服务 wttr.in 和 Open-Meteo，通过简单的 curl 命令即可获取当前天气状况和未来预报，无需注册账号或申请 API Key。

核心用法

该技能主要提供命令行级别的使用文档，包含丰富的 curl 示例。通过 wttr.in 服务，用户可以使用城市名、机场代码或坐标进行查询，支持高度自定义的输出格式（如温度、湿度、风速、月相等），并可选择 metric 或 USCS 单位。对于需要结构化数据的场景，Open-Meteo 提供标准的 JSON 接口返回，便于程序化解析。所有示例代码均可直接复制执行或集成到自动化脚本中，支持输出 PNG 图片格式以便可视化展示。

显著优点

最突出的优势是零成本准入——无需信用卡、无需注册、无调用次数限制（在合理范围内）。开箱即用的设计理念使得用户无需配置环境变量或管理密钥，一条命令即可获取数据。格式灵活是另一大亮点，wttr.in 支持丰富的格式化参数，可输出极简文本或详细预报，甚至直接生成天气图片。全球覆盖能力支持世界各地的城市查询和地理坐标定位。对于开发者而言，纯文本/JSON 输出极易与 Shell 脚本、CI/CD 流程或后端服务集成，是快速原型开发的理想选择。

潜在缺点与局限性

作为依赖第三方免费服务的方案，服务稳定性是首要考量。wttr.in 和 Open-Meteo 虽为知名项目，但无 SLA 保障，可能因流量过大或维护而暂时不可用。功能边界较为明确，仅提供基础天气查询，缺乏历史数据回溯、极端天气预警、详细气象分析等高级功能。此外，该技能为 T3 来源（社区/个人发布），文档的维护更新频率和长期支持存在不确定性。对于需要高可用性的生产环境，建议作为辅助参考而非核心依赖。

适合的目标群体

主要面向命令行爱好者、DevOps 工程师、后端开发者以及需要快速集成天气功能的系统管理员。适合用于个人日常使用、服务器状态监控脚本、IoT 项目原型验证、教育场景演示 API 调用，以及任何对成本敏感且能接受免费服务限制的场景。对于需要商业级气象数据的企业应用，建议考虑付费的专业气象服务。

使用风险

可用性风险：依赖外部网络连接和第三方服务状态，存在单点故障可能；隐私风险：查询时需向 API 发送地理位置信息（城市名或坐标），虽无敏感数据上传，但位置信息可能被服务端记录；无技术支持：遇到服务中断或数据不准确时，缺乏官方技术支持渠道；数据准确性：免费服务的数据更新频率和精度可能不及商业气象服务，不适用于对精度要求极高的场景。