Command-line tool and TypeScript library
fragdenstaat
A command-line client and TypeScript library for the public, read-only API of FragDenStaat.de — Germany’s central Freedom-of-Information (Informationsfreiheit) portal, run by the Open Knowledge Foundation Deutschland.
Install
Needs Node.js 20 or newer. Installs the fragdenstaat command:
npm i -g @maschinenlesbar.org/fragdenstaat-cliAccess
No account, no API key, no configuration — install and query.
Quick start
# Find FOI requests about a topic (full-text search)
fragdenstaat request search --q "Videoüberwachung" --limit 5
# Filter requests: resolved & successful, federal jurisdiction
fragdenstaat request list --status resolved --resolution successful --jurisdiction 1 --limit 10
# One request in full, including its message thread
fragdenstaat request get 374948
# Which authority handles a topic? (name -> id, then profile)
fragdenstaat publicbody autocomplete "Umweltbundesamt"
fragdenstaat publicbody get 1
# Which FOI law applies in a jurisdiction?
fragdenstaat jurisdiction list
fragdenstaat law list --jurisdiction 1 --q umwelt
# Export a dataset to CSV
fragdenstaat request list --status resolved --jurisdiction 1 --csv -o requests.csvCommands
-
requestFOI requests (Informationsfreiheitsanfragen) — the central resource
-
publicbodyPublic bodies / authorities (Behörden) that receive FOI requests
-
lawFOI laws (IFG, UIG, VIG, state transparency acts, local statutes)
-
jurisdictionJurisdictions (Bund, the 16 Länder, the EU)
-
categoryTopical categories (Themen) — a tree
-
classificationPublic-body classifications (Behördentypen) — a tree
-
campaignCampaigns (Kampagnen) — coordinated mass-request projects
-
georegionGeographic regions (Regionen): states, districts, municipalities, zip codes
-
messageMessages (Nachrichten) in the correspondence of FOI requests
-
documentPublished documents (Dokumente) extracted from FOI responses
Claude Code skills
The fragdenstaat plugin teaches Claude to use fragdenstaat. Install it from the maschinenlesbar.org marketplace:
/plugin marketplace add maschinenlesbar-org/plugins
/plugin install fragdenstaat@maschinenlesbar/fragdenstaat:fds-authority-lookup/fragdenstaat:fds-document-digger/fragdenstaat:fds-law-explorer/fragdenstaat:fds-request-finder
What the skills answer, with real examples → Skill descriptions and requirements →
TypeScript library
@maschinenlesbar.org/fragdenstaat-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.