用途:把 Costco 购买历史变成结构化数据。官网只按 6 个月分段展示最多 2 年收据,该 CLI 直接调用后端,可拉取任意日期范围的仓储、加油、洗车和线上订单记录,并支持本地归档与离线分析。仅只读、限本人会员账户,不能下单、改单、退货或查询未购买商品价格。
主要能力:history-depth 探测账户实际可回溯的最早收据;spend 按月/仓库/部门汇总消费;savings 统计即时优惠与优惠券;returns-window 标记仍在退货窗口内的商品;item-history 追踪某商品单价随时间变化;sync 将收据写入 SQLite,search 搜索明细,sql 执行只读查询,export 导出 JSONL/CSV。
安装与验证:npx -y @mvanhorn/printing-press-library install costco --cli-only;验证 costco-pp-cli --version。若 npx 失败,可用 go install github.com/mvanhorn/printing-press-library/library/commerce/costco/cmd/costco-pp-cli@latest(需 Go 1.26.6+)。MCP 安装:go install github.com/mvanhorn/printing-press-library/library/commerce/costco/cmd/costco-pp-mcp@latest,再执行 claude mcp add costco-pp-mcp -- costco-pp-mcp。
用法:命令加 --agent 展开为 --json --compact --no-input --no-color --yes,适合代理调用;--select 裁剪字段,--dry-run 预览,--deliver 可输出到 stdout、file:<path> 或 webhook:<url>。认证需从浏览器 localStorage 取 idToken 与 clientID,用 auth set-token 保存;令牌仅数分钟有效,doctor 可解码过期时间。路径可用 --home 或 COSTCO_HOME 重定位。
限制:只读,不处理会员注册、退货或账户变更;令牌短效需频繁刷新;未提供收费、价格或平台支持等资料。