Kommandozeilen-Tool und TypeScript-Bibliothek
regstat
Ein TypeScript-API-Client mit CLI für die GENESIS-REST-API der Regionaldatenbank Deutschland (Version 2020) unter www.regionalstatistik.de – die Datenbank der amtlichen Regionalstatistik, betrieben von den Statistischen Ämtern des Bundes und der Länder. Sie enthält die amtlichen Zahlen unterhalb der Bundesebene bis hinunter zu Regierungsbezirk, Kreis und Gemeinde – Bevölkerung, Beschäftigung, Wahlen, Flächennutzung und vieles mehr, gegliedert nach den amtlichen Regionalschlüsseln AGS/ARS.
Installation
Benötigt Node.js 20 oder neuer. Installiert den Befehl regstat:
npm i -g @maschinenlesbar.org/regionalstatistik-cliZugang
Benötigt ein kostenloses Konto beim Datenanbieter: REGIONALSTATISTIK_API_TOKEN setzen oder REGIONALSTATISTIK_USERNAME und REGIONALSTATISTIK_PASSWORD. Es sind keine Zugangsdaten enthalten; wie Sie sich registrieren, steht in der README.
Schnellstart
regstat hello # connectivity check (no auth)
regstat logincheck # validate your credentials
regstat find "bevölkerung kreise" --category tables # search for tables
regstat catalogue tables "12411*" # browse tables by code
regstat metadata table 12411-01-01-4 # describe a table
regstat data table 12411-01-01-4 --region-key 08221 --start-year 2020 --compact
regstat data tablefile 12411-01-01-4 --region-key "08*" --format ffcsv -o bevoelkerung-bw.zipBefehle
Die Beschreibungen der Befehle stammen direkt aus der CLI und sind englisch.
-
helloConnectivity check (helloworld/whoami) — needs no credentials
-
logincheckValidate your credentials (helloworld/logincheck)
-
findFull-text search across statistics, tables, cubes, variables and time series (e.g. `regstat find "bevölkerung kreise" --category tables`)
-
catalogueBrowse the catalogue: list objects by code selection (e.g. `12411*`)
-
metadataDescribe an object's structure (metadata) by its code
-
dataRetrieve statistical data (tables, cubes, time series, results)
Skills für Claude Code
Das Plugin regionalstatistik bringt Claude bei, regstat zu nutzen. Installation über den Marketplace von maschinenlesbar.org:
/plugin marketplace add maschinenlesbar-org/plugins
/plugin install regionalstatistik@maschinenlesbar/regionalstatistik:regionalstatistik-data-fetch/regionalstatistik:regionalstatistik-statistics-finder/regionalstatistik:regionalstatistik-table-download
TypeScript-Bibliothek
@maschinenlesbar.org/regionalstatistik-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.