Command-line tool and TypeScript library

`hochwasser`

Check Germany’s official flood warnings and the flood situation at ~1600 gauges from your terminal. hochwasser is a command-line tool over the official LHP-PublicAPI (api.hochwasserzentralen.de) of the Länderübergreifendes Hochwasserportal (LHP) — the joint flood portal of the German states — as clean JSON you can pipe straight into jq, or as ready-to-map GeoJSON.

Version 0.0.4 npm GitHub API reference

Install

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

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

Access

No account, no API key, no configuration — install and query.

Quick start

# 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

Commands

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

All commands, arguments and options →

Claude Code skills

The hochwasser plugin teaches Claude to use hochwasser. Install it from the maschinenlesbar.org marketplace:

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

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

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

TypeScript library

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