Daten für Chatbots und Agenten
Bonner Haushalt mit KI-Assistenten nutzen
KI-Assistenten können die Zahlen dieser Website direkt abrufen. Dann antworten sie mit Jahr, Status und Quelle, statt Zahlen aus dem Gedächtnis zu raten. Für einen einzelnen Chat hängen Sie die Dateien an. Agenten wie Claude Code lernen den Zugang einmal als Skill und nutzen ihn danach von selbst.
Anmeldung erforderlich
Die Website ist zurzeit passwortgeschützt. Das gilt auch für die Daten, die KI-Assistenten abrufen: API, llms.txt und Skill. Ihr Browser ist bereits angemeldet, ein Agent braucht die Zugangsdaten selbst.
- Verfahren
- HTTP Basic Auth
- Benutzername
secret- Passwort
password
Skill, Installationstext und Befehle auf dieser Seite enthalten die Anmeldung bereits. Mit curl lautet sie -u secret:password. Ohne Anmeldung antwortet der Server mit „401 Unauthorized“. Bitte geben Sie die Zugangsdaten nicht öffentlich weiter.
Im Chat: Dateien anhängen
Chatbots wie ChatGPT, Claude, Gemini oder Perplexity können sich beim Lesen von Webseiten nicht anmelden. Solange die Website passwortgeschützt ist, laden Sie die Daten deshalb selbst herunter und hängen sie an den Chat an: llms.txt erklärt Regeln und Aufbau, die Zahlen stehen in den JSON-Dateien, zum Beispiel 1-05.json für Soziale Leistungen. Welche Datei zu welchem Thema gehört, steht in aufgaben.json und kennzahlen.json. Kopieren Sie dann den folgenden Text in den Chat und ersetzen Sie die Frage durch Ihre eigene.
Lies die angehängten Dateien llms.txt und 1-05.json und beantworte nur mit diesen Daten: Was wurde 2025 in Bonn für Sozialhilfe ausgegeben? Nenne zu jeder Zahl Jahr, Status und Quelle.
Als Skill: dauerhaft für Agenten
Ein Skill ist eine Textdatei namens SKILL.md, die ein Agent dauerhaft speichert. Oben steht eine kurze Beschreibung. Daran erkennt der Agent, wann der Skill passt, und liest erst dann den Rest. Das offene Format stammt von agentskills.io und wird von mehreren Agenten unterstützt.
Unser Skill enthält:
- Regeln: Jahr, Status und Quelle immer nennen; Plan, Ist, Entwurf und Prognose nie addieren; Ergebnisrechnung, Finanzrechnung und Bilanz nicht verrechnen.
- Adressen und Aufbau der JSON-Schnittstelle (API) samt Zugangsdaten für die Anmeldung.
- Einen Katalog aller Aufgabenbereiche und Kennzahlen.
Er enthält keine Beträge und keine Skripte. Die Zahlen lädt der Agent bei jeder Frage neu, eine installierte Kopie veraltet also nicht. Kommen neue Jahre hinzu, findet der Agent sie in der API.
Skill installieren
Claude Code: Agent installiert selbst
Kopieren Sie diesen Text in Claude Code oder einen anderen Agenten mit Zugriff auf Ihre Dateien. Er enthält die Anmeldung. Der Agent zeigt vor dem Speichern, was die Datei enthält.
Installiere den Skill von https://www.was-kostet-bonn.de/skills/was-kostet-bonn/SKILL.md. Die Website ist passwortgeschützt (HTTP Basic Auth, Benutzername secret, Passwort password), lade die Datei also mit Anmeldung (bei curl mit der Option -u). Speichere sie unverändert als was-kostet-bonn/SKILL.md in deinem Ordner für Skills (bei Claude Code ~/.claude/skills/). Zeige mir vorher kurz, was sie enthält.
Claude Code: von Hand im Terminal
Für alle Projekte im Ordner ~/.claude/skills/, nur für ein Projekt in .claude/skills/ im Projektordner:
mkdir -p ~/.claude/skills/was-kostet-bonn && curl -fsS -u secret:password -o ~/.claude/skills/was-kostet-bonn/SKILL.md https://www.was-kostet-bonn.de/skills/was-kostet-bonn/SKILL.md
Claude Code erkennt den Skill in der nächsten Sitzung. Mit /skills sehen Sie, ob er geladen ist.
Claude-App und claude.ai
- SKILL.md herunterladen.
- Einen Ordner
was-kostet-bonnanlegen, die Datei hineinlegen und den Ordner als ZIP-Datei packen. - In den Einstellungen unter „Fähigkeiten“ bei „Skills“ die ZIP-Datei hochladen. Die Bezeichnungen können sich je nach Version unterscheiden.
Die Zahlen lädt Claude dort per Codeausführung mit der Anmeldung aus dem Skill. Das klappt nur, wenn die Codeausführung ins Internet darf und die Domain www.was-kostet-bonn.de erreichen kann. Sonst bleibt der Weg über angehängte Dateien wie im Chat.
Andere Agenten
Codex, Cursor, Gemini CLI und weitere Agenten lesen dasselbe Format aus einem eigenen Skill-Ordner. Die Datei bleibt gleich: Ordner was-kostet-bonn, darin SKILL.md. Welcher Ordner gilt, steht in der Anleitung des jeweiligen Agenten. Einfacher ist der Installationstext oben: Der Agent kennt seinen Ordner selbst.
Beispiele: So läuft ein Gespräch
Gekürzte Gespräche mit einem Agenten, der den Skill installiert hat. Die Zahlen stammen aus den aktuellen Daten dieser Website. Die grauen Zeilen zeigen, welche Dateien der Agent abruft.
KI-Assistenten können sich trotzdem irren. Prüfen Sie wichtige Zahlen über die Quelle, die zu jedem Wert angegeben ist.
Dateien und Schnittstelle
- llms.txtKurzanleitung für KI-Assistenten: Regeln, Beispielfragen, Links
- SKILL.mdSkill für KI-Agenten: Regeln, Datenformat, Katalog aller Aufgaben und Kennzahlen
- API-Einstieg (JSON)Aufgaben mit Plan-, Ist- und Entwurfswerten sowie Zeitreihen zu Ergebnis, Bilanz, Schulden und Stellen; nur mit Anmeldung
- OpenAPI-BeschreibungZum Einbinden als Aktion in eigene Assistenten, etwa einen GPT in ChatGPT; Anmeldung als HTTP Basic Auth hinterlegen
Tabellen zum Herunterladen und alle Originalquellen stehen unter Daten und Quellen.