UGC VZ für Developer & KI-Agenten

REST-API (OpenAPI 3.1)

Spezifikation: /openapi.json — fünf Operationen: searchCreators, getCreator, requestOutreach, getOutreachStatus, getVocab. Fehler kommen als RFC 7807 (application/problem+json) mit Fehlercode und Lösungshinweis.

curl -X POST https://ugc-vz.de/api/v1/creators/search \
  -H "Content-Type: application/json" \
  -d '{"query":"Beauty-Creatorin in Berlin für TikTok-Produktvideo","max_results":5}'

Wichtig: POST /api/v1/outreach löst eine echte Kontaktanfrage mit E-Mail-Versand aus — kein Test-Endpunkt.

MCP-Server (Claude, ChatGPT & Co.)

Streamable-HTTP-Endpunkt: https://ugc-vz.de/api/mcp — Manifest unter /.well-known/mcp.json, Tool-Schemas unter /api/agent-schemas/<tool>.json.

// Claude Code
claude mcp add --transport http ugc-vz https://ugc-vz.de/api/mcp

// Claude Desktop / andere MCP-Clients (mcp-remote als stdio-Brücke)
{ "mcpServers": { "ugc-vz": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://ugc-vz.de/api/mcp"] } } }

5 Tools: search_creators, get_creator, request_outreach, get_outreach_status, get_vocab. Suchergebnisse enthalten niemals private Kontaktdaten.

Gelistet im offiziellen MCP-Registry (de.ugc-vz/creator-search), auf Glama und auf Smithery. Quellcode-Doku: github.com/ugcvz/ugc-vz-mcp.

Fuer stdio-only-Clients (z. B. Claude Desktop) gibt es die Bridge auch als npm-Paket: ugc-vz-mcp — npx -y ugc-vz-mcp.

WebMCP — Site-Tools direkt im Browser

Die Website selbst registriert 7 Tools über document.modelContext (ChatGPT Site-Tools) bzw. navigator.modelContext (W3C-Proposal, Chromium-Prototyp): search_creators, get_creator, select_creators, get_last_outreach, get_human_selection, get_outreach_status, get_vocab. Der Agent sucht und markiert Treffer direkt in der Seiten-UI, und er liest, welche Cards der Mensch selbst angeklickt hat — Mensch und Agent arbeiten auf demselben Bildschirm in beide Richtungen.

Human-in-the-loop by design: ein request_outreach-Tool gibt es im Browser bewusst nicht. Die Kontaktanfrage (echter E-Mail-Versand) sendet immer der Mensch selbst über das Formular; danach liefert get_last_outreach die request_id zum Status-Tracking an den Agenten zurück.

Ausprobieren: ugc-vz.de im Browser der ChatGPT-Desktop-App öffnen oder in Chrome 149+ mit chrome://flags/#enable-webmcp-testing — die Adressleiste zeigt „Site tools“ an. Namen, Beschreibungen und Schemas stammen aus derselben Registry wie MCP-Server, REST-API und A2A.

A2A & weitere Discovery-Endpunkte

• /.well-known/agent-card.json — A2A v1.0 Agent Card (Endpunkt: /a2a)
• /.well-known/ucp — Universal-Commerce-Protocol-Manifest
• /llms.txt — Inhaltsverzeichnis für Sprachmodelle inkl. „Wann UGC VZ nutzen“
• /sitemap.xml — vollständige Seitenliste

Zentrale Seiten liefern auf Accept: text/markdown eine Markdown-Variante (Content-Negotiation nach acceptmarkdown.com).

Fehler, Limits & Verhalten

• Fehlerformat: RFC 7807 application/problem+json mit code, detail und resolution; unbekannte /api/*-Pfade antworten strukturiert mit 404.
• Rate-Limits: IP-basiert; Suche zählt mehrfach. Bei 429 den Retry-After-Header beachten. Höhere Limits über Web Bot Auth-Signaturen.
• Datenschutz: Öffentliche Endpunkte geben niemals private Kontaktdaten zurück. Kontaktdaten erhält die Brand erst nach bewusster Anfrage per E-Mail.
• Kosten: Suche, Profile und Vermittlung sind kostenlos, keine Provision.
• Versionierung & Deprecation: URL-Versionierung (/api/v1). Abkündigungen kündigen wir mindestens 6 Monate vorher an — per Deprecation- und Sunset-Header auf den betroffenen Endpunkten und hier auf dieser Seite.