tempest-weather

TotalClaw 作者 totalclaw

使用 Tempest REST API 从 WeatherFlow Tempest 站获取当前天气状况。当用户询问“暴风雨天气”（首选触发器），或询问后院/家庭天气、暴风雨气象站读数、来自特定气象站的风/阵风/雨/闪电或来自暴风雨数据的快速本地天气摘要时使用。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~wranglerdriver-tempest-weather

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~wranglerdriver-tempest-weather/file -o wranglerdriver-tempest-weather.md

## 概述（中文）

使用 Tempest REST API 从 WeatherFlow Tempest 站获取当前天气状况。当用户询问“暴风雨天气”（首选触发器），或询问后院/家庭天气、暴风雨气象站读数、来自特定气象站的风/阵风/雨/闪电或来自暴风雨数据的快速本地天气摘要时使用。

## 原文

# Tempest Weather

Use this skill to fetch current conditions from a Tempest station/device or retrieve historical station statistics (day/month/year) from the Tempest Stats API.

## Run the fetch script

Use:

```bash
python3 scripts/get_tempest_weather.py
```

The script reads configuration from environment variables by default, if both station and device id are set device_id is used by default:

- `TEMPEST_API_TOKEN` (required)
- `TEMPEST_STATION_ID` (optional if `TEMPEST_DEVICE_ID` is set)
- `TEMPEST_DEVICE_ID` (optional if `TEMPEST_STATION_ID` is set)
- `TEMPEST_UNITS` (optional: `metric` or `us`, default `us`)

## Useful command options

```bash
# Explicit station/token (current observations)
python3 scripts/get_tempest_weather.py --station-id 12345 --token "$TEMPEST_API_TOKEN"

# Explicit device/token (current observations)
python3 scripts/get_tempest_weather.py --device-id 67890 --token "$TEMPEST_API_TOKEN"

# Historical stats for current local day/month/year (defaults to "now")
python3 scripts/get_tempest_weather.py --stats day
python3 scripts/get_tempest_weather.py --stats month
python3 scripts/get_tempest_weather.py --stats year

# Historical stats for a specific target date period
python3 scripts/get_tempest_weather.py --stats day --date 2026-02-23
python3 scripts/get_tempest_weather.py --stats month --date 2026-02
python3 scripts/get_tempest_weather.py --stats year --date 2025

# Metric output
python3 scripts/get_tempest_weather.py --units metric

# JSON only (machine-friendly)
python3 scripts/get_tempest_weather.py --json
```

## Output behavior

- Emit concise JSON (always)
- Include a short human summary unless `--json` is used
- Include timestamp and source URL for traceability
- For `--stats`, return the matched historical row from `stats_day`, `stats_month`, or `stats_year`

## If data fetch fails

- Check token validity and station/device ID
- Retry once for transient network errors
- Return a short actionable error message

## Field mapping reference

For Tempest observation index mapping and response notes, read:

- `references/tempest-api.md`

## License

- `LICENSE` (MIT)

## Source

- https://github.com/wranglerdriver/tempest-weather