> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentkey.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Weather

> Current conditions, forecasts, air quality, alerts, astronomy and typhoon tracks.

The **Weather** category gives an agent current conditions and forecasts for
any coordinate or named place, plus the data around them — minute-level
precipitation, official alerts, air quality, sunrise / moon phase, tides, solar
radiation, historical weather and typhoon tracking.

## Explore

> **[Forecasts](/capabilities/weather/forecasts)**
>
> Current conditions, hourly and daily forecasts, minute-level rain, indices.

> **[Air quality](/capabilities/weather/air-quality)**
>
> Current and forecast AQI, monitoring stations.

> **[Severe weather](/capabilities/weather/severe-weather)**
>
> Alerts, storms and typhoon tracks.

> **[Astronomy and tides](/capabilities/weather/astronomy-and-tides)**
>
> Sun and moon times, solar elevation, tides, solar radiation.

> **[Location lookup](/capabilities/weather/location-lookup)**
>
> City and POI search, the ids forecasts take.

## Providers

| Provider | Coverage |
| - | - |
| **QWeather** | Real-time weather, hourly and daily forecasts, grid (lat / lon) weather now, hourly and daily; minute-level precipitation; current weather alerts; weather indices; historical weather; air quality now, hourly and daily plus monitoring-station data; sunrise / sunset, moonrise / moonset and phase, solar elevation angle; ocean tides; solar radiation forecast; typhoon list, forecast and track; geo lookups — city search, POI search and range search, top cities |

QWeather tools expect a location id or coordinates — resolve a place name with
`QWeather/getGeoCitylookup` first. The per-call cost is shown by `describe_tool`.

> [!NOTE]
>
> **Building with code?** Developers and enterprise integrations can call this
> category through [Scenario Methods](/api-reference/scenario/overview): fixed
> REST contracts with a stable schema, a fixed price and automatic provider
> failover. The methods are listed by platform in the API Reference sidebar.

## Browse the catalog

```text theme={null}
find_tools(prefix="weather")
find_tools(q="hourly rain forecast for Shenzhen tomorrow")
describe_tool("QWeather/getWeatherHourlyForecast")
execute_tool("QWeather/getWeatherHourlyForecast", { ...params })   # copy describe_tool's execute_as
```

> [!TIP]
>
> QWeather tool summaries are in Chinese; `find_tools(q=...)` matches them in
> either language. For local POIs and place descriptions outside a weather
> context, see the Brave and Serper tools in [Search](/capabilities/search).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.