UCP 检查器
输入一家商店的地址,看看它的 UCP 发现文件是否真的存在——并且真的有效。
UCP(通用商务协议)是让 AI 助手替商店购物的开放标准。支持 UCP 的商店会在 /.well-known/ucp 发布一份机器可读的 JSON 配置文件——协议版本、提供的服务、接受的支付处理方,以及用于签名的公钥。本检查器通过服务器获取该文件,按官方规范中的托管与配置文件规则检查它,并探测其中声明的端点。Agent Readiness 检查器把发现文件当作众多信号之一;本工具是针对 UCP 的深度检查。配套文章什么是 UCP 以及如何检查它会手工带你读一份真实文档。
最后更新:
检查一家商店
结果
检查结果
解析后的文档
原始文档(JSON)
已复制。
没有可展示的文档——本次获取未返回可用的配置文件。
🔒 目标由我们的检查服务器获取,绝不经过你的浏览器——因此不受 CORS 限制,商店看到的是检查服务器的请求,而不是你的。你的任何信息都不会发给商店。
/.well-known/ucp 里有什么
UCP 配置文件是一个 JSON 对象,必须包含 ucp 成员。其中 ucp.version、ucp.services 与 ucp.payment_handlers 是必填的——后两者即使为空也必须存在。ucp.capabilities 是可选的,不过有用的商务配置文件通常至少声明一项。顶层的 keys[] 数组可以发布商店的公开签名密钥(RFC 7517 JWK 集)。
版本是日期,绝不是“draft”之类的词:第一个版本是 2026-01-11,最新稳定版是 2026-08-25。声明旧版本的配置文件仍可通过校验,但本检查器会发出警告并列出下面的破坏性变更——因为对方可能拒绝版本与配置文件自身不一致的条目。仍提供旧版本的商店会在 supported_versions 中列出它们,各自指向自己的版本配置文件。
在 2026-08-25 的破坏性变更中,以下几项会影响已发布的配置文件:旧的 signing_keys[] 字段被删除,改为顶层 keys[] JWK 集;履行配置被重组(标志去掉 allows_ 前缀,multi_destination 从映射改为数组);买家同意从固定布尔标志改为以反向域名标识为键的动态映射;支付扩展从 dev.ucp.shopping.* 移到 dev.ucp.common.payment.*。
托管规则很严格,因为配置文件属于信任材料:配置文件必须通过 HTTPS 提供,不得重定向(任何 3xx 都是失败),并且必须携带 Cache-Control: public 与至少 60 秒的 max-age——绝不能是 private、no-store 或 no-cache。Shopify 商店默认在 /.well-known/ucp 提供 2026-08-25 配置文件——试试演示按钮。
这个检查器能做什么——不能做什么
它在服务器上获取、校验与探测。检查器直接请求 https://<域名>/.well-known/ucp(一次请求,不跟随重定向),按本页规则校验文档,并用 HEAD 请求探测文档中声明的每个端点(HEAD 被拒绝时改用 GET)。你的浏览器从不直接联系目标,因此检查不受 CORS 限制。
它不下单、不以买家身份认证、不校验支付处理方的密码学。能通过这里的配置文件,只证明商店可以被发现、其端点可以到达——不证明结账能成功、价格正确,或支付处理方值得信任。
它不检查 ACP、AP2 或 x402 文档——只检查 UCP。声明的端点无法到达只算警告,不是错误:端点可能需要认证,而 401 或 404 响应仍算“可到达”,因为服务器作出了回应。只有彻底连接失败才算无法到达。
在信任一份配置文件之前,先对自己诚实
有效的配置文件不等于能用的结账。发现只是第一步:配置文件说明商店提供什么、端点在哪里。那些端点是否接受真实请求、返回真实价格、完成真实订单,是另一个问题,本检查器不回答它。
旧版本只警告、不失败,是有原因的。2026-04-08 的商店仍可与讲 2026-04-08 的平台交易——但只讲 2026-08-25 的平台必须拒绝版本不一致的条目,所以旧配置文件会缩小能来购物的对象范围。
404 通常意味着“这里没有 UCP”,而不是“商店坏了”。互联网上大多数网站根本不发布 UCP 配置文件——反面演示正是如此。请把缺失的配置文件看作关于商店 Agent 就绪程度的事实,而不是商店本身的错误。
关键事实
| 通用商务协议 | 让 AI 助手发现商店的商品目录、结账与售后,并代表买家交易的开放标准。 |
| 发现文件 | 发布在商店自有域名下 /.well-known/ucp 的 JSON 配置文件。 |
| 最新版本 | 2026-08-25。版本是日期;第一个版本是 2026-01-11。 |
| 必填字段 | ucp.version、ucp.services、ucp.payment_handlers——后两者即使为空也必须存在。ucp.capabilities 是可选的。 |
| 缓存规则 | Cache-Control: public 且 max-age 至少 60 秒;绝不能是 private、no-store 或 no-cache。 |
| 重定向规则 | 配置文件必须通过 HTTPS 提供且不得重定向——任何 3xx 响应都是失败。 |
| 官方规范 | Universal Commerce Protocol (UCP) Official Specification |
常见问题
为什么检查要在服务器上运行,而不是在我的浏览器里?
因为浏览器会阻止跨域读取。sysosx.com 上的页面不能直接获取另一家商店的 /.well-known/ucp——除非商店的服务器用 CORS 头明确允许,而大多数商店并不会。检查器从自己的服务器获取该文件(不受此限制),再把结果返回给你的浏览器。
我的商店在 Shopify 上——需要自己发布什么吗?
不需要。Shopify 默认在每个店面的 /.well-known/ucp 提供 2026-08-25 配置文件——试试演示按钮,它会检查 allbirds.com。如果你的商店在 Shopify 上而检查失败,问题出在别处(商店前面的重定向,或自定义域名没有指向店面)。
文档存在,但结论是“部分就绪”——先修什么?
先修复标记为“失败”的项:缺失的必填字段(版本、服务或支付处理方)、无效的 JSON 文档,或重定向。警告——缓存头低于 60 秒、旧版本、无法到达的端点——只是建议,本身不会阻止“UCP 就绪”的结论。