Weather NWS

🌦️ 美国国家气象官方预报 · 精准积雪量 · 全球自动降级

美国国家级气象服务官方接口,提供精确降水积雪量、小时级预报及空气质量,非美地区自动降级至 wttr.in 全球服务。

收藏
5.7k
安装
1.3k
版本
1.0.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Weather NWS 通过双源架构(NWS 官方 API + wttr.in 全球备用)提供 8 种预报模式:标准 12 小时预报、小时级逐时解析(156 时段/7 天)、冬季风暴积雪量结构化数据、AirNow 空气质量指数(AQI)、实时观测对比(温度偏差、湿度、露点、气压)、天文时刻(日出日落、民用暮光、月相)、航空气象(TAF 终端区预报)及火险天气(红旗警告)。系统通过自然语言自动识别时间意图(如"今晚 8 点"、"明天早上")切换小时模式,无需手动指定。

显著优点

1. 权威数据源:NWS 为美国联邦官方气象机构,预报精度与灾级预警(Winter Storm Warning 等)具备法律效力;AirNow 隶属 EPA,AQI 数据用于公共健康决策。
2. 精细化数据:冬季风暴提供结构化的积雪英寸数区间,而非模糊的"大雪"描述;警报采用 severity/urgency/certainty 三维权重排序,极端事件优先置顶。

3. 智能降级:非美国坐标自动 fallback 至 wttr.in,避免服务中断;地理位置解析与坐标反编封装在脚本内,用户仅需输入城市名。

4. 可扩展性:环境变量支持 AIRNOW_API_KEY,可提升 AQI 接口速率与稳定性;配置持久化至 OpenClaw 配置文件,无需重复设置。

局限与风险

  • 地理限制:NWS API 仅限美国领土(含领海),加拿大及全球地区降级后失去积雪量结构数据与官方警报,精度显著下降。
  • 网络依赖:所有数据需实时拉取,无离线缓存;NWS 与 AirNow 均存在速率限制,高频调用可能触发 429 错误。
  • 航空与火险免责声明:TAF 与火险数据明确标注"信息参考,决策须以官方渠道为准",不可用于飞行计划或疏散指令。
  • 时间精度:小时级预报依赖 NWS 网格数据更新频率(约 1 小时),极端天气下实际变化可能快于预报。

适合人群

美国居民/旅行者、户外运动员(滑雪、登山、马拉松)、空气质量敏感群体(哮喘患者、老年人)、物流与农业从业者需精确降水/积雪量预测者,以及需要集成官方灾级警报的自动化工作流。

常规风险

  • 隐私:地理位置查询发送至 NWS 地理编码服务与 wttr.in,IP 与查询坐标可能被记录;建议避免输入精确街道地址。
  • API 密钥管理:AIRNOW_API_KEY 以明文环境变量或 JSON 配置存储,共享主机或容器镜像可能泄露;建议采用密钥管理服务或只读权限文件。
  • 误判风险:自动模式切换基于正则表达式匹配时间关键词,复杂句式("下周三晚上 8 点的昨天")可能误触发小时模式或解析失败。

Weather NWS 内容

scripts文件夹
手动下载zip · 18.7 kB
get_weather.pytext/plain
请选择文件