Description

Manage grocery shopping on Knuspr.de via the knuspr-cli. Use for product search, cart management, delivery slot reservation, shopping lists, order history, deals, favorites, and meal suggestions. Trigger when the user mentions Knuspr, groceries, Einkauf, Lebensmittel, Warenkorb, Lieferslot, or shopping list tasks.

README (SKILL.md)

Knuspr CLI Skill

Name: Knuspr
Author: lars147

Interact with Knuspr.de (German grocery delivery) using knuspr-cli — a pure-Python CLI bundled in this skill at {baseDir}/knuspr_cli.py.

Setup

Python 3.8+ required (no external dependencies)
Login: python3 {baseDir}/knuspr_cli.py auth login (or set KNUSPR_EMAIL + KNUSPR_PASSWORD env vars)
Minimum order: €39

Critical Rules

NEVER complete a purchase — Only build cart + reserve slot. Always tell the user to review and checkout themselves via cart open or the Knuspr website/app.
Always use --json for parsing output programmatically.
Confirm before destructive actions (cart clear, list delete, slot release).
Show prices and totals when adding to cart so the user stays informed.

CLI Usage

python3 {baseDir}/knuspr_cli.py \x3Cresource> \x3Caction> [options]

Core Workflows

Search & Add to Cart

# Search products (use --json for parsing)
python3 {baseDir}/knuspr_cli.py product search "Hafermilch" --json
python3 {baseDir}/knuspr_cli.py product search "Käse" --bio --sort price_asc --json
python3 {baseDir}/knuspr_cli.py product search "Joghurt" --rette --json  # discounted items

# Add to cart
python3 {baseDir}/knuspr_cli.py cart add \x3Cproduct_id> -q \x3Cquantity>
python3 {baseDir}/knuspr_cli.py cart show --json  # verify cart & total

Delivery Slots

python3 {baseDir}/knuspr_cli.py slot list --detailed --json  # show available slots with IDs
python3 {baseDir}/knuspr_cli.py slot reserve \x3Cslot_id>       # reserve a 15-min ON_TIME slot
python3 {baseDir}/knuspr_cli.py slot reserve \x3Cslot_id> --type VIRTUAL  # 1-hour window
python3 {baseDir}/knuspr_cli.py slot current --json          # check current reservation
python3 {baseDir}/knuspr_cli.py slot release                 # cancel reservation (ask first!)

Shopping Lists

python3 {baseDir}/knuspr_cli.py list show --json             # all lists
python3 {baseDir}/knuspr_cli.py list show \x3Clist_id> --json   # products in a list
python3 {baseDir}/knuspr_cli.py list create "Wocheneinkauf"
python3 {baseDir}/knuspr_cli.py list add \x3Clist_id> \x3Cproduct_id>
python3 {baseDir}/knuspr_cli.py list to-cart \x3Clist_id>       # move entire list to cart
python3 {baseDir}/knuspr_cli.py list duplicate \x3Clist_id>     # duplicate a list

Order History & Reorder

python3 {baseDir}/knuspr_cli.py order list --json
python3 {baseDir}/knuspr_cli.py order show \x3Corder_id> --json
python3 {baseDir}/knuspr_cli.py order repeat \x3Corder_id>      # add all items to cart

Full Command Reference

For all commands, options, and flags see {baseDir}/references/commands.md.

Usage Guidance

This skill is plausibly what it claims to be (a knuspr.de CLI) but there are important mismatches and privacy considerations to check before installing: - Metadata mismatch: the registry lists no required env vars/config paths, but the README/SKILL.md and bundled code explicitly support/expect KNUSPR_EMAIL and KNUSPR_PASSWORD and will write ~/.knuspr_credentials.json and ~/.knuspr_session.json. Confirm this omission with the publisher. - Review the bundled code yourself (knuspr_cli.py) before running it. Because the script runs network requests as your account, you should verify there are no hidden endpoints or unexpected behavior. - Prefer interactive login over exporting credentials as environment variables. If you must store credentials on disk, ensure files are only readable by your user (chmod 600). - Consider creating a limited/test account rather than using your primary account until you trust the code and its upstream source. - Because the SKILL source/homepage are listed as unknown/none, try to verify the upstream repository and author (pyproject references a GitHub repo). If possible, prefer an officially maintained client or review the repo history and issues. - The SKILL.md explicitly instructs the agent to never complete purchases; if you allow autonomous invocation, ensure the agent cannot run 'checkout' or 'complete purchase' commands with your credentials. If your platform allows restricting which commands a skill may run, apply those controls. If you are not comfortable auditing the code or providing credentials to code with an unclear origin, do not install/use the skill.

Capability Analysis

Type: OpenClaw Skill Name: knuspr-cli Version: 0.1.0 The skill bundle is benign. The `knuspr_cli.py` script uses only Python's standard library, eliminating external supply chain risks. All network communication is directed exclusively to `https://www.knuspr.de`, with no evidence of data exfiltration to unauthorized external endpoints. Sensitive data like session cookies and optional user credentials are stored locally in the user's home directory (`~/.knuspr_session.json`, `~/.knuspr_credentials.json`), which is standard practice for CLI tools, and the `README.md` even recommends `chmod 600` for the credentials file. The `SKILL.md` instructions include 'Critical Rules' explicitly designed to prevent the AI agent from completing purchases or performing destructive actions without user confirmation, indicating a strong intent for safe and controlled operation.

Capability Assessment

ℹ Purpose & Capability

The name/description match the included CLI implementation: the code and docs implement product search, cart, slots, lists, orders, etc. However, the registry metadata claims no required environment variables or config paths, while the SKILL.md, README, references, and the bundled code all reference KNUSPR_EMAIL / KNUSPR_PASSWORD, a credentials file (~/.knuspr_credentials.json), and session/config files (~/.knuspr_session.json, ~/.knuspr_config.json). That metadata omission is an incoherence.

ℹ Instruction Scope

Runtime instructions direct the agent to run the bundled Python CLI and to log in (interactive or via KNUSPR_EMAIL/KNUSPR_PASSWORD). The instructions stay within the shopping domain (search, cart, slot reservation) and explicitly forbid completing purchases. They do reference reading/writing credential and session files in the user's home directory (expected for a local CLI) — which is within scope but should be explicitly declared in metadata and considered sensitive.

✓ Install Mechanism

There is no external install step; the CLI is bundled in the skill. No downloads from arbitrary URLs or package registries are performed. The script uses only Python stdlib. This is lower-risk than fetching remote code at install time, but executing included code still requires review.

⚠ Credentials

Functionally the CLI needs user credentials to act on behalf of the user, so requesting KNUSPR_EMAIL / KNUSPR_PASSWORD (or interactive login) is proportionate. The concern is that the declared requirements list none, while documentation and code require/use credentials and create session/credential files in the home directory. The skill will store sensitive data on disk (~/.knuspr_credentials.json, ~/.knuspr_session.json); the user must ensure proper file permissions and be comfortable providing credentials to this third-party code.

✓ Persistence & Privilege

The skill persists session and config files under the user's home directory but does not request elevated privileges nor set always:true. It does not appear to modify other skills or system-wide agent settings. Local persistence of credentials and cookies is expected for a CLI, but it increases the risk if the code or environment is untrusted.

Version History

v0.1.0

Initial release of knuspr-cli skill. - Enables grocery shopping management on Knuspr.de via bundled Python CLI. - Supports product search, cart management, delivery slot reservation, shopping lists, order history, deals, favorites, and meal suggestions. - Includes clear safety rules: no automatic purchases, always confirm destructive actions, and show prices before cart changes. - Provides core usage examples and workflows for all major features. - Full command reference available in the documentation.

Metadata

Slug knuspr-cli

Version 0.1.0

License —

All-time Installs 0

Active Installs 0

Total Versions 1

Frequently Asked Questions

What is Knuspr?

Manage grocery shopping on Knuspr.de via the knuspr-cli. Use for product search, cart management, delivery slot reservation, shopping lists, order history, deals, favorites, and meal suggestions. Trigger when the user mentions Knuspr, groceries, Einkauf, Lebensmittel, Warenkorb, Lieferslot, or shopping list tasks. It is an AI Agent Skill for Claude Code / OpenClaw, with 1047 downloads so far.

How do I install Knuspr?

Run "/install knuspr-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Knuspr free?

Yes, Knuspr is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Knuspr support?

Knuspr is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Knuspr?

It is built and maintained by Lars147 (@lars147); the current version is v0.1.0.

More Skills

Knuspr