{"openapi":"3.1.0","info":{"title":"conversion.stevebaka.de Public Agent API","version":"1.0.0","description":"Oeffentliche Endpunkte fuer Markdown, GraphRAG, Website-Audits und Conversion-Psychologie-Datasets."},"servers":[{"url":"https://conversion.stevebaka.de"}],"paths":{"/api/markdown/":{"get":{"summary":"Markdown-Version einer Inhaltsseite abrufen","parameters":[{"name":"path","in":"query","required":false,"schema":{"type":"string","default":"/"}}],"responses":{"200":{"description":"Markdown","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/api/graphrag/":{"get":{"summary":"GraphRAG-Suche ueber conversion.stevebaka.de","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":8,"minimum":1,"maximum":20}}],"responses":{"200":{"description":"GraphRAG Treffer","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/audit/":{"post":{"summary":"Website gegen die Conversion-Psychologie-Wissensbasis auditieren","description":"Crawlt eine URL plus interne Seiten, rendert DOM nach JavaScript-Hydration, erstellt Desktop/Mobile-Screenshots, bewertet Conversion-Signale und verknuepft Checks mit gerankten Evidence Paths aus Claims, Studien und Use Cases.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","examples":["https://example.com"]},"company":{"type":"string"},"industry":{"type":"string"},"email":{"type":"string","format":"email"},"crawlDepth":{"type":"integer","minimum":0,"maximum":2,"default":0}}}}}},"responses":{"200":{"description":"Deutscher Audit-Report mit Score, Crawl, Screenshots, Trace, Evals, Checks, Recommendations und Evidence Paths","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","examples":["completed_preview"]},"score":{"type":"integer","minimum":0,"maximum":100},"trace":{"type":"array","items":{"type":"object"}},"crawl":{"type":"object"},"checks":{"type":"array","items":{"type":"object"}},"recommendations":{"type":"array","items":{"type":"object"}},"evals":{"type":"array","items":{"type":"object"}},"language":{"type":"string","examples":["de-DE"]}}}}}},"400":{"description":"Ungueltige URL oder fehlerhafte Anfrage"}}}},"/api/audit/stream/":{"post":{"summary":"Audit-Agent-Schritte als NDJSON streamen","description":"Streamt agent.started, agent.step, agent.completed und agent.error Events fuer Chat UI, Traces und Debugging.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"industry":{"type":"string"},"company":{"type":"string"},"crawlDepth":{"type":"integer","minimum":0,"maximum":2,"default":1}}}}}},"responses":{"200":{"description":"NDJSON Event Stream","content":{"application/x-ndjson":{"schema":{"type":"string"}}}}}}},"/mcp/":{"get":{"summary":"MCP Server Metadata","responses":{"200":{"description":"MCP server metadata"}}},"post":{"summary":"MCP JSON-RPC endpoint","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"JSON-RPC response","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/llms.txt":{"get":{"summary":"Agent-Navigationskarte als Text","responses":{"200":{"description":"llms.txt"}}}},"/llms.json":{"get":{"summary":"Agent-Navigationskarte als JSON","responses":{"200":{"description":"llms.json"}}}},"/datasets":{"get":{"summary":"Menschlicher Dataset-Katalog","responses":{"200":{"description":"Dataset-Katalog HTML"}}}},"/datasets/catalog.json":{"get":{"summary":"Dataset-Katalog als JSON","responses":{"200":{"description":"Dataset-Katalog JSON"}}}}}}