qweather — Weather Query Skill

Query real-time weather, forecasts, and life indices via QWeather (和风天气) API.

Quick Start

1. Ensure QWEATHER_API_KEY and QWEATHER_API_HOST are set (get both at https://console.qweather.com).
2. Run bun scripts/weather.ts --help in this skill directory.
3. Pick the matching command from references/command-map.md.

Workflow

1. If the user provides a city name (e.g. "北京", "Shanghai"), first run lookup to get the LocationID.
2. Use the LocationID to call now, forecast, or indices.
3. Return the result in natural language.

Common City Mapping

When the user provides a city name, use the lookup command to resolve it to a LocationID. Common examples:

• 北京 → 101010100
• 上海 → 101020100
• 广州 → 101280101
• 深圳 → 101280601

Always use lookup for unfamiliar city names to get the correct LocationID.

Notes

• This skill is script-first and does not run an MCP server.
• Requires QWEATHER_API_KEY and QWEATHER_API_HOST environment variables.
• API host is per-developer, find yours at https://console.qweather.com/setting
• Data updated every 10-20 minutes for real-time weather.