dip

Install

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

npm i -g @maschinenlesbar.org/dip-bundestag-cli

Access

Needs the free, publicly documented API key: pass --api-key or set DIP_API_KEY. No key is bundled; the README explains where to get it.

Quick start

export DIP_API_KEY=your-personal-key

# Procedures matching a title keyword
dip vorgang list --filter f.titel=Klimaschutz

# How many matched?
dip vorgang list --filter f.titel=Klimaschutz | jq '.numFound'

# Fetch one procedure by id
dip vorgang get 282486

# Full text of a printed paper
dip drucksache-text list --filter f.titel=Haushaltsgesetz --filter f.wahlperiode=20 \
  | jq -r '.documents[0].text'

Commands

• obtain-key

  Obtain the DIP API key and check it still works. DIP rotates its published key, so the candidate is verified against the live API before it is printed; if no published key is accepted the command fails and points at https://dip.bundestag.de/über-dip/hilfe/api.

• vorgang

  Vorgänge (procedures)

• vorgangsposition

  Vorgangspositionen

• drucksache

  Drucksachen (printed papers)

• drucksache-text

  Drucksachen with full text

• plenarprotokoll

  Plenarprotokolle

• plenarprotokoll-text

  Plenarprotokolle with full text

• aktivitaet

  Aktivitäten

• person

  Personen (members)

All commands, arguments and options →

Claude Code skills

The dip-bundestag plugin teaches Claude to use dip. Install it from the maschinenlesbar.org marketplace:

/plugin marketplace add maschinenlesbar-org/plugins
/plugin install dip-bundestag@maschinenlesbar

• /dip-bundestag:dip-document-digest
• /dip-bundestag:dip-member-dossier
• /dip-bundestag:dip-procedure-tracker

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

TypeScript library

@maschinenlesbar.org/dip-bundestag-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.