API & KI-Integration

Der Ideenatlas stellt eine öffentliche, dokumentierte Schnittstelle (API) bereit. Diese ist gezielt darauf optimiert, sowohl von klassischen Applikationen als auch autonom von KI-Agenten (Large Language Models) genutzt zu werden.

1. Verfügbare Endpunkte

REST API

Die primäre Such-Schnittstelle liefert standardmäßig strukturierte JSON-Antworten, oder token-optimiertes Markdown über den '?format=md' Parameter. Sie umfasst direkte Suchtreffer, Hierarchie-Pfade innerhalb des Wissensgraphen, thematisch ähnliche Cluster sowie berechnete Serendipitäts-Verbindungen.

• Methode: POST
• JSON Endpunkt: /api/search
• Markdown Endpunkt: /api/search?format=md
• Content-Type: application/json, text/markdown
• Payload: { "query": "Die ausführliche, wissenschaftliche Suchanfrage" }

MCP (Model Context Protocol)

Neben der klassischen API wird auch ein MCP Server zur Verfügung gestellt. Dieser liefert über das 'search' Tool die Ergebnisse direkt als stark optimiertes Markdown-Dokument, was ihn extrem token-effizient für LLMs macht. Es wird keine Authentifizierung benötigt.

• Transport Type: SSE
• Endpunkt: /sse
• Authentifizierung: Keine
• Tools: search

Browsing API

Für KI-Assistenten im 'Browsing Mode' (z.B. ChatGPT Web, Claude, Perplexity), die keine POST-Requests senden können, existiert ein GET-Wrapper. Dieser führt die Vektorsuche aus und formatiert die Antwort in ein Markdown-Dokument, eingebettet in ein minimales, leicht maschinenlesbares HTML-Gerüst.

• Methode: GET
• Endpunkt: /api/search/view?q=Zu+bearbeitende+Suchanfrage,+halte+sie+spezifisch

AI Gateway (Browsing Interface)

Für KI-Agenten, die URLs nicht manuell konstruieren, jedoch mit Internetseiten interagieren dürfen, steht ein minimalistischer HTML-Einstiegspunkt bereit. Dieser enthält ein Suchformular, das zur API-Ansicht weiterleitet.

• URL: https://ideenatlas.eu/ai
• Aktion: Suchanfrage über Formular senden (Parameter 'q')

2. Agent Discovery & Spezifikationen

Um die autonome Nutzung durch KI-Systeme ohne menschliches Eingreifen zu gewährleisten, unterstützt der Ideenatlas vollumfänglich die gängigen Machine-Discovery-Standards:

• OpenAPI 3.0: Die vollständige technische Beschreibung aller Endpunkte und Schema-Definitionen der DTOs.
• llms.txt: Direkte Text-Instruktionen für LLMs zur korrekten Nutzung der Schnittstellen.
• ai-plugin.json: Metadaten für die direkte Integration als OpenAI Plugin / Custom GPT.

Direkte Links zu den Ressourcen

OpenAPI Spec (JSON): /v3/api-docs/public-search-api
Swagger UI (Interaktiv): /swagger-ui.html
LLM Instructions: /llms.txt
AI Plugin Manifest: /.well-known/ai-plugin.json

3. Fair Use Policy

Die API ist offen und erfordert derzeit keinen API-Key. Wir bitten darum, massenhaftes automatisiertes Scraping der Datenbank zu unterlassen und Rate Limits von maximal einem Request pro Sekunde einzuhalten. Eine missbräuchliche Nutzung führt zur temporären Sperrung der aufrufenden IP-Adresse.