fit-connect

Installation

Benötigt Node.js 20 oder neuer. Installiert den Befehl fit-connect:

npm i -g @maschinenlesbar.org/fit-connect-cli

Zugang

Kein Konto, kein API-Schlüssel, keine Konfiguration – installieren und loslegen.

Schnellstart

# 1. Resolve a place to an area id
fit-connect areas Hanau

# 2. Route a service key into that area to find the responsible authority
#    (99123456760610 is an illustrative key with no registered destinations,
#     so these examples return an empty `routes: []` — that is normal, see below)
fit-connect routes 99123456760610 --area-id 940

# Already have the official codes? Skip step 1 (here: Erfurt, by Regionalschlüssel):
fit-connect routes 99123456760610 --ars 160510000000

Befehle

Die Beschreibungen der Befehle stammen direkt aus der CLI und sind englisch.

• routes

  Find the responsible authority (Zustellpunkt) for a public service in an area. Provide exactly one area selector: --ags, --ars or --area-id.

• areas

  Search areas by name and/or postal code. Supports the `*` wildcard, e.g. `areas "Mag*"`. Terms are split into words on spaces and punctuation, and every word must match the same area. Use a result's id as --area-id for `fit-connect routes`.

• info

  Show the version of the deployed Routing API instance

Alle Befehle, Argumente und Optionen →

Skills für Claude Code

Das Plugin fit-connect bringt Claude bei, fit-connect zu nutzen. Installation über den Marketplace von maschinenlesbar.org:

/plugin marketplace add maschinenlesbar-org/plugins
/plugin install fit-connect@maschinenlesbar

• /fit-connect:fit-connect-area-lookup
• /fit-connect:fit-connect-find-authority
• /fit-connect:fit-connect-service-briefing

Was die Skills beantworten, mit echten Beispielen → Beschreibungen und Voraussetzungen der Skills →

TypeScript-Bibliothek

@maschinenlesbar.org/fit-connect-cli ist auch ein typisierter API-Client, den Sie in eigenem Code importieren können – ohne HTTP-Abhängigkeiten zur Laufzeit.

API-Referenz → Nutzung als Bibliothek und Architektur →

Das Werkzeug, nicht die Daten

Die Daten stammen vom Anbieter hinter der API und unterliegen dessen Bedingungen – siehe DATA_LICENSE.md. Der Code steht unter AGPL-3.0-or-later oder einer kommerziellen Lizenz – siehe LICENSING.md.