gurkerlcli

核心用法

gurkerlcli 是奥地利生鲜电商平台 gurkerl.at 的第三方命令行客户端，专为维也纳、格拉茨、林茨等地区的德语区用户设计。核心功能覆盖商品搜索、购物车管理、购物清单维护及订单历史查询四大模块。

商品搜索支持模糊匹配与数量限制，可通过 --json 输出结构化数据便于脚本化处理。购物车管理提供增删改查全功能，实时显示小计金额与 €39 最低起送差额，价格变动（如 €1.89 → €1.70）直观标注折扣。购物清单支持多列表创建与维护，方便周期性采购规划。认证层采用 macOS Keychain 安全存储会话，同时支持环境变量注入，兼顾安全性与自动化场景。

显著优点

• 原生 CLI 效率：无需打开浏览器，键盘驱动完成选品加购，适合技术用户批量操作
• 数据可视化：ASCII 表格展示购物车，金额、数量、折扣一目了然
• 安全设计优先：默认 Keychain 存储，避免明文凭证落盘
• 脚本友好：JSON 输出模式与标准退出码，易于集成 Home Assistant、crontab 等自动化工作流

潜在缺点与局限性

• 地域锁死：仅限奥地利部分城市，境外用户无法使用
• 功能缺口：结账支付未实现，最终仍需跳转官网完成，打断纯 CLI 体验
• 第三方维护：非 Gurkerl 官方出品，API 变更可能导致功能失效
• 依赖风险：Homebrew/pipx 安装链路存在供应链攻击面

适合人群

• 奥地利地区的开发者、系统管理员等重度 CLI 用户
• 追求采购流程自动化、需定时补货的智能家居玩家
• 德语区留学生及技术工作者，习惯终端操作

常规风险

| 风险类型 | 说明 |

|---------|------|

| 凭证泄露 | 环境变量方式虽便捷，但 `.env.local` 文件权限管理不当可能导致泄露 |

| 会话劫持 | Keychain 虽安全，若设备已遭入侵，会话 token 仍可被提取 |

| API 变更 | 非官方客户端，gurkerl.at 接口调整可能导致工具失效 |

| 订单错误 | CLI 操作缺乏二次确认（如 `--force` 清空购物车），误操作风险高于图形界面 |

核心用法

gurkerlcli 是一个面向奥地利用户的纯文档型 Agent Skill，旨在指导用户通过命令行工具高效操作 gurkerl.at 在线生鲜超市。该 Skill 本身不包含可执行代码，仅提供完整的 CLI 使用文档，涵盖三大核心场景：商品搜索（gurkerlcli search 支持关键词检索与 JSON 输出）、购物车管理（增删改查、数量调整、批量清空）、订单与清单（历史订单回溯、自定义购物清单创建）。用户需先通过 auth login 完成身份认证（凭证安全存储于 macOS Keychain），即可在终端内完成从选品到 cart 维护的全流程操作。

显著优点

1. 零代码风险设计：纯 Markdown 文档型 Skill，无脚本执行、无依赖引入，从根本上杜绝代码注入与恶意执行风险。2. 本地化服务深度适配：精准覆盖维也纳、格拉茨、林茨等奥地利核心城市的配送服务，支持德语搜索关键词（如"Bio Milch"、"Äpfel"），贴合本地用户习惯。3. 终端效率优势：JSON 输出模式便于脚本化集成，适合技术用户构建自动化采购 workflow；表格化 cart 展示直观呈现价格折扣与凑单进度。4. 隐私友好：无独立数据收集行为，认证流程委托官方 CLI 与系统 Keychain，符合 GDPR/CCPA 规范。

潜在缺点与局限性

功能边界明确受限：当前版本暂未实现 checkout 支付环节，用户仍需跳转官网完成最终下单与配送时段选择，形成"半自动化"体验断点。地理锁区严格：服务仅限奥地利境内，非目标区域用户无法使用。技术门槛存在：依赖 Homebrew/pipx 环境配置与终端操作基础，非技术用户上手成本较高。生态成熟度有限：GitHub 仓库 Stars 仅 3 个，社区贡献度与长期维护稳定性有待观察。

适合的目标群体

奥地利本地技术型消费者——熟悉 CLI 操作、追求效率的开发者或 IT 从业者；自动化爱好者——希望将生鲜采购纳入个人脚本生态（如定时补货提醒、家庭库存联动）；隐私敏感用户——偏好凭证本地存储（Keychain）、反感浏览器 cookie 追踪的群体。非技术用户或追求一站式 App 体验者建议直接使用 gurkerl.at 官方网页/应用。

使用风险与注意事项

性能与依赖风险：Skill 本身无依赖，但实际功能依赖外部 CLI 工具安装与网络连通性；若 gurkerl.at API 变更，文档可能存在滞后。安全操作提醒：文档示例包含密码明文输入（--password xxx），用户应避免在共享终端或历史记录中暴露凭证；建议优先采用环境变量或 .env.local 配置。来源可信度：作者为个人开发者（T3 级），虽账号活跃（10 年开源史），但项目规模较小，关键业务建议关注官方渠道动态。最低订单限制：€39 起送门槛需注意，频繁小额采购可能产生凑单焦虑。