apo-cli

核心用法

apo-cli 是一款纯 Python 实现的命令行工具，用于与德国在线药房 apohealth.de 交互。用户可通过名称或 PZN（Pharmazentralnummer，德国药品中央编号）搜索药品、浏览分类、查看产品详情，并管理购物车。所有操作通过本地 CLI 完成，无需登录认证，购物车数据以 JSON 格式本地存储。

典型工作流包括：使用 search 命令查找药品（支持模糊名称或精确 PZN），通过 product 获取详细规格与价格，利用 categories 和 list 浏览分类商品，最后用 cart 系列命令添加/移除商品、生成可分享的购物车链接。关键设计原则是绝不代用户完成购买——仅构建购物车后提供 URL，由用户自行在浏览器中结账。

显著优点

1. 零依赖部署：仅使用 Python 3.9+ 标准库（urllib、argparse、json 等），无第三方包安装风险，部署极简。
2. 隐私友好：无需账户登录，不收集用户身份信息，会话 cookies 与购物车令牌均本地存储。
3. 精准搜索：支持德国药房特有的 PZN 编码查询，适合专业用户快速定位特定药品。
4. 透明开源：MIT 许可证，代码完全公开，GitHub 可追溯，通过 PyPI 与 OpenClaw skill registry 分发。
5. 安全通信：强制 SSL/TLS 加密，使用标准 CookieJar 管理会话，User-Agent 标识清晰。

潜在缺点与局限性

1. 非官方工具：与 apohealth.de 无官方关联，API 变更可能导致功能失效，缺乏官方技术支持。
2. 地域限制：仅针对德国药房设计，PZN 体系与药品信息对非德语区用户价值有限。
3. 功能边界：无法完成支付闭环，购物车链接需用户手动跳转；缺乏库存实时预警与价格变动通知。
4. 医疗责任空白：工具本身不提供用药指导、禁忌提示或剂量建议，存在误用风险。
5. API 稳定性依赖：基于 Shopify 后端接口，未锁定版本，响应格式变更可能破坏解析逻辑。

适合的目标群体

• 德语区居民：需要便捷查询德国药房药品信息的消费者。
• 医疗从业者/药师：需快速验证 PZN 编码、比对药品规格的专业人员。
• 代购或跨境采购者：批量查询药品可用性与价格，辅助采购决策。
• 隐私敏感用户：不愿注册账户即可比价、建单的用户。
• 开发者/自动化爱好者：希望将药品查询集成到脚本或工作流的技术用户。

使用风险

• 合规风险：涉及药品信息查询，用户需自行承担医疗决策责任，工具未内置医疗免责声明。
• 数据持久化风险：购物车与 cookies 以明文 JSON 存储于本地，多用户环境可能存在信息泄露。
• 网络依赖：apohealth.de 服务中断或 IP 限制将直接导致工具失效。
• 误操作风险：cart clear 为破坏性操作，虽需确认但无撤销机制；variant_id 输入错误可能导致加入错误商品。