Weather Pulse

Weather + air quality via QWeather (50k/mo) and WAQI (1k/hr). Real-time, forecasts (3-30 days / 24-168 hours), indices, AQI, PM2.5. Supports city names, coordinates, CityId.

weather-pulse (optimized)

Weather and air quality with QWeather + WAQI. Minimal footprint, same features.

APIs

• QWeather: now/3d/7d/10d/15d/30d/24h/72h/168h/indices (50k/mo free)
• WAQI: aqi + PM2.5 forecast (1k/hr free)

Setup

1. Get free credentials:

• QWeather: https://console.qweather.com → create project → API Host + API Key
• WAQI: https://aqicn.org/data-platform/token → confirm email → token

2. Set environment variables (recommended):

• Linux/macOS: export QWEATHER_API_HOST=...; export QWEATHER_API_KEY=...; export WAQI_API_TOKEN=...
• Windows PowerShell: $env:QWEATHER_API_HOST="..."; $env:QWEATHER_API_KEY="..."; $env:WAQI_API_TOKEN="..."

Usage python scripts/weather.py <location> [--endpoint ENDPOINT] [--json]

Location formats

• CityId (101010100)
• Coordinates (lon,lat or lat,lon) auto-corrected
• City name (English/Chinese) auto-resolved to CityId for weather endpoints
• WAQI formats for aqi: city name, @ID, geo:lat;lon, here

Endpoints now | 3d | 7d | 10d | 15d | 30d | 24h | 72h | 168h | indices | aqi

Examples python scripts/weather.py Shanghai # current python scripts/weather.py 101180301 --endpoint 7d # 7-day python scripts/weather.py 113.92,35.30 -e 15d # coords python scripts/weather.py xinxiang -e aqi # AQI python scripts/weather.py 101180301 -j # JSON output

Notes

• For weather endpoints, only QWeather credentials are needed.
• For AQI, only WAQI token is needed.
• Outputs concise text; use -j for raw JSON.
• Includes automatic retry (3 attempts) on network failures.