API & Agent Dokumentation

1. HTTP REST API

POST /api/scan

Startet einen Scan für eine gegebene URL und liefert den Vergleich zwischen Menschen- und Crawler-Ansicht.

curl -X POST https://metoz.de/api/scan \
  -H "Content-Type: application/json" \
  -d '{"url": "https://bundestag.de"}'

GET /api/health

Gibt den Systemstatus zurück.

2. Produktionsbetrieb

Die API ist seit dem 19. August 2026 auf Cloudflare Workers Paid live. Die Menschenansicht nutzt Cloudflare Browser Run; der öffentliche EU-R2-Medienhost ist media.metoz.de.

• Kanonische API: https://metoz.de
• Health: /api/health
• LLM-Kurzdokumentation: /llms.txt
• Vollständige LLM-Dokumentation: /llms-full.txt

3. Agent Discovery Standards

metoz.de implementiert alle gängigen Standards für KI-Agenten:

• API-Katalog (RFC 9727): /.well-known/api-catalog
• OAuth Protected Resource (RFC 9728): /.well-known/oauth-protected-resource
• OAuth Authorization Server (RFC 8414): /.well-known/oauth-authorization-server
• Auth.md (Agent Registration): /auth.md
• MCP Server Card (SEP-1649): /.well-known/mcp/server-card.json
• Agent Skills Index (RFC v0.2.0): /.well-known/agent-skills/index.json
• Markdown-Verhandlung: Header Accept: text/markdown auf jeder Seite unterstützt.

4. Model Context Protocol (MCP)

Der MCP-Endpunkt unter https://metoz.de/api/mcp bietet die Tools scan_url und check_robots_ai für LLM-Clients an.