knuspr

TotalClaw 作者 totalclaw

通过 knuspr-cli 管理 Knuspr.de 上的杂货购物。用于产品搜索、购物车管理、送货时段预订、购物清单、订单历史记录、优惠、收藏夹和膳食建议。当用户提及 Knuspr、杂货、Einkauf、Lebensmittel、Warenkorb、Lieferslot 或购物清单任务时触发。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~lars147-knuspr-cli

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~lars147-knuspr-cli/file -o lars147-knuspr-cli.md

## 概述（中文）

通过 knuspr-cli 管理 Knuspr.de 上的杂货购物。用于产品搜索、购物车管理、送货时段预订、购物清单、订单历史记录、优惠、收藏夹和膳食建议。当用户提及 Knuspr、杂货、Einkauf、Lebensmittel、Warenkorb、Lieferslot 或购物清单任务时触发。

## 原文

# 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

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