Command-line tool and TypeScript library

`lebensmittel`

Check Germany’s official product-warning portal (lebensmittelwarnung.de) from your terminal. lebensmittel is a command-line tool over the portal’s official RSS feeds — the current recalls (Rückrufe) for food, cosmetics, and consumer products, narrowable by federal state and product type, as clean JSON you can pipe straight into jq.

Version 0.0.4 npm GitHub API reference

Install

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

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

Access

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

Quick start

# The 5 most recent recalls, product name + reason
lebensmittel warnings --limit 5 | jq -r '.[] | "\(.title) — \(.reason // "?")"'

# Only recalls affecting Bavaria
lebensmittel warnings --state bayern | jq length

# Only food recalls since the start of the month
lebensmittel warnings --type lebensmittel --since 2026-07-01 \
  | jq -r '.[] | "\(.pubDate | split(" ")[1:4] | join(" "))\t\(.title)"'

# Search current recalls by product name
lebensmittel warnings --search schokolade | jq -r '.[].title'

Commands

warnings

List current product warnings (Rückrufe), optionally narrowed by federal state and/or product type
states

Print the valid --state slugs (offline)
types

Print the valid --type product-type slugs (offline)

All commands, arguments and options →

Claude Code skills

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

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

/lebensmittelwarnung:lebensmittelwarnung-produkttyp
/lebensmittelwarnung:lebensmittelwarnung-recalls
/lebensmittelwarnung:lebensmittelwarnung-regional

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

TypeScript library

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