QWeather City Weather

---

name: qweather-city-weather description: Query QWeather city codes and real-time weather with bundled executable scripts. Use when users need to resolve city names to QWeather location IDs/adcodes, fetch current weather, or run portable weather queries on machines that do not host the original app.

---

qweather-city-weather

Use this skill primarily via the bundled script:

scripts/qweather_query.py

This makes the skill portable across machines and independent from a local Next.js service.

Prerequisites

Python 3.10+ available

Required QWeather API key:

- set QWEATHER_API_KEY, or - pass --api-key

Required QWeather API host:

- set QWEATHER_API_HOST, or - pass --api-host

Default execution flow

1. Search city candidates and get location IDs:

python3 scripts/qweather_query.py search-city --query "Hangzhou" --api-host "" --api-key ""

2. Pick best city by id/name/adm1/adm2.

3. Query current weather with location ID:

python3 scripts/qweather_query.py get-weather --location "101210101" --api-host "" --api-key ""

4. Or run one-shot city -> weather:

python3 scripts/qweather_query.py city-weather --query "Hangzhou" --api-host "" --api-key ""

Script command reference

search-city

- required: --query - optional: --number (default 10)

get-weather

- required: --location

city-weather

- required: --query - optional: --preferred-name for exact city-name match

Global options for all subcommands:

--api-key

--api-host

--timeout (seconds, default 5.0)

Output and error contract

Success: JSON with success: true

Failure: JSON with success: false + error, process exits non-zero

Never guess city when no result; return explicit no-match failure

Direct API reference

For endpoint and payload details of the official QWeather API, read:

references/qweather-http-contract.md

Python 3.10+ available

Required QWeather API key:

- set QWEATHER_API_KEY, or - pass --api-key

Required QWeather API host:

- set QWEATHER_API_HOST, or - pass --api-host