weather-api

🌤️ 无需密钥的实时天气查询助手

基于公开免费 API 的零配置天气查询方案,无需密钥即可获取全球实时天气,适合开发者与终端用户快速集成。

收藏
3.9k
安装
970
版本
v2.1.0
CLS 安全性认证2026-05-13
点击查看完整报告 >

使用说明

Weather 是一款纯文档型天气查询技能,专注于提供零成本、开箱即用的全球天气数据获取方案。该技能整合了两个知名的免费天气服务 wttr.inOpen-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 发送地理位置信息(城市名或坐标),虽无敏感数据上传,但位置信息可能被服务端记录;无技术支持:遇到服务中断或数据不准确时,缺乏官方技术支持渠道;数据准确性:免费服务的数据更新频率和精度可能不及商业气象服务,不适用于对精度要求极高的场景。

安全解读

核心用法

该Skill提供完整的天气数据集成方案,核心包含两大组件:

1. WeatherAPIClient 数据获取层

  • 调用Open-Meteo免费API获取全球气象数据,无需API Key
  • 支持7天逐小时预报(温度、湿度、风速、降水量)
  • 支持历史数据回溯查询,格式为ISO日期字符串
  • 自动解析为结构化WeatherCondition对象,支持导出pandas DataFrame

2. ConstructionWeatherRisk 风险评估层

  • 预置5类施工活动的安全阈值:混凝土浇筑(5-35°C)、吊装作业(-10-40°C,风速<10m/s)、外墙涂装(10-35°C,无降水)、屋面工程(5-38°C,无降水)、土方作业(-5-40°C)
  • 四级风险评级:LOW/MODERATE/HIGH/CRITICAL
  • 输出可作业时长、受影响活动清单及具体原因建议
  • 支持单日评估与周度批量风险分析

显著优点

  • 零成本接入:依托Open-Meteo开源服务,无API费用与注册门槛
  • 行业针对性:阈值设定贴合混凝土养护、高空作业等真实施工场景
  • 决策量化:将天气条件转化为具体可作业小时数,便于排程优化
  • 代码可扩展:采用dataclass与Enum设计,易于自定义活动类型与阈值
  • 隐私友好:纯本地数据处理,不上传敏感信息

潜在局限

  • 预报精度依赖Open-Meteo,复杂地形区域可能存在偏差
  • 未集成突发天气预警(雷暴、大风蓝色预警等)
  • 历史数据查询受API限制,超长期回溯需分段处理
  • 缺乏与实际项目管理系统(如Primavera、MS Project)的直接对接
  • 阈值为通用建议,特殊工艺需自行调整

适合人群

  • 施工项目经理、现场工程师进行周计划天气窗口筛选
  • 造价人员基于历史气象数据编制赶工/窝工索赔依据
  • 施工企业信息化部门快速搭建轻量级天气监控原型
  • 建筑院校师生研究气象因素对施工效率的影响

常规风险

  • API可用性风险:Open-Meteo虽稳定但非商业SLA保障,关键项目建议配置备用数据源
  • 阈值误用风险:严寒地区冬季施工、沿海台风工况需人工复核风险评级
  • 数据时效性:预报数据非实时,极端天气突变时需结合当地气象局预警
  • 坐标精度:大面积工地单点坐标可能无法代表全场微气候差异

weather-api 内容

手动下载zip · 1004 B
SKILL.mdtext/markdown
请选择文件