# Webharu CMS Developer Documentation (Beta)

> Webharu CMS is a Japanese-first, AI-optimized headless CMS operated by Web春 Inc.
> It exposes a REST API and a remote MCP server for creating, publishing and managing
> articles. Publishing triggers the site's build & deploy automatically (Git-connected sites).

API keys: issued by the site owner at https://cms.webharu.com/my/ ("AIツール連携（APIキー）", up to 5 per site, shown once)

Base URL: https://cms.webharu.com
REST API: /api/ext/v1  (Bearer auth with per-site API key `whk_...`)
MCP:      /mcp         (Streamable HTTP, stateless, same Bearer key)

## Docs

- [Full documentation for AI agents](https://cms.webharu.com/docs/llms-full.txt): complete API + MCP reference with examples. Read this file to integrate.
- [Human-readable docs](https://cms.webharu.com/docs/): same content as HTML.

## Key facts

- Content type: posts (fields: id, slug, title, body_md, body_html, excerpt, cover_image, category, status, collection, publish_at, published_at)
- body_md (Markdown) is the source of truth; body_html is generated server-side if omitted
- status: draft (default, safe) / published (live, auto-deploys) / scheduled (requires publish_at, ISO 8601)
- Post lookup accepts either id or slug
- Rate limit: 120 requests/min per API key; errors are `{ "error": "message" }` with 400/401/404/409/429
- MCP tools: get_site_info, list_posts, get_post, create_post, update_post, delete_post, list_categories, upload_image_from_url
- MCP setup (Claude Code): `claude mcp add --transport http webharu-cms https://cms.webharu.com/mcp --header "Authorization: Bearer whk_..."`