Command-line tool and TypeScript library

`regionalatlas`

A dependency-light TypeScript client + CLI for the Regionalatlas Deutschland — the regional-statistics indicators of the Statistische Ämter des Bundes und der Länder (Destatis and the 16 Länder offices), broken down per Bundesland / Regierungsbezirk / Kreis / Gemeinde. Backed by a public ArcGIS MapServer plus a static indicator catalogue.

Version 0.1.0 npm GitHub API reference

Install

Needs Node.js 20 or newer. Installs the regionalatlas command:

npm i -g @maschinenlesbar.org/regionalatlas-cli

Access

No account, no API key, no configuration — install and query.

Quick start

regionalatlas themes                                             # the 21 subject areas
regionalatlas indicators --search bevölkerung                    # matching indicators
regionalatlas indicators --theme Bevölkerung --year 2024         # filter by theme + year
regionalatlas query AI002-1-5 --level land --year 2020           # 16 Bundesländer rows
regionalatlas query AI002-1-5 --level kreis                      # ~400 Kreise (latest year)
regionalatlas query AI002-1-5 --level land --region Bayern       # one region
regionalatlas query AI002-1-5 --level land --fields ai0201       # project value fields

Commands

themes

List the subject areas (Themenbereiche) with their indicator counts
indicators

List indicators (Indikatoren): code, short and long title, available years
query

Fetch indicator data rows per region (Bundesland / Kreis / Gemeinde)

All commands, arguments and options →

Claude Code skills

The regionalatlas plugin teaches Claude to use regionalatlas. Install it from the maschinenlesbar.org marketplace:

/plugin marketplace add maschinenlesbar-org/plugins
/plugin install regionalatlas@maschinenlesbar

/regionalatlas:regionalatlas-catalog
/regionalatlas:regionalatlas-compare
/regionalatlas:regionalatlas-map

What the skills answer, with real examples → Skill descriptions and requirements →

TypeScript library

@maschinenlesbar.org/regionalatlas-cli is also a typed API client you can import in your own code, with no runtime HTTP dependencies.

API reference → Library usage and architecture →

The tool, not the data

The data comes from the provider behind the API, under its own terms — see DATA_LICENSE.md. The code is dual-licensed AGPL-3.0-or-later or commercial — see LICENSING.md.