什么是 UCP(Universal Commerce Protocol)?给商家的解释
UCP 是让 AI 代理无需人类打开你的网站,就能发现商品、建购物车并完成结算的开放协议。这篇讲清楚你自己域名上那份能力清单里有什么、一次真实握手是怎么跑的,以及商家今天就该去看的两个字段。
定义
UCP(Universal Commerce Protocol,通用商务协议)是一套面向代理驱动商务的开放协议。它标准化了 AI 代理如何发现商家、检索商品、建购物车、准备结算、使用折扣、选择配送与查询订单。规范在 ucp.dev。它由 Google 牵头,与包括 Shopify 在内的零售方共同制定,并被设计成与 Google 的代理支付协议、代理间通信协议并行使用。
对商家来说,更有用的心智模型要简单得多:UCP 是你这家店的机器可读版本。人读的是商品页,代理读的是一个 JSON 对象;人点「加入购物车」,代理调用一个工具。任何没有出现在协议返回里的东西,在这条路径上基本等于不存在。
在 Shopify 上,协议支持由平台负责。符合条件的店铺会在 /.well-known/ucp 发布发现文档,并在 /api/ucp/mcp 提供工具。Shopify 自己的工程说明在 shopify.engineering/ucp,覆盖完整代理旅程的开发者文档在 shopify.dev/docs/agents。
先打开你自己的能力清单
在继续读理论之前,先在浏览器里打开 https://你的域名/.well-known/ucp。这是一个公开端点——不需要密钥、不需要登录。它回答四个问题:你的店协商到的协议版本是哪一版、MCP 服务端点在哪里、声明了哪些能力、支持哪些支付处理器。
其中「能力」那一栏最值得逐条读,因为它描述的是代理被允许对你做什么:商品检索与按 ID 取回、购物车、结算、配送、折扣、买家同意项、订单查询、永久链接、Shop 账号绑定,以及——有线下门店的品牌才会出现的——门店检索。标准能力之外还有一项 Shopify 自己的目录扩展。
多数商家没在看的两个字段
2026-10-31 我们从八家线上 Shopify 店面取了这份文档。有两个字段值得你关注,但理由不同。
第一个是 payment_handlers。八家全部声明了非空集合,通常是 Google Pay 加上 Shopify 自家的卡与 Shop Pay 处理器——在这个样本里它每次都通过。我们仍然把它列出来,是因为它是没人会去看的那个字段,而它一旦出问题完全不可见:空对象意味着在代理结算路径里这家店没有可用支付轨,无论目录看起来多好。去查它,但预期它会通过。
第二个是永久链接能力指向哪里——这一个确实出问题了。八家里六家解析到品牌自有域名,两家指向别处:一家 myshopify 域名,一家独立的 shop 子域。还有一家解析到区域结算子域,那是有意的配置而不是故障。当这个端点离开你的主域,代理给买家的直达结算链接就在整段旅程里意图最强的那一刻离开了你的品牌,信任、分析与品牌一致性都要跟着打折。
一次握手实际是怎么跑的
- 代理先取 /.well-known/ucp,拿到你的版本、端点与能力清单。
- 连上 MCP 端点,调用 tools/list 取回可用工具与它们的 schema。在我们的实测里这份清单匿名即可调用,返回了约十五个工具,覆盖目录、门店、购物车、结算与订单五类。
- 调用目录检索,带上查询词、买家上下文(国家、货币)与过滤条件。身份在这一步开始起作用:当我们用一个不可达的代理身份档案 URL 去调用时,检索直接以「档案不可达」报错失败,而不是返回一个更差的排名。
- 建购物车,然后创建并更新结算,解析配送方式与折扣。
- 完成结算——官方文档把它当成只许调用一次的动作——或者在资格缺失时退化为一次升级处理加一个跳转链接。
身份取代了匿名
最让 SEO 团队意外的变化是:访问权现在按身份分级,不再是只要带个 User-Agent 就能进。Shopify 在 shopify.dev/docs/agents/profiles/auth-and-rate-limiting 记录了信任分层与限流:带令牌的、已签名的与匿名的请求方拿到的能力集和限额都不同,而价值最高的动作挂在最严格的那一层后面。
两个后果随之而来。一是靠爬取来做 AI 可见度监测的工具会越来越被挡在外面,因为协议期待的是一个已签名、可公开解析的代理身份,而不是一个爬虫。二是 AI 可见度不再是纯内容问题:你的商品数据再好,一个信任层级不足的请求方根本调不动某些工具。
UCP 改变了你工作的哪几件事
- 你的商品数据变成了一份 API 返回。描述要写成扛得住被抽取的样子,而不只是扛得住说服。
- 资格变成了一道门。政策页、条款同意、商品图、非零价格、渠道发布是通过/不通过的前置条件,不是「最佳实践」。
- 结算配置变成了增长杠杆。原生结算资格与非空的支付处理器,决定代理能不能在对话里闭环。
- 协议健康度变成了监测项。能力清单与版本会漂移,一个季度截一张图不叫监测。
- 归因必须搬到服务端,因为在对话里完成的成交永远不会加载你的 thank-you 页。
想知道自己这家店的读数
上面这些检查都不需要你的后台权限——发现文档与工具清单都是公开的。如果你更愿意让人替你跑一遍、对着两套目录把结论解读清楚、并把输出变成一份排好优先级的整改清单,这正是我们 Agentic Commerce 与 AI 可见度(GEO/AEO)服务在做的事。
把域名发给我们,我们会回给你:代理当前能看到什么、调不动什么,以及补齐差距的最短路径。
常见问题
UCP 和 MCP 是一回事吗?
不是。MCP(Model Context Protocol)是模型调用外部工具的通用机制;UCP 是一套商务专用协议,定义了有哪些工具、它们接受什么、返回什么——并且把 MCP 作为自己的传输方式之一。
在 Shopify 上我需要自己实现 UCP 吗?
通常不需要。对符合条件的店铺,协议支持由平台提供。你的责任是资格、数据质量、结算配置,以及确认端点在你自己的域名上真的起来了——Headless 店面最常栽在这一点上。
我能看到 AI 代理看到的我这家店吗?
能看到一部分,而且不需要凭证。/.well-known/ucp 的发现文档和你 MCP 端点上的工具清单都是公开可读的。但真要执行一次目录检索,需要一个可公开访问的代理身份档案——这也是随手爬那一步会失败的原因。
什么都不做会怎样?
你的店对人类买家照常工作。但在代理路径上,你大概率是「能被检索到但更弱」:缺少可过滤属性、没有已发布的政策事实、可能没有对话内结算——实际结果就是代理把买家交给了那些能闭环的竞品。