Shopify 店面现已支持 UCP 位置功能， dev.ucp.common.location.search 和 dev.ucp.common.location.lookup，从 UCP 2026-08-25开始。当您在店面 MCP 端点上协商这些功能时，您的代理可以找到商家的实体门店，按名称、城市或距离进行筛选，并检查哪些门店有买家想要的商品。这是一个可选的新功能，如果您目前不使用位置功能，则无需进行任何更改。
变更内容
拥有至少一个零售位置的店面现在会在其发现配置文件的 /.well-known/ucp 中列出这两种位置功能。零售位置是商家为线下销售而设置并启用为物理店面的活跃且由商家管理的位置。
如果你的代理配置文件协商了这些功能，那么位于 https://{storedomain}/api/ucp/mcp 的店面 MCP 端点将提供两个工具：
- search_locations 用于列出商店的零售位置。返回空的 location 对象表示获取第一页结果。你可以使用匹配商店名称和城市的 query、带有明确 center 的 distance 关系以及以米为单位的 max 半径来缩小结果范围，并使用 filters.items。
- lookup_locations 通过 ID（例如 gid://shopify/Location/123）返回位置信息。它处理前 10 个不同的 ID。如果你发送更多 ID，响应中将包含一条 batch_limit_applied 消息，你可以将剩余的 ID 在另一次请求中发送。
如果商家已设置，每个位置都会包含其 id、name、address 和 geo 坐标。默认情况下搜索返回 10 个位置，当你设置 pagination.limit 时最多可返回 250 个。要获取下一页，请传递响应中的 pagination.cursor。
filters.items 最多接受 10 个产品变体 ID。仅当所有变体在该位置均有货时，该位置才匹配。可用性遵循 Shopify 现有的门店可用性规则。它不是库存数量、取货承诺或预订。
Shopify 不支持 hours 和 amenities 过滤器、自定义过滤器或 serves 关系。包含这些参数的请求将返回 invalid_input 错误，而不是忽略它们。不支持选定位置的取货结账功能。
如何设置
使用 Shopify 店面 MCP 端点并结合 UCP 2026-08-25 且协商了任一位置功能的平台和代理会受到影响。
没有零售位置的商店不会宣传这些功能或工具。未声明这些功能或协商较早 UCP 版本的集成不受影响。
操作指南
- 在你的代理配置文件中声明版本为 2026-08-25 的 dev.ucp.common.location.search 和 dev.ucp.common.location.lookup。
- 仅在商店的配置文件列出这些功能时调用位置工具。
- 仅从买家选择共享的位置发送 distance.center。Shopify 绝不会从上下文或 IP 地址推断中心位置。
- 将商品匹配视为临时结果。在告知买家商品已准备好之前，请在购物车和结账环节确认可用性和配送选项。
相关文档
- 配置代理配置文件和 UCP 协商
- 查看 UCP 位置 规范