China Weather Query Service

The Problem It Solves

When a user asks, 'Is it cold outside now?' or 'Is the weekend good for camping?', a model answer based only on general knowledge can lack freshness. This skill lets AI agents query real-time weather and forecasts for Chinese cities and districts, including temperature, humidity, wind, air quality, weather alerts, and sunrise/sunset times.

How It Works

The skill uses two scripts for the main queries:
- realtime.sh: fetch current conditions, air quality, daily-life indices, and weather alerts.
- forecast.sh: fetch hourly and daily forecasts plus sunrise/sunset times; days accepts 0 through 8.

Key parameters:
- query: required; use a Chinese city, district, or area name, such as 北京, 雨花台, or 浦东新区.
- encoding: optional text, json, or markdown, used to control response density.
- Prefer markdown by default for readable output with moderate token usage.
- Use text when the user asks for a brief summary.
- Use json only when raw fields, detailed indices, or timestamps are explicitly requested, because it returns the full API payload.

Limits and Notes

• It mainly supports most Chinese cities and districts; English or pinyin location names may not work.
• If a district query fails, fall back to the city name, for example use 北京 instead of 朝阳区.
• Weather changes quickly, so check the updated timestamp in the response before relying on the data.
• Add practical context: suggest an umbrella for rain, hydration for heat, warm clothing for cold, and a mask when air quality is poor.