Open data, machine-readable
maschinenlesbar.org publishes command-line tools and typed TypeScript clients for 32 open German public-sector APIs — parliament and lobbying, official statistics, weather and water levels, energy, public warnings, jobs and more. Every tool prints clean JSON, has its own website in English and German, and comes with skills for Claude Code.
Every tool is the npm package @maschinenlesbar.org/<tool>-cli and needs Node.js 20 or newer.
Output is pretty-printed JSON by default and compact with --compact; errors go to stderr with distinct exit codes, so the tools are safe to script.
Each package is also a typed API client for your own code, with no runtime HTTP dependencies. Every website links its API reference.
26 of the 32 APIs need no account and no key. Where one is needed, you supply it — no key or credential is ever bundled.
Install a tool, query the API, and use the same client in TypeScript:
npm i -g @maschinenlesbar.org/tagesschau-cli
tagesschau homepage --compactimport { TagesschauClient } from "@maschinenlesbar.org/tagesschau-cli";
const client = new TagesschauClient();
const home = await client.homepage();Each card links the tool's website, with its commands, guides and API reference. The descriptions show what you can do with the tool and its Claude Code skills.
abgeordnetenwatchPull a politician's roll-call voting record, surface disclosed side income, and break down how a parliament voted on a bill — all over the open, key-free abgeordnetenwatch.de API (CC0 data) via the abgeordnetenwatch-cli.
ausbildungssucheFind apprenticeships & training near a place, brief a single offer from its id, and profile the training market across regions — over the Bundesagentur für Arbeit Ausbildungssuche API via the ausbildungssuche-cli.
autobahnBrief motorway disruptions before a drive, plan EV charging stops along a route, and export any Autobahn service as GeoJSON — all over the open, key-free Autobahn App API via the autobahn-cli.
bundeshaushaltBreak the German federal budget down by ministry, economic group or function, compare planned vs. realised (Soll/Ist) figures, and build multi-year spending trends — all over the open, key-free bundeshaushalt.de portal via the bundeshaushalt-cli.
bundesratFollow the Bundesrat: the current plenary sitting's agenda and Drucksachen, the members (by Land or party), and committee dates — via the bundesrat-cli. Surfaces only openly-licensed data.
bundeswahlQuery the official Bundestagswahl 2025 result — first/second votes by Bund, Land or Wahlkreis, filtered by party — plus the parties, the 299 constituencies and structural data, via the bundeswahlleiterin-cli. Open data (Datenlizenz Deutschland).
destatisFind the right official-statistics object, fetch and decode its data, and export tables to CSV/Excel — over the DESTATIS GENESIS-Online API via the destatis-genesis-cli.
ddbSearch Germany's digitised cultural heritage, explore facet distributions, and fetch an object's full detail — over the public v2 Deutsche Digitale Bibliothek API via the deutsche-digitale-bibliothek-cli. No API key required.
dipTrack a Bundestag legislative procedure end to end, profile a member, and digest Drucksachen / Plenarprotokolle with full text — all over the Bundestag DIP API via the dip-bundestag-cli.
dwdBrief the current German weather warnings, decode a DWD station forecast into real units, export warning areas as GeoJSON, and cross-check official warnings against crowd reports — all over the open, key-free DWD Warnwetter app API via the dwd-cli.
entgeltatlasLook up what a German occupation earns, compare salaries across gender/region/level, and resolve the KldB and dimension codes — over the Bundesagentur für Arbeit Entgeltatlas API via the entgeltatlas-cli.
fim-portalAssemble service dossiers, lay out data-schema form blueprints, audit schema quality, and find reusable data fields — all over the open, key-free FIM Portal API via the fim-portal-cli.
fit-connectResolve which German authority is responsible for a public service in a given place, look up area codes (ags/ars/areaId), and build citizen-facing service briefings — all over the open, key-free FIT-Connect Routing API via the fit-connect-cli.
fragdenstaatFind and analyse FOI requests, look up the right authority, explore the German FOI legal landscape, and dig out and export released documents — all over the public, key-free FragDenStaat.de API via the fragdenstaat-cli.
govdataFind and rank open German government datasets, build catalogue statistics with CKAN facets, and harvest downloadable resources into a manifest — all over the open, key-free GovData CKAN API via the govdata-cli.
hochwasserCheck Germany's official flood warnings and the flood classification at ~1200 gauges, get a per-state situation overview, and export warning areas or gauges as GeoJSON — all over the open, key-free LHP-PublicAPI via the hochwasserzentralen-cli.
jobsucheScan the German job market for a role/region, run a ranked job hunt with full-detail enrichment, and watch a specific employer's openings — all over the open Bundesagentur für Arbeit Jobsuche API via the jobsuche-cli.
ladesaeulenFind, count and map public EV charging stations in Germany — by place, operator, connector, capacity or nearby a point — from the Bundesnetzagentur's Ladesäulenregister, via the ladesaeulenregister-cli.
lebensmittelCheck Germany's official product-recall portal: current warnings (Rückrufe) by product, federal state, product type and recall reason — via the lebensmittel CLI over the official RSS feeds.
lobbyregisterProfile who lobbies the Bundestag on a topic, rank registered lobbyists by declared spend or by legislative-engagement volume, track new registrations and deregistrations over time, and surface the revolving door of former MdBs and government officials — all over the open, key-free Lobbyregister search API via the lobbyregister-cli.
luftqualitaetFind the right air-quality monitoring station for a place, brief the current air-quality index for a station, and rank stations by annual pollutant levels or limit exceedances — all over the open, key-free Umweltbundesamt Air Data API via the luftqualitaet-cli.
mastrSearch and count German electricity & gas units — solar, wind, storage, CHP — in the Bundesnetzagentur's Marktstammdatenregister (MaStR), with the filter-syntax and record-reading help, via the marktstammdatenregister-cli.
mudabExplore German marine-monitoring data — stations, measured parameters, measurements and HELCOM PLC river loads for the North and Baltic Sea — over the MUDAB (Meeresumweltdatenbank) API via the mudab-cli.
ninaBrief Germany's live civil-protection warnings across all NINA sources, watch a specific region by its ARS/AGS key, and export a warning's affected area as GeoJSON — all over the open, key-free NINA API via the nina-warnungen-cli.
pegelCheck live water levels and flood/low-water state at any German federal-waterway gauge, get a whole-river overview, analyse level trends, and export gauges as GeoJSON — all over the open, key-free PEGELONLINE API via the pegel-online-cli.
regionalatlasBrowse, map and compare regional-statistics indicators for Germany — by Bundesland, Regierungsbezirk, Kreis or Gemeinde — from the Regionalatlas Deutschland of the Statistische Ämter des Bundes und der Länder, via the regionalatlas-cli.
regstatFind the right regional-statistics object, fetch and decode its data by Kreis or Gemeinde, and export tables to CSV/Excel — over the Regionaldatenbank Deutschland GENESIS API via the regionalstatistik-cli.
reisewarnungenBrief the German Foreign Office's travel and safety advice for a trip, rank every country currently under a warning, and diff warnings over time — all over the open, key-free Auswärtiges Amt travel-warning API via the reisewarnungen-cli.
smardBuild Germany's generation mix and renewable share, summarise day-ahead wholesale prices across bidding zones, and export gap-clean electricity time series — all over the open, key-free SMARD chart-data API via the smard-cli.
strahlenschutzRank the live ambient gamma dose rate (ODL) across Germany's ~1700 BfS stations, read a single station's time-series trend, and export the network as GeoJSON — all over the open, key-free ODL-Info WFS via the strahlenschutz-cli.
tagesschauBriefings of current German headlines, regional news by Bundesland, full-text topic tracking, and live stream links — all over the open, key-free Tagesschau API via the tagesschau-cli.
oparlFollow a German city or municipal council through its OParl council information system (Ratsinformationssystem) — find the endpoint, then its bodies, meetings, papers and committees — via the oparl-cli. Open data; licence varies per endpoint.
Every tool ships Claude Code skills that teach Claude to run it and read its output — 99 skills in 32 plugins, published through one marketplace. Add it once, then install the plugins you need:
/plugin marketplace add maschinenlesbar-org/plugins
/plugin install fim-portal@maschinenlesbarThe data comes from the public bodies behind each API, under their own terms — public domain, attribution licences or custom provider terms — documented in DATA_LICENSE.md in each tool's repository.
The code is dual-licensed AGPL-3.0-or-later or under a commercial license — contact sebs@2xs.org. External code contributions aren't accepted, to keep the copyright with a single holder; bug reports are welcome in each tool's repository.