tempest-weather

🌤️ 个人气象站数据实时获取

连接 WeatherFlow Tempest 气象站,实时获取风速、降雨量、闪电等 backyard 天气数据,助力家庭自动化气象监测。

收藏
22.1k
安装
4.5k
版本
v1.1.0
CLS 安全性认证2026-05-01
点击查看完整报告 >

使用说明

Tempest Weather 是一个专为 WeatherFlow Tempest 个人气象站用户设计的实用工具,旨在通过官方 REST API 便捷地获取实时天气数据。该技能通过 Python 脚本实现,用户只需配置 API Token 和设备 ID,即可轻松获取温度、湿度、风速、阵风、降雨量、紫外线指数、光照强度乃至闪电事件等全面的气象观测数据。

核心用法十分直观。用户可以通过环境变量或命令行参数传递认证信息,支持站点级(Station ID)和设备级(Device ID)两种查询模式,默认优先使用设备级查询。脚本支持 --units metric 参数切换公制/英制单位,也支持 --json 参数输出纯 JSON 格式以便与其他自动化工具集成。执行后,工具会返回结构化的 JSON 数据以及一段简洁的人类可读摘要,包含数据来源 URL 和时间戳,确保数据的可追溯性。

该技能的显著优点在于其极高的安全性和轻量性。代码仅依赖 Python 标准库(argparse、urllib、json 等),无需安装任何第三方 pip 包,从根本上杜绝了依赖投毒风险。代码中严格避免使用 eval、exec、system 等危险函数,所有网络请求均指向 WeatherFlow 官方域名。特别值得一提的是,脚本在记录日志时会自动将 API Token 脱敏处理为 ***redacted***,有效防止敏感信息泄露。完善的 argparse 参数验证和错误处理机制也确保了在各种边界条件下的稳定运行。

然而,用户也需注意其局限性。首先,该工具仅适用于拥有 WeatherFlow Tempest 硬件的用户,无法获取其他品牌气象站或公共气象数据。其次,它仅提供当前实况数据,不包含天气预报功能。此外,作为社区维护的非官方项目(T3 来源),虽然代码质量优秀,但长期维护支持和功能更新频率可能不及官方工具。

该技能特别适合以下群体:已安装 Tempest 气象站的家庭用户,希望将天气数据集成到智能家居系统(如 Home Assistant)的 IoT 爱好者,需要本地化精准气象数据进行科研或农业监测的专业用户,以及希望自动化获取后院天气数据的开发者。

使用时的常规风险主要包括:API Token 的安全管理(虽然脚本会脱敏,但用户仍需避免在公共仓库中硬编码 Token),对 WeatherFlow 官方 API 服务可用性的依赖,以及网络波动可能导致的数据获取延迟。建议在可信的本地或私有环境中使用,并妥善保管环境变量配置。

安全解读

核心用法

本 Skill 通过调用 WeatherFlow 官方 Tempest REST API,获取用户个人气象站的实时观测数据。支持通过 Station ID 或 Device ID 两种粒度查询,输出包含温度、湿度、气压、风速/阵风、降雨量、紫外线指数、光照强度以及闪电检测等完整气象指标。

配置依赖四个环境变量:TEMPEST_API_TOKEN(认证令牌)、TEMPEST_STATION_ID/TEMPEST_DEVICE_ID(站点或设备标识,二选一)、TEMPEST_UNITS(单位制,可选 metric/us)。运行 python3 scripts/get_tempest_weather.py 即可获取 JSON 格式的结构化数据,并附带简短人类可读摘要。

显著优点

  • 纯净依赖:仅使用 Python 标准库(urllib/json),零第三方依赖,彻底杜绝供应链攻击风险
  • 安全合规:敏感凭证通过环境变量注入,无硬编码;Token 在日志输出中自动脱敏处理
  • 官方直连:仅连接 WeatherFlow 官方域名 swd.weatherflow.com,HTTPS 加密传输,无中间人风险
  • 行为可预测:纯只读操作,无文件系统写入、无进程调用、无动态代码执行

潜在缺点与局限性

  • 硬件门槛:需用户实际拥有 WeatherFlow Tempest 气象站设备,无法提供通用天气预报
  • 地域局限:数据仅覆盖用户自有站点位置,无法替代区域气象服务
  • API 依赖:受限于 WeatherFlow 官方服务可用性及速率限制(文档未明确说明具体限额)
  • 配置复杂度:需手动获取并配置 API Token 及设备 ID,对非技术用户有一定门槛

适合人群

  • 已部署 Tempest 气象站的技术爱好者与家庭用户
  • 需要将 backyard 实时气象数据集成到自动化工作流(如智能家居灌溉、窗户自动关闭)的开发者
  • 追求数据主权、不愿依赖商业天气聚合服务的隐私敏感型用户

常规风险

  • 凭证泄露:API Token 泄露将导致他人可访问用户气象站历史数据,建议定期轮换
  • 网络中断:完全依赖云端 API,本地网络或 WeatherFlow 服务故障将导致数据获取失败
  • 数据精度:个人气象站数据受安装位置、遮挡物、校准状态影响,可能与官方气象机构存在偏差
  • 速率限制:频繁调用可能触发 API 限流,建议在文档中补充说明推荐调用频率

tempest-weather 内容

references文件夹
scripts文件夹
tests文件夹
fixtures文件夹
手动下载zip · 8.3 kB
tempest-api.mdtext/markdown
请选择文件