destatis

Installation

Benötigt Node.js 20 oder neuer. Installiert den Befehl destatis:

npm i -g @maschinenlesbar.org/destatis-genesis-cli

Zugang

Benötigt ein kostenloses Konto beim Datenanbieter: DESTATIS_API_TOKEN setzen oder DESTATIS_USERNAME und DESTATIS_PASSWORD. Es sind keine Zugangsdaten enthalten; wie Sie sich registrieren, steht in der README.

Schnellstart

destatis hello                                  # connectivity check (no auth)
destatis logincheck                             # validate your credentials
destatis find "Bevölkerung" --category tables   # search for tables
destatis catalogue tables "124*"                # browse tables by code
destatis metadata table 12411-0001              # describe a table
destatis data table 12411-0001 --start-year 2020 --compact
destatis data tablefile 12411-0001 --format ffcsv -o pop.zip

Befehle

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

• hello

  Connectivity check (helloworld/whoami) — needs no credentials

• logincheck

  Validate your credentials (helloworld/logincheck)

• find

  Full-text search across statistics, tables, cubes, variables and time series

• catalogue

  Browse the catalogue: list objects by code selection (e.g. `124*`)

• metadata

  Describe an object's structure (metadata) by its code

• data

  Retrieve statistical data (tables, cubes, time series, results)

Alle Befehle, Argumente und Optionen →

Skills für Claude Code

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

/plugin marketplace add maschinenlesbar-org/plugins
/plugin install destatis-genesis@maschinenlesbar

• /destatis-genesis:destatis-data-fetch
• /destatis-genesis:destatis-statistics-finder
• /destatis-genesis:destatis-table-download

Beschreibungen und Voraussetzungen der Skills →

TypeScript-Bibliothek

@maschinenlesbar.org/destatis-genesis-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.