Kommandozeilen-Tool und TypeScript-Bibliothek
oparl
Informationen aus Stadt- und Gemeinderäten in Deutschland – Sitzungen, Tagesordnungen, Vorlagen, Gremien und Mitglieder – direkt im Terminal abrufen. oparl ist ein Kommandozeilen-Tool und TypeScript-Client für OParl, den offenen Schnittstellenstandard für Ratsinformationssysteme: den Endpunkt einer Kommune finden, ihre Körperschaften öffnen und deren Sitzungen, Vorlagen oder Personen als sauberes JSON durchgehen, das Sie direkt an jq weitergeben können.
Installation
Benötigt Node.js 20 oder neuer. Installiert den Befehl oparl:
npm i -g @maschinenlesbar.org/oparl-cliZugang
Kein Konto, kein API-Schlüssel, keine Konfiguration – installieren und loslegen.
Schnellstart
# 1. Find a municipality's OParl endpoint (its System URL)
oparl endpoints --search köln | jq -r '.[].url'
# 2. List the bodies on that server — usually one per municipality
oparl bodies https://buergerinfo.stadt-koeln.de/oparl/system | jq -r '.data[] | "\(.name)\t\(.id)"'
# 3. Papers (Vorlagen, Anträge, Anfragen) changed since a date
oparl list paper https://buergerinfo.stadt-koeln.de/oparl/bodies/stadtverwaltung_koeln \
--modified-since 2026-09-01 | jq -r '.data[] | select(.deleted != true) | "\(.date)\t\(.reference)\t\(.name)"'
# 4. The first page of meetings
oparl list meeting https://buergerinfo.stadt-koeln.de/oparl/bodies/stadtverwaltung_koeln \
| jq -r '.data[] | "\(.start)\t\(.name)"'Befehle
Die Beschreibungen der Befehle stammen direkt aus der CLI und sind englisch.
-
endpointsList known OParl endpoints: the registry at dev.oparl.org plus a curated list of servers it lacks, with the date and result of their last live check
-
systemFetch an endpoint's System object (the entry point of an OParl server)
-
bodiesList the bodies (Körperschaften, usually municipalities) on an OParl server
-
listWalk one of a body's object lists. Returns { data, pages, next }: pass `next` to `oparl get` or raise --max-pages to continue. Servers may ignore the filters.
-
getFetch any OParl object or list page by URL
Skills für Claude Code
Das Plugin oparl bringt Claude bei, oparl zu nutzen. Installation über den Marketplace von maschinenlesbar.org:
/plugin marketplace add maschinenlesbar-org/plugins
/plugin install oparl@maschinenlesbar/oparl:oparl-council-activity/oparl:oparl-endpoint-finder
Was die Skills beantworten, mit echten Beispielen → Beschreibungen und Voraussetzungen der Skills →
TypeScript-Bibliothek
@maschinenlesbar.org/oparl-cli ist auch ein typisierter API-Client, den Sie in eigenem Code importieren können – ohne HTTP-Abhängigkeiten zur Laufzeit.
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.