# China Weather Desk

> Live current weather and 7-day forecasts for Chinese cities, designed for international travelers and agentic browsers.

China Weather Desk is a static, free-to-use weather application. It searches Chinese cities by English name or pinyin, resolves city matches through Open-Meteo Geocoding, and displays current conditions plus a 7-day forecast from Open-Meteo Forecast. The home page also includes original traveler guidance, regional weather notes, data-source transparency, and an FAQ so crawlers and users can read useful publisher content without relying only on interactive API output.

The page also displays lightweight public access statistics for site views, visitors, and current page views through Busuanzi.

## Primary Pages

- [Human web app](/): Interactive weather search UI.
- [Markdown app description](/index.md): Agent-readable summary of this page.
- [AI structured data](/.well-known/ai-data.json): JSON description of capabilities, query parameters, browser tool, data sources, and related resources.
- [Weather response schema](/weather-response.schema.json): JSON Schema for structured browser-tool weather responses.
- [Agent Skills index](/.well-known/agent-skills/index.json): Discoverable skill definition for weather lookup.
- [API catalog](/.well-known/api-catalog): Linkset describing the public upstream APIs used by this app.
- [ads.txt](/ads.txt): Authorized digital sellers record for AdSense.

## Query Interface

The app accepts these URL parameters:

- `city`: Chinese city name in English or pinyin. Examples: `Beijing`, `Shanghai`, `Guangzhou`, `Shenzhen`, `Xi'an`.
- `unit`: `celsius` or `fahrenheit`. Defaults to `celsius`.

Example:

```text
/?city=Shanghai&unit=fahrenheit
```

## Human Content Sections

- `#china-weather-guide`: Practical interpretation of current and 7-day weather for travelers.
- `#regional-notes`: Regional China weather patterns for north, east coast, south, southwest, and central cities.
- `#methodology`: Data-source and privacy transparency.
- `#faq`: Search, apparent temperature, and data-storage questions.

## Browser Tool

When a browser supports WebMCP, the app registers a read-only tool named `get_china_city_weather`.

Input schema:

```json
{
  "type": "object",
  "properties": {
    "city": { "type": "string" },
    "unit": { "type": "string", "enum": ["celsius", "fahrenheit"] }
  },
  "required": ["city"]
}
```

## Data Sources

- [Open-Meteo Forecast API](https://open-meteo.com/en/docs)
- [Open-Meteo Geocoding API](https://open-meteo.com/en/docs/geocoding-api)
- [Busuanzi visitor counter](https://busuanzi.ibruce.info/)

## Limits

- No user accounts.
- No paid checkout.
- No first-party API key is required.
- No first-party MCP server is provided.
- Forecasts depend on Open-Meteo API availability.
- Access statistics depend on Busuanzi availability.