用途:pp-ucp 技能驱动 ucp-pp-cli 二进制,供智能体直接与 UCP 商户交互,例如探测商户清单、构建多商户购物车、跨已知 UCP 商店搜索,或为 AP2 授权准备结账草稿。它适合作为智能体购物流程中搜索与购买环节的本地工具;若只需 ChatGPT 侧结账或商户侧校验,则应使用其他工具。
安装与验证:可通过 npx -y @mvanhorn/printing-press-library install ucp --cli-only 安装,也可用 go install github.com/mvanhorn/printing-press-library/library/commerce/ucp/cmd/ucp-pp-cli@latest(需 Go 1.26.6 或更高版本)。验证命令为 ucp-pp-cli --version;若提示找不到命令,需确认安装目录在 PATH 中。
主要能力:check 可拉取任意域名的 /.well-known/ucp 并返回分级报告(模式有效性、声明的传输方式、能力覆盖),适用于任何发布 UCP 清单的商户,包括仅支持 MCP 的 Shopify 托管商店。mock serve 可在本地启动一个符合 UCP 的纯 Go 参考商户,使 check、search、cart、checkout prep 等流程端到端可用。
v0.1 限制:真实商户兼容性方面,check <domain> 对任何发布 /.well-known/ucp 的商户有效,但 search、cart、checkout prep 需要 REST 传输,而多数公开商户仅支持 MCP(推迟到 v0.2)。已知真实商户 checkout.coffeecircle.com 为 Shopify 托管、仅 MCP。
用法:命令支持 --agent 标志,展开为 --json --compact --no-input --no-color --yes;输出可 JSON、可 --select 过滤字段、可 --dry-run 预览、可 --deliver 投递到 stdout、file:<path> 或 webhook:<url>。认证方面无全局 API 密钥,CLI 通过 UCP-Agent: profile="<url>" 头标识,使用每智能体 ECDSA-P256 密钥签名,运行 ucp profile init 生成配置。退出码 0 成功、2 用法错误、3 资源未找到、4 需认证、5 API 错误、7 限流、10 配置错误。
MCP 安装:go install github.com/mvanhorn/printing-press-library/library/commerce/ucp/cmd/ucp-pp-mcp@latest,注册命令为 claude mcp add ucp-pp-mcp -- ucp-pp-mcp。