SuperAPI AI 工具集

tempest-cli

数据与分析

查看项目

更新于 10-16 06:24

技能介绍

tempest-cli 用于查询 WeatherFlow Tempest 气象站的超本地天气数据,支持云端 REST API 与局域网 UDP 两种方式。

用途:获取当前天气状况、多日预报、历史观测,以及 Hub 的实时广播。

主要能力:current 显示当前状况;forecast 显示当前加多日预报与逐小时数据;stations 列出站点与设备;obs 查询历史观测;udp listen 实时接收观测、阵风、闪电与降水事件。支持 --json 机器可读输出,--dry-run、--quiet、--verbose 等全局标志可放在命令任意位置。

使用方式:先在 weatherflow.com 获取个人访问令牌,然后设置环境变量 export TEMPEST_TOKEN="your-token-here";若未设置,会回退读取 ~/.tempest.env。--help 与 --dry-run 无需令牌。示例:tempest-cli current --json;tempest-cli forecast --days 3;tempest-cli obs --device-id 67890 --days 7;tempest-cli udp listen --timeout 30。单站点会自动选择,并优先 ST > SKY > AIR,跳过 HB Hub。

适用场景:需要本地气象站实时或历史数据的自动化脚本与智能体调用。

限制:UDP 监听需与 Hub 处于同一局域网(端口 50222)。API 原始数据为公制单位,CLI 会转换用于显示,但 --json 输出仍为公制;时间戳为 Unix epoch 整数;预报响应中 daily 与 hourly 嵌套在 forecast 键下;直接调用 API 时需过滤 device_type HB。完整字段布局见 references/tempest-api-field-layouts.md。