Kommandozeilen-Tool und TypeScript-Bibliothek
mastr
Ein schlanker TypeScript-Client mit CLI für das Marktstammdatenregister (MaStR) – das Register der Bundesnetzagentur für den deutschen Strom- und Gasmarkt mit rund 9 Millionen Erzeugungs- und Verbrauchseinheiten (Solar, Wind, Speicher, KWK, …). Nutzt die öffentliche „erweiterte öffentliche Einheitensuche“. Eine bund.dev-API.
Installation
Benötigt Node.js 20 oder neuer. Installiert den Befehl mastr:
npm i -g @maschinenlesbar.org/marktstammdatenregister-cliZugang
Kein Konto, kein API-Schlüssel, keine Konfiguration – installieren und loslegen.
Schnellstart
mastr stromerzeugung --total # how many electricity-generation units? → 9063887
mastr stromerzeugung --filter "Energieträger~eq~'2495'" --total # …how many are solar? → 6267133
mastr stromerzeugung --sort "Bruttoleistung-desc" --page-size 20 --iso-dates
mastr gaserzeugung --page 1 --page-size 50
mastr filters stromerzeugung # the filterable columns + dropdown codesBefehle
Die Beschreibungen der Befehle stammen direkt aus der CLI und sind englisch.
-
stromerzeugungElectricity-generation units (Stromerzeugung)
-
stromverbrauchElectricity-consumption units (Stromverbrauch)
-
gaserzeugungGas-generation units (Gaserzeugung)
-
gasverbrauchGas-consumption units (Gasverbrauch)
-
filtersList the filterable columns (names, types, dropdown codes) for a category
Skills für Claude Code
Das Plugin mastr bringt Claude bei, mastr zu nutzen. Installation über den Marketplace von maschinenlesbar.org:
/plugin marketplace add maschinenlesbar-org/plugins
/plugin install mastr@maschinenlesbar/mastr:mastr-filters/mastr:mastr-search/mastr:mastr-unit
Was die Skills beantworten, mit echten Beispielen → Beschreibungen und Voraussetzungen der Skills →
TypeScript-Bibliothek
@maschinenlesbar.org/marktstammdatenregister-cli ist auch ein typisierter API-Client, den Sie in eigenem Code importieren können – ohne HTTP-Abhängigkeiten zur Laufzeit.
Das Werkzeug, nicht die Daten
Die Daten stammen vom Anbieter hinter der API und unterliegen dessen Bedingungen – siehe DATA_LICENSE.md. Der Code steht unter AGPL-3.0-or-later oder einer kommerziellen Lizenz – siehe LICENSING.md.