什么是 UCP?
UCP(Universal Commerce Protocol)是 Google 在 2026 年 1 月发布的开放购物协议。它定义了 AI Agent 与电商系统之间的标准通信方式。
UCP 文件结构
UCP 配置文件位于 /.well-known/ucp,是一个 JSON 格式的文件:
{
"version": "1.0",
"merchant": {
"name": "Your Brand",
"domain": "yourbrand.com",
"merchant_center_id": "123456789"
},
"capabilities": [
"discovery",
"checkout",
"order_tracking",
"customer_service"
],
"endpoints": {
"product_catalog": "https://yourbrand.com/products.xml",
"checkout": "https://yourbrand.com/api/checkout"
}
}配置步骤
1. 创建配置文件
使用 GeoAction 的 Agent 配置生成器,填写你的商家信息,自动生成 UCP 配置文件。
2. 上传到 .well-known 目录
将生成的文件上传到你网站的 /.well-known/ucp 路径。
对于不同平台:
3. 配置 Merchant Center
如果你有 Google Merchant Center 账号,确保:
4. 验证配置
访问 https://yourdomain.com/.well-known/ucp 确认文件可访问。
然后使用 GeoAction GEO 诊断工具验证配置是否被正确检测。
能力说明
| 能力 | 说明 | 要求 |
|---|---|---|
| discovery | 商品发现 | 提供 Product Feed URL |
| checkout | 在线结账 | 实现 Checkout API |
| order_tracking | 订单追踪 | 实现 Order Status API |
| customer_service | 客户服务 | 提供联系方式 |
最佳实践
常见问题
Q: 需要 Merchant Center 账号吗?
A: 不是必须的,但有 Merchant Center 可以获得更好的商品展示效果。
Q: 文件格式必须是 JSON 吗?
A: 是的,UCP 规范要求使用 JSON 格式。
Q: 支持哪些国家/地区?
A: 目前主要在美国试点,但建议全球商家都开始准备。