# 汉字怎么写

> A free Chinese character stroke-order learning site and API for children, parents, teachers, developers, and AI agents.

Base URL: https://wr.practice-hanzi.uk

## What This Service Provides

- Animated Chinese character stroke order pages.
- Structured REST API for how to write Chinese characters.
- Pinyin, radical, stroke count, stroke names, common words, and writing advice.
- Hanzi Writer compatible stroke path data for SVG or Canvas rendering.
- Data scope starts with the 3500 common Chinese characters used in Chinese primary education, with dictionary supplement data for additional characters.

## REST API

- `GET /api/hanzi?char=学`
  - Returns one character's pinyin, radical, stroke count, stroke names, common words, writing advice, and links.
- `GET /api/phrase?text=学习`
  - Returns per-character writing data for a Chinese word or short phrase.
- `GET /api/hanzi/学/strokes`
  - Returns Hanzi Writer compatible stroke path data.

## OpenAPI

- `https://wr.practice-hanzi.uk/openapi.json`

## MCP

The project includes an MCP server that wraps the REST API for AI agents.

Tools:

- `get_hanzi_writing`
- `get_phrase_writing`
- `get_hanzi_stroke_data`

Repository command:

```bash
npm run mcp
```

## Best Agent Use Cases

- Explain how to write a Chinese character step by step.
- Generate handwriting practice prompts for children.
- Build Chinese learning worksheets.
- Render stroke-order animation using SVG or Canvas.
- Help non-native Chinese learners understand pinyin and stroke order.