CLI-Harness für deutschen ÖPNV - Verkehrsdaten als Agenten-Werkzeuge
Die ImTakt-CLI verbindet Cursor, Claude und Codex mit strukturierten Verkehrsdaten. Fünf Befehle: find, plan, show, status, follow.
Ein Reise-Agent in Cursor oder Claude braucht keine Webseite - er braucht Werkzeuge mit klaren Schemas: Namen, Argumente und strukturierte Antwort. Für ÖPNV und Bahn in Deutschland heißt das: Haltestelle auflösen, Fahrt planen, Abfahrtstafel lesen und Zuglauf verfolgen - ohne bahn.de zu scrapen.
Warum Scraping und generische APIs scheitern
- bahn.de liefert HTML - Agenten parsen fragil und verletzen oft Nutzungsbedingungen
- Google Directions deckt den deutschen ÖPNV nicht vollständig ab und liefert keine GTFS-Stop-ID
- HAFAS/vendo bietet umfangreiche Auskünfte, unterliegt aber eigenen Nutzungsbedingungen und bringt keine Agenten-CLI mit
Die fünf ImTakt-Werkzeuge
@imtakt/cli stellt fünf klar abgegrenzte Werkzeuge bereit. Die Antworten enthalten strukturierte Felder für die Weiterverarbeitung und können im Chat lesbar zusammengefasst werden.
imtakt find
Eingabe: Ortsname („Köln Hbf“), Koordinate oder EVA-Nummer. Ausgabe: kanonische GTFS-ID, Koordinaten, erkannte Aliase. Grundlage für jede weitere Abfrage.
imtakt plan → imtakt show
Zuerst `plan --view board`: kompakte Optionen mit connectionScore und arriveSlackMinutes, noch ohne vollständige Abschnitte. Danach lädt `imtakt show <optionId>` nur für die gewählte Option Legs, Gleise und Anschlussrisiken. Für Pendelziele ist eine Ankunftszeit mit Suchfenster besser als wiederholtes Polling.
imtakt status und imtakt follow
`imtakt status` liefert aktuelle Abfahrten an einem Ort. `imtakt follow` zeigt den vollständigen Lauf eines Zuges per runId.
Gehostet oder selbst betrieben
Standard: npx -y @imtakt/cli verbindet sich mit api.imtakt.dev, ohne zusätzliche Umgebungsvariablen. Für Datenschutzanforderungen oder Offline-Szenarien kontaktiere ImTakt.
Cursor CLI einrichten - Schritt-für-Schritt mit CLI-Befehl und ersten Prompts.
Der aktuelle Agenten-Pfad
Agenten mit Shell verwenden npx -y @imtakt/cli@latest. Die fünf Verben find, plan, show, status und follow decken Ortsauflösung, dünne Verbindungsoptionen, den ausgewählten Vollplan, Abfahrten und Zugläufe ab. Cursor, Claude und Codex können zusätzlich die ImTakt-Skill laden. Für den öffentlichen Einstieg sind kein Konto, kein Connector und kein API-Schlüssel nötig.
Für Agenten - Prompt, Skill und den empfohlenen CLI-Ablauf öffnen.
Häufige Fragen
Wie verbindet ein Agent ImTakt?
npx -y @imtakt/cli (fünf Verben) gegen api.imtakt.dev. Kein offizieller DB-Dienst; Daten aus offenen Feeds.
Welche Clients funktionieren mit ImTakt?
Jeder Agent mit Shell: Cursor, Claude Code oder Codex. Skill: imtakt.dev/agents/SKILL.md.
Brauche ich einen API-Key?
Nein. Für den gehosteten Dienst brauchst du keinen API-Key. Das Limit liegt bei 300 Anfragen pro Minute und IP; die Details stehen unter imtakt.dev/nutzungsbedingungen.
Kann die CLI auch Bus und Tram?
Ja - de_full ist multimodal. Eine Verbindung kann zum Beispiel den Bus zum Bahnhof und anschließend den ICE enthalten.
Weiterlesen
ImTakt direkt auf der Startseite ausprobieren oder den Agenten-Skill einrichten.