KnowAir Historical 明气历史天气
Get historical weather data up to 72 hours back via the Caiyun Weather API. Returns past temperature, weather conditions, precipitation, wind, humidity, apparent temperature, and air quality at regular intervals. Use when the user asks about past weather, yesterday's weather, what was the temperature earlier, recent weather history, or weather data from the past few hours/days.
KnowAir Historical — Past Weather Data
Query historical weather data for up to 72 hours back using the Caiyun Weather API.
Prerequisites
- A valid Caiyun Weather API token set as
CAIYUN_TOKENenvironment variable, or stored in~/.config/knowair/token. - Coordinates (longitude, latitude) for the target location.
Quick Start
python3 scripts/query_historical.py --lng 116.3176 --lat 39.9760 --hours 24
Workflow
- Resolve coordinates — convert city name to coordinates if needed.
- Run the script:
bash python3 scripts/query_historical.py --lng <LNG> --lat <LAT> --hours <HOURS> - Present results — summarize temperature range, weather changes, and notable events in the past period.
Options
| Flag | Description | Default |
|---|---|---|
--lng | Longitude (-180 to 180) | Required |
--lat | Latitude (-90 to 90) | Required |
--hours | Hours to look back (1-72) | 24 |
--lang | Output language: en or zh | en |
Defaults
- Hours back: 24
- Language:
en
Failure Handling
- Missing token → exit code 2 with setup instructions.
- API error → exit code 1 with error details.
Related skills
- Downloads
- Security audit
- Pass
- Last updated
- 6mo ago
- Current version
- v1.0.0
- License
- MIT-0
