Entwickler & KI-Agenten

API & Agent Dokumentation

metoz.de stellt offene Schnittstellen für Menschen, Bots und KI-Agenten bereit, um die Sichtbarkeit von Websites für KI-Crawler zu überprüfen.

1. HTTP REST API

`POST /api/scan`

Startet einen Scan für eine gegebene URL und liefert Doppelansicht, robots.txt-Botgruppen, Empfehlungen, den festen Zitat-Test, transparente Teilscores und einen 30 Tage gültigen noindex-Permalink.

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

Der Zitat-Test kann unavailable oder budget_exhausted melden. Der übrige Scan bleibt verfügbar. Bei zu vielen Abrufen antwortet die API mit HTTP 429.

`POST /api/commerce`

Prüft nach robots.txt die festen Discovery-Pfade /.well-known/ucp und /.well-known/acp.json eines öffentlichen HTTPS-Ursprungs. UCP wird als veröffentlicht, die ACP-Discovery als experimenteller Entwurf eingeordnet. Die Antwort liefert je Protokoll einen der Zustände valid, invalid, not_found, blocked, redirected oder unavailable.

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

Der Check folgt keinen Weiterleitungen oder Dokument-URLs, ruft keine Commerce-API auf, speichert keinen Befund und bildet keinen Score. Ein gültiger Zustand bestätigt nur die begrenzte öffentliche Grundstruktur. Das bestehende Scan-Rate-Limit gilt auch hier.

`POST /api/report-email`

Versendet einen noch gültigen gespeicherten Scan einmalig an die angegebene E-Mail-Adresse. Der Endpunkt gehört zum freiwilligen Web-Flow, ist pro IP und Report begrenzt und fügt die Adresse keiner Empfängerliste hinzu.

`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. Freiwillig angeforderte Report-Mails werden über Epostix aus der EU versendet. Die Redaktion nutzt ein getrenntes, nicht öffentliches Payload-CMS unter /cms; dessen /cms-api-Endpunkte gehören nicht zu dieser öffentlichen API.

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
Agenten-Fähigkeiten: /.well-known/agents.txt und /agents.txt
Markdown-Verhandlung: Header Accept: text/markdown für technische und Observatoriumsseiten; redaktionelle Inhalte stehen veröffentlicht unter /llms.txt und /llms-full.txt.

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.