name: gurkerlcli
version: 0.1.6
description: 奥地利在线杂货购物平台 gurkerl.at 的命令行工具。当用户提及“杂货”、“Einkauf”、“Lebensmittel bestellen”、“Gurkerl”、购物车，或想在奥地利在线搜索/订购食品时使用。
tools: [bash]

🥒 gurkerlcli - 奥地利在线杂货购物

适用于奥地利在线杂货购物平台 gurkerl.at 的命令行界面。

安装

# 通过 Homebrew 安装
brew tap pasogott/tap
brew install gurkerlcli

# 或通过 pipx 安装
pipx install gurkerlcli

身份验证

使用前需登录：

gurkerlcli auth login --email user@example.com --password xxx
gurkerlcli auth whoami     # 检查登录状态
gurkerlcli auth logout     # 清除会话

会话将安全地存储在 macOS 钥匙串中。

备选方案：环境变量

export GURKERL_EMAIL=your-email@example.com
export GURKERL_PASSWORD=your-password

或添加到 ~/.env.local 文件中以实现持久化。

命令

🔍 搜索商品

gurkerlcli search "bio milch"
gurkerlcli search "äpfel" --limit 10
gurkerlcli search "brot" --json          # 输出 JSON 格式，便于脚本处理

🛒 购物车管理

gurkerlcli cart list                     # 查看购物车内容
gurkerlcli cart add <product_id>         # 添加商品
gurkerlcli cart add <product_id> -q 3    # 指定数量添加商品
gurkerlcli cart remove <product_id>      # 移除商品
gurkerlcli cart clear                    # 清空购物车（需确认）
gurkerlcli cart clear --force            # 强制清空购物车（无需确认）

📝 购物清单

gurkerlcli lists list                    # 显示所有清单
gurkerlcli lists show <list_id>          # 显示清单详情
gurkerlcli lists create "Wocheneinkauf"  # 创建新清单
gurkerlcli lists delete <list_id>        # 删除清单

📦 订单历史

gurkerlcli orders list                   # 查看历史订单

使用示例

查看购物车内容

gurkerlcli cart list

输出示例：

🛒 购物车
┌─────────────────────────────────┬──────────────┬───────────────┬──────────┐
│ 商品                            │         数量 │         单价 │ 小计 │
├─────────────────────────────────┼──────────────┼───────────────┼──────────┤
│ 🥛 nöm BIO-全脂牛奶 3.5%       │     2x 1.0 升 │ €1.89 → €1.70 │    €3.40 │
│ 🧀 Bergbaron 奶酪               │     1x 150 克 │         €3.99 │    €3.99 │
├─────────────────────────────────┼──────────────┼───────────────┼──────────┤
│                                 │              │        总计： │    €7.39 │
└─────────────────────────────────┴──────────────┴───────────────┴──────────┘

⚠️  最低订单金额：€39.00（还需 €31.61）

搜索并添加商品到购物车

# 搜索商品
gurkerlcli search "hafermilch"

# 添加到购物车（使用搜索结果中的商品 ID）
gurkerlcli cart add 123456 -q 2

从购物车移除商品

# 列出购物车以查看商品 ID
gurkerlcli cart list --json | jq '.items[].product_id'

# 移除指定商品
gurkerlcli cart remove 123456

调试

使用 --debug 标志获取详细输出：

gurkerlcli cart add 12345 --debug
gurkerlcli cart remove 12345 --debug

提示

• 最低订单金额： 配送需满 €39.00
• 配送时段： 请访问 gurkerl.at 网站查看可用时间
• 促销商品： 带箭头的价格（如 €1.89 → €1.70）表示折扣价
• JSON 输出： 使用 --json 标志便于脚本处理和自动化

限制

• ⏳ 暂不支持结账功能（请使用网站完成）
• 🇦🇹 仅限奥地利地区（维也纳、格拉茨、林茨等区域）
• 🔐 需要有效的 gurkerl.at 账户

更新日志

• v0.1.6 - 修复购物车移除功能（使用 DELETE 而非 POST 请求）
• v0.1.5 - 修复添加已有商品到购物车的问题（使用 POST 而非 PUT 请求）

相关链接

• gurkerl.at
• GitHub 仓库