AgentSkillsCN

knuspr

通过 knuspr-cli 在 Knuspr.de 上管理生鲜购物。可用于商品搜索、购物车管理、配送时段预约、购物清单、订单历史、优惠活动、收藏夹以及膳食建议。当用户提及 Knuspr、生鲜、Einkauf、Lebensmittel、Warenkorb、Lieferslot 或购物清单相关任务时，即可触发该功能。

SKILL.md
--- frontmatter
name: knuspr
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.

Knuspr CLI Skill

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

Setup

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

Critical Rules

  1. •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.
  2. •Always use --json for parsing output programmatically.
  3. •Confirm before destructive actions (cart clear, list delete, slot release).
  4. •Show prices and totals when adding to cart so the user stays informed.

CLI Usage

code
python3 {baseDir}/knuspr_cli.py <resource> <action> [options]

Core Workflows

Search & Add to Cart

bash
# 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 <product_id> -q <quantity>
python3 {baseDir}/knuspr_cli.py cart show --json  # verify cart & total

Delivery Slots

bash
python3 {baseDir}/knuspr_cli.py slot list --detailed --json  # show available slots with IDs
python3 {baseDir}/knuspr_cli.py slot reserve <slot_id>       # reserve a 15-min ON_TIME slot
python3 {baseDir}/knuspr_cli.py slot reserve <slot_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

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

Order History & Reorder

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

Full Command Reference

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