Kommandozeilen-Tool und TypeScript-Bibliothek

`hochwasser`

Die amtlichen Hochwasserwarnungen und die Hochwasserlage an rund 1600 Pegeln in Deutschland direkt im Terminal prüfen. hochwasser ist ein Kommandozeilen-Tool für die offizielle LHP-PublicAPI (api.hochwasserzentralen.de) des Länderübergreifenden Hochwasserportals (LHP) – des gemeinsamen Hochwasserportals der Bundesländer – als sauberes JSON, das Sie direkt an jq weitergeben können, oder als kartenfertiges GeoJSON.

Version 0.0.4 npm GitHub API-Referenz

Installation

Benötigt Node.js 20 oder neuer. Installiert den Befehl hochwasser:

npm i -g @maschinenlesbar.org/hochwasserzentralen-cli

Zugang

Kein Konto, kein API-Schlüssel, keine Konfiguration – installieren und loslegen.

Schnellstart

# Are there flood warnings anywhere right now?
hochwasser alerts

# ...in Bavaria and Saxony, with the full CAP detail blocks?
hochwasser alerts --states BY,SN --cap

# The flood class at every gauge in Berlin
hochwasser stations --states BE

# One-screen national overview: per state, gauges per class + worst class
hochwasser situation

Befehle

Die Beschreibungen der Befehle stammen direkt aus der CLI und sind englisch.

alerts

Current regional flood alerts (Hochwasser-Warnungen) of the German states
stations

Flood classification at the LHP gauges (no water levels — see pegel-online-cli)
situation

Per-state overview aggregated from the gauges: station count per lhpClass + worst class

Alle Befehle, Argumente und Optionen →

Skills für Claude Code

Das Plugin hochwasser bringt Claude bei, hochwasser zu nutzen. Installation über den Marketplace von maschinenlesbar.org:

/plugin marketplace add maschinenlesbar-org/plugins
/plugin install hochwasser@maschinenlesbar

/hochwasser:hochwasser-flood-alerts
/hochwasser:hochwasser-geojson-export
/hochwasser:hochwasser-station-situation

Was die Skills beantworten, mit echten Beispielen → Beschreibungen und Voraussetzungen der Skills →

TypeScript-Bibliothek

@maschinenlesbar.org/hochwasserzentralen-cli ist auch ein typisierter API-Client, den Sie in eigenem Code importieren können – ohne HTTP-Abhängigkeiten zur Laufzeit.

API-Referenz → Nutzung als Bibliothek und Architektur →

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.