Command-line tool and TypeScript library
luftqualitaet
Query Germany’s official air-quality data — measurements, indices, annual balances and exceedances — straight from your terminal. luftqualitaet is a command-line tool over the open Umweltbundesamt Air Data API: look up pollutants and stations, fetch hourly or daily measurements, inspect exceedances, and get the full picture — as clean JSON you can pipe straight into jq.
Install
Needs Node.js 20 or newer. Installs the luftqualitaet command:
npm i -g @maschinenlesbar.org/luftqualitaet-cliAccess
No account, no API key, no configuration — install and query.
Quick start
luftqualitaet components --lang en --index codeCommands
-
componentsList measured components (pollutants)
-
networksList measurement networks
-
scopesList measurement scopes
-
station-typesList station types
-
station-settingsList station settings
-
transgression-typesList exceedance types
-
airqualityAir-quality index data for a station/window
-
airquality-limitsAvailable date range per station for air-quality data
-
measuresRaw measurements for a station/window
-
measures-limitsAvailable date range per scope/component/station
-
annual-balancesAnnual tabulations for a component and year
-
transgressionsExceedances for a component and year
-
thresholdsThresholds for a use (airquality | measure)
-
metaCombined metadata for a use
Claude Code skills
The luftqualitaet plugin teaches Claude to use luftqualitaet. Install it from the maschinenlesbar.org marketplace:
/plugin marketplace add maschinenlesbar-org/plugins
/plugin install luftqualitaet@maschinenlesbar/luftqualitaet:luftqualitaet-air-report/luftqualitaet:luftqualitaet-annual-report/luftqualitaet:luftqualitaet-station-finder
What the skills answer, with real examples → Skill descriptions and requirements →
TypeScript library
@maschinenlesbar.org/luftqualitaet-cli is also a typed API client you can import in your own code, with no runtime HTTP dependencies.
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.