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.
Übersicht
Abschnitt betitelt „Übersicht“| 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 |
llms.txt
Abschnitt betitelt „llms.txt“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
Markdown-Fassungen
Abschnitt betitelt „Markdown-Fassungen“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">.
Endpunktverzeichnis
Abschnitt betitelt „Endpunktverzeichnis“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.
API-Katalog
Abschnitt betitelt „API-Katalog“/.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.
Verweise im Seitenkopf
Abschnitt betitelt „Verweise im Seitenkopf“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 und Sitemaps
Abschnitt betitelt „robots.txt und Sitemaps“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 |
Strukturierte Daten
Abschnitt betitelt „Strukturierte Daten“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.
MCP Registry
Abschnitt betitelt „MCP Registry“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.