Schnittstellen

Diese Website gibt ihre Inhalte auch maschinenlesbar aus — für KI-Assistenten und Entwickler. Alles ist öffentlich, nur lesend und ohne Anmeldung.

Schnellstart

Die vier wichtigsten Abfragen:

# Übersicht für Assistenten
curl https://philippfalkenhagen.de/llms.txt

# Eine Seite als Markdown
curl -H "Accept: text/markdown" https://philippfalkenhagen.de/de/presse/

# Eine Frage stellen
curl "https://philippfalkenhagen.de/v1/ask?query=Kontakt"

# MCP: Werkzeuge auflisten
curl -X POST https://philippfalkenhagen.de/mcp -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Endpunkte

Markdown jeder Seite: Adresse plus „.md", „Accept: text/markdown" oder „?mode=agent" — /de/presse.md
llms.txt: /llms.txt · /llms-full.txt · /de/llms.txt
Suche (NLWeb): /v1/ask — GET ?query=…, POST JSON, Ereignisstrom mit streaming=true; gleichwertig unter /ask
MCP: /mcp — Streamable HTTP, Werkzeuge get_profile, get_page, search_site; Karte /mcp/server-card
OpenAPI: /openapi.json
Kataloge: /.well-known/ai-catalog.json · /.well-known/api-catalog · /.well-known/agent-skills/index.json
Hinweise für Agenten: /agents.md

Anmeldung

Keine. Es gibt keine Schlüssel, keine Konten und keine geschützten Bereiche.

Versionen

Die Suche ist unter /v1/ versioniert; /ask ist der NLWeb-Standardpfad derselben Schnittstelle. Eine inkompatible Änderung bekäme /v2/, und /v1/ bliebe mindestens sechs Monate erreichbar. Was abgelöst wird, kündigen die Antworten mit den Kopfzeilen „Deprecation" und „Sunset" an.

Fehler

Fehler kommen als JSON mit Code, Erklärung und Hinweis zur Behebung:

{
  "_meta": {
    "response_type": "failure",
    "version": "0.55"
  },
  "error": {
    "code": "missing_query",
    "message": "No question given.",
    "hint": "Add ?query=… for example /v1/ask?query=contact"
  }
}

Nutzungsrechte

Erlaubt: einzelne Seiten im Auftrag einer Person abrufen, zusammenfassen und darauf verweisen — etwa um Fragen zu beantworten oder den Kontakt herzustellen.
Nicht erlaubt: Text- und Data-Mining und das Training von KI-Modellen mit Inhalten dieser Website (Nutzungsvorbehalt nach § 44b Abs. 3 UrhG, siehe Impressum).
Die Fotografien sind urheberrechtlich geschützt. Jede Verwendung braucht die vorherige schriftliche Zustimmung.