功能描述

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.

使用说明 (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.

安全使用建议

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.

功能分析

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.

能力评估

ℹ 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.

版本历史

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.

元数据

Slug knuspr-cli

版本 0.1.0

许可证 —

累计安装 0

当前安装数 0

历史版本数 1

常见问题

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. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 1047 次。

如何安装 Knuspr？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install knuspr-cli」即可一键安装，无需额外配置。

Knuspr 是免费的吗？

是的，Knuspr 完全免费（开源免费），可自由下载、安装和使用。

Knuspr 支持哪些平台？

Knuspr 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Knuspr？

由 Lars147（@lars147）开发并维护，当前版本 v0.1.0。

Knuspr