Zum Inhalt springen

KI-Agenten

Maschinenlesbare Seiten

Jede Website eines Betriebs auf Ski4me beschreibt sich selbst in Formen, die ein Assistent lesen kann. Der Betrieb richtet dafür nichts ein. Alle Pfade auf dieser Seite gelten auf der Domain des Betriebs, in den Beispielen skiverleih-talstation.example.

Pfad Was
/llms.txt Leistungen, Preise, Konditionen und alle Wege für Assistenten in Prosa
/<seite>.md jede Seite als Markdown
/api/ Liste der offenen Endpunkte dieser Domain
/api/agent/manifest Leistungen, Kontakt, Zeiten und Konditionen als JSON
/.well-known/api-catalog API-Katalog nach RFC 9727
/.well-known/ai-catalog.json Verweis auf die Server-Karte des MCP-Servers
/mcp/server-card Beschreibung des MCP-Servers
/api/agent/drafts/schema JSON Schema des Buchungsentwurfs
/sitemap-agents.xml Markdown-Fassungen aller Seiten und die Endpunkte
/robots.txt nennt die Zugänge und die Sitemaps

Die Datei entsteht bei jedem Abruf aus den Daten des Betriebs. Sie nennt Kontakt und Öffnungszeiten, Leistungen, die Zustellung in die Unterkunft, Preise und Konditionen aus der aktiven Preisliste und danach die Zugänge für Maschinen:

  • die offenen Endpunkte
  • den Warenkorb-Link, mit einem Beispiel aus dem eigenen Katalog
  • den MCP-Server mit seinen fünf Werkzeugen
  • den Weg, über einen Assistenten zu buchen, und was ein Assistent dabei nicht darf

Jede Seite gibt es auch als Markdown, auf zwei Wegen.

Weg Beispiel
.md an den Pfad hängen /preise.md, die Startseite als /index.md
Kopf Accept: text/markdown auf der gewöhnlichen Adresse GET /preise

Beim Kopf zählt die Gewichtung: bevorzugt eine Anfrage HTML, bekommt sie HTML. */* allein gilt nicht als Wunsch nach Markdown.

Jede Markdown-Fassung beginnt mit Angaben zur Seite: Titel, Beschreibung, die Adresse der HTML-Fassung, die Sprache und die Fassungen in anderen Sprachen. Am Ende stehen die Verweise auf Sitemap, llms.txt und die Liste der Endpunkte. Maßgeblich bleibt die HTML-Seite.

Jede HTML-Seite nennt ihre Markdown-Fassung im Kopf, als <link rel="alternate" type="text/markdown">.

GET /api/ liefert ein JSON-Dokument mit allem, was diese Domain offen anbietet.

Feld Bedeutung
endpoints[] je Endpunkt Pfad, Adresse, Methoden und Beschreibung, beim Entwurf dazu request_schema_url
mcp Adresse des MCP-Servers, Transport, Server-Karte
discovery[] llms.txt, die Sitemaps, der API-Katalog, die Server-Karte
errors die Form der Fehler und die Codes
content_negotiation wie eine Seite als Markdown kommt
languages[] Sprachen der Website mit ihrem Pfadpräfix
booking_policy was ein Assistent darf und was nicht

Die Fehler der API verweisen in documentation_url auf genau diese Adresse. Ein Assistent, der sich verlaufen hat, findet von jedem Fehler aus zurück.

/.well-known/api-catalog ist ein Linkset nach RFC 9727 mit dem Typ application/linkset+json. Es verweist auf die Liste der Endpunkte, auf den MCP-Server mit seiner Server-Karte, auf das Schema des Entwurfs und auf llms.txt.

/.well-known/ai-catalog.json nennt den MCP-Server als Eintrag mit dem Typ application/mcp-server-card+json und der Adresse der Server-Karte.

Die HTML-Seiten und ihre Markdown-Fassungen tragen einen Link-Kopf mit den Zugängen:

rel Ziel
alternate die Markdown-Fassung der Seite
service-meta /llms.txt
service-desc /api/
service-doc /.well-known/api-catalog
sitemap /sitemap-index.xml
mcp /mcp
describedby das Schema des Entwurfs

robots.txt erlaubt das Lesen der Seite und nennt die Zugänge in Kommentaren. Ausgenommen sind Warenkorb, Kasse, Bestätigung und die Seite einer Buchung in allen Sprachen, dazu die Kurzlinks. Diese Seiten gehören einem Gast und in keinen Suchindex.

Das hindert einen Assistenten nicht daran, einem Gast einen Link auf die Kasse zu geben: der Link wird weitergereicht, nicht indexiert.

Sitemap Inhalt
/sitemap-index.xml Einstieg, verweist auf die beiden anderen
/sitemap-pages.xml alle Seiten in allen Sprachen
/sitemap-agents.xml die Markdown-Fassungen und die Endpunkte

Die Seiten tragen strukturierte Daten nach schema.org: den Betrieb als Geschäft mit Adresse und Öffnungszeiten, den Katalog als Leistung mit Angeboten, Kurse, häufige Fragen und die Zustellung als eigene Leistung.

Ein Betrieb kann seinen MCP-Server in die offizielle MCP Registry eintragen lassen. Der Name folgt der Domain in umgekehrter Schreibweise mit dem Zusatz /ski-rental. Den Nachweis, dass die Domain dazugehört, liefert die Website unter /.well-known/mcp-registry-auth aus, sobald er hinterlegt ist. Das Eintragen selbst stößt der Betreiber an.