{"skill":{"slug":"knowair-weather","displayName":"KnowAir Weather 明气天气","summary":"Get comprehensive air quality forecast from monitoring stations with up to 15-day coverage via the Caiyun Weather API. Returns AQI, PM2.5, PM10, O3, NO2, SO2...","description":"---\nname: knowair-air-quality\ndescription: Get comprehensive air quality forecast from monitoring stations with up to 15-day coverage via the Caiyun Weather API. Returns AQI, PM2.5, PM10, O3, NO2, SO2, CO values with trend analysis, best/worst periods, and health recommendations. Use when the user asks about air quality, AQI, PM2.5, pollution forecast, smog, air pollution, or is it safe to exercise outdoors.\nlicense: MIT-0\ncompatibility: Requires python3 and internet access.\nargument-hint: \"For example: check air quality at 116.3176,39.9760, or air quality forecast for Shanghai\"\nallowed-tools: [\"Bash(python3:*)\", \"Read\"]\nmetadata:\n  openclaw:\n    emoji: \"💨\"\n    primaryEnv: CAIYUN_TOKEN\n    requires:\n      env:\n        - CAIYUN_TOKEN\n      bins:\n        - python3\n---\n\n# KnowAir Air Quality — Station-Based AQI Forecast\n\nQuery comprehensive air quality forecasts from monitoring stations with up to 15-day coverage using the Caiyun Weather API.\n\n## Prerequisites\n\n1. A valid Caiyun Weather API token set as `CAIYUN_TOKEN` environment variable, or stored in `~/.config/knowair/token`.\n2. Coordinates (longitude, latitude) for the target location.\n\n## Quick Start\n\n```bash\npython3 scripts/query_air_quality.py --lng 116.3176 --lat 39.9760\n```\n\n## Workflow\n\n1. **Resolve coordinates** — convert city name to coordinates if needed.\n2. **Run the script**:\n   ```bash\n   python3 scripts/query_air_quality.py --lng <LNG> --lat <LAT>\n   ```\n3. **Present results** — summarize current AQI level, pollutant trends, best/worst periods, and health advice.\n\n### Options\n\n| Flag | Description | Default |\n|------|-------------|---------|\n| `--lng` | Longitude (-180 to 180) | Required |\n| `--lat` | Latitude (-90 to 90) | Required |\n| `--hours` | Forecast hours (1-360) | `120` |\n| `--detail-level` | Display density 0-6 (0=auto) | `0` |\n| `--lang` | Output language: `en` or `zh` | `en` |\n\n## Defaults\n\n- Hours: 120 (5 days)\n- Detail level: auto (0)\n- Language: `en`\n\n## Failure Handling\n\n- Missing token → exit code 2 with setup instructions.\n- API error → exit code 1 with error details.\n- Station data unavailable → falls back to API forecast data.\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":525,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1773323764438,"updatedAt":1778491857969},"latestVersion":{"version":"1.0.0","createdAt":1773323764438,"changelog":"Initial release of KnowAir Air Quality — station-based AQI forecast:\n\n- Provides comprehensive air quality forecasts (up to 15 days) via Caiyun Weather API.\n- Returns AQI, PM2.5, PM10, O3, NO2, SO2, CO values with trend analysis, best/worst periods, and health advice.\n- Supports both coordinates and city names for location lookup.\n- Customizable forecast duration, detail level, and language output.\n- Handles missing API tokens and data fallback scenarios gracefully.","license":"MIT-0"},"metadata":{"setup":[{"key":"CAIYUN_TOKEN","required":true}],"os":null,"systems":null},"owner":{"handle":"shuowang-ai","userId":"s177frh4z9ys46vct8w16bwxwn885gtc","displayName":"Shuo Wang","image":"https://avatars.githubusercontent.com/u/16516703?v=4"},"moderation":null}