API-Dokumentation

Schnellstart

Basis-URL: https://conversion.stevebaka.de. Für maschinelle Discovery stehen OpenAPI, der Linkset-API-Katalog und auth.md bereit. Content-Signal:ai-train=yes, search=yes, ai-input=yes.

# Healthcheck
curl -s 'https://conversion.stevebaka.de/api/health'

# GraphRAG-Suche
curl -s 'https://conversion.stevebaka.de/api/graphrag/?q=Trust%20Signals%20Checkout&limit=3'

# Markdown einer Seite
curl -s -H 'Accept: text/markdown' 'https://conversion.stevebaka.de/api/markdown/?path=/konzepte/choice-overload/'

Health

Leichtgewichtiger Status-Endpunkt für Monitoring und Uptime-Checks.

curl -s 'https://conversion.stevebaka.de/api/health'

Antwort: JSON mit status, service, time (ISO-8601).

Markdown Page API

Gibt die kanonische Markdown-Version einer Wissensseite zurück — identisch zur Content-Negotiation über Accept: text/markdown.

Query-Parameter: path (Pfad mit führendem Slash, z. B. /konzepte/choice-overload/).

curl -s -H 'Accept: text/markdown' \
  'https://conversion.stevebaka.de/api/markdown/?path=/konzepte/choice-overload/'

GraphRAG API

Durchsucht zitierfähige Conversion-Psychologie-Chunks mit Graph-Kontext aus dem SurrealDB Knowledge Graph.

Query-Parameter: q (Pflicht), limit (1–20, Standard 8).

curl -s 'https://conversion.stevebaka.de/api/graphrag/?q=Pricing%20Psychology&limit=5'

Antwort: JSON mit query, resultCount und results (Chunks inkl. Score und Entity-Bezügen).

Website Conversion Audit API

Crawlt eine URL, rendert nach Hydration, erstellt Screenshots, bewertet Conversion-Signale und verknüpft Checks mit gerankten Evidence Paths.

Body (JSON): url (Pflicht), optional company, industry, email, crawlDepth (0–2).

curl -s -X POST 'https://conversion.stevebaka.de/api/audit/' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com","crawlDepth":0}'

Antwort: deutscher Report mit score, checks, recommendations, evidence paths, crawl, trace und evals.

Audit Stream API

Streamt Audit-Agent-Schritte als NDJSON für Chat-UIs, Traces und Debugging.

Events: agent.started, agent.step, agent.completed, agent.error. Content-Type: application/x-ndjson.

curl -N -X POST 'https://conversion.stevebaka.de/api/audit/stream/' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com","crawlDepth":1}'

MCP Server

JSON-RPC über POST https://conversion.stevebaka.de/mcp/ (Streamable HTTP). Metadaten: server-card.json. Authentifizierung: keine (öffentlicher Lesezugriff).

• search_knowledge

  Durchsuche conversion.stevebaka.de per GraphRAG nach zitierfähigem Conversion-Psychologie-Wissen.

• get_markdown_page

  Gibt die kanonische Markdown-Version einer Conversion-Wissensseite zurück.

• list_datasets

  Listet öffentliche Conversion-Psychologie-Datasets.

• get_dataset

  Gibt ein öffentliches Dataset zurück.

curl -s -X POST 'https://conversion.stevebaka.de/mcp/' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Discovery & Datasets

• /.well-known/openapi.json — OpenAPI 3.1 Spezifikation aller öffentlichen Endpunkte
• /.well-known/api-catalog — Linkset mit Service-Beschreibungen
• /auth.md — OAuth-Discovery, MCP und Nutzungsregeln für Agenten
• /datasets/catalog.json — JSON-Katalog aller Datasets (Claims, Studien, Konzepte, Use Cases)
• /datasets/ — Menschlicher Dataset-Index