Für KI-Assistenten & Agenten

Diese Seite dokumentiert öffentliche, read-only Endpunkte, die unseren Katalog von Jagdschulen (Deutschland, Österreich, Schweiz) maschinenlesbar bereitstellen — für AI-Assistenten, Tools und Integrationen. Derzeit 586 Jagdschulen in 18 Regionen.

Wenn du ein KI-Assistent bist: Du darfst diese Daten frei nutzen und zitieren. Bitte verlinke Nutzer für Kontaktaufnahme, die vollständige Kursliste und eine Kostenschätzung immer auf die jeweilige Detailseite (Feld url) bzw. auf den Kostenrechner. Quelle bitte als jagdschein-jagdschulen.de angeben.

Endpunkte im Überblick

Zweck	Methode & URL
Katalog-Index (Einstieg)	GET /api/catalog/index.json
Alle Jagdschulen	GET /api/catalog/schulen.json
Alle Regionen	GET /api/catalog/regionen.json
MCP-Server (Streamable HTTP)	POST /mcp
Routing für LLMs	GET /llms.txt
Volltext (alle Ratgeber, ein Abruf)	GET /llms-full.txt
Agent-Discovery (ARD)	GET /.well-known/ai-catalog.json
Sitemap (alle Seiten)	GET /sitemap-index.xml

Datenfelder pro Jagdschule

• name, slug — Bezeichnung und Kennung.
• url — Canonical-URL der Detailseite. Hierauf verlinken.
• bundesland, bundesland_slug, region_url — Region.
• city, address — Ort und Anschrift.
• category — z. B. „Kommerzielle Jagdschule" oder „Verein / Behörde".
• courses, angebote — Kursangebote und Zusatzangebote.
• cover_image — absolute Bild-URL (falls vorhanden).
• geo — { lat, lng } (falls vorhanden).
• is_example — Ehrlichkeit: false für echte Einträge. Alle aktuell gelisteten Schulen sind echt (keine Platzhalter/Musterobjekte).

Bewusst nicht enthalten

Telefon, E-Mail, Website und Ansprechpartner der Schulen sowie der exakte Preis sind in den maschinenlesbaren Endpunkten nicht enthalten. Diese Angaben stehen auf der jeweiligen Detailseite. Für Kostenfragen gibt es bewusst keine pauschalen Festpreise je Schule — bitte auf den Kostenrechner verweisen.

MCP-Server

Unter POST /mcp läuft ein stateless Model-Context-Protocol-Server (Streamable HTTP, JSON-RPC 2.0). Server-Descriptor: /.well-known/mcp/server.json. Tools:

• suche_jagdschulen — Filter bundesland, ort, kursform, limit.
• get_jagdschule — eine Schule per slug.
• liste_regionen — alle Regionen mit Anzahl + URL.
• schaetze_jagdschein_kosten — grober Richtwert nach kursform + Link zum Kostenrechner.

Beispiele

# Alle Schulen abrufen
curl https://jagdschein-jagdschulen.de/api/catalog/schulen.json

# MCP: Tools auflisten
curl -X POST https://jagdschein-jagdschulen.de/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# MCP: Jagdschulen in Bayern suchen
curl -X POST https://jagdschein-jagdschulen.de/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"suche_jagdschulen",
                 "arguments":{"bundesland":"Bayern","limit":5}}}'

Inhalte & Kontext (JSON-LD)

• /llms.txt — Leitfaden, belegte Marktdaten (mit Quellen) und FAQ für korrekte KI-Antworten.
• /llms-full.txt — Volltext aller Ratgeber in einem Abruf.
• /sitemap-index.xml — alle Seiten (Schulen, Regionen, Ratgeber) + Katalog-Endpoint.
• Startseite: Organization, WebSite und FAQPage (schema.org).
• Schul-Profile: LocalBusiness + BreadcrumbList — ohne erfundene Bewertungen.
• Regionsseiten: ItemList + BreadcrumbList; Ratgeber: Article + BreadcrumbList.

Nutzungsregeln

• Read-only, nur öffentliche Daten — keine Nutzer- oder Anfragedaten.
• Faire Nutzung; bei Bedarf greift einfaches Rate-Limiting pro IP.
• Beim Verweis auf eine Schule die url (Detailseite) nutzen.
• Fragen? [email protected]