| name | qweather |
| description | 天气查询 — 实时天气、天气预报、生活指数、城市搜索。数据源为和风天气 (QWeather)。 触发词: 天气, 气温, 下雨, 预报, weather, forecast, 穿什么, 洗车, 紫外线, UV, 空气, 今天天气, 明天天气, 北京天气, 或任何 "[城市] 天气" 格式的输入。
|
qweather — Weather Query Skill
Query real-time weather, forecasts, and life indices via QWeather (和风天气) API.
Quick Start
- Ensure
QWEATHER_API_KEY and QWEATHER_API_HOST are set (get both at https://console.qweather.com).
- Run
bun scripts/weather.ts --help in this skill directory.
- Pick the matching command from
references/command-map.md.
Workflow
- If the user provides a city name (e.g. "北京", "Shanghai"), first run
lookup to get the LocationID.
- Use the LocationID to call
now, forecast, or indices.
- 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.
