AI Shopping Research

Shopify Global Catalog REST API 退役：迁移至 UCP 目录工具的端点映射与请求约束

Shopify 官方宣布 Global Catalog REST API 将于 2026 年 11 月 2 日停止提供流量，调用方需在此之前按官方映射迁移至实现 UCP 的 Global Catalog MCP 目录工具，但官方材料未提供该接口对商品曝光或转化的可验证效果数据。

来源性质: 平台官方一手资料
效果证据: 尚缺独立验证
发布日期: 2026-10-19
状态: 公开Research

核心事实

Global Catalog REST API 已于 2026 年 4 月被废弃，并将在 2026 年 11 月 2 日停止提供流量。[1]
停止服务后，所有发往 https://discover.shopifyapps.com/global/... 的请求都会失败，包括针对已保存目录的请求。[1]
Global Catalog MCP 位于 https://catalog.shopify.com/api/ucp/mcp，提供 search_catalog、lookup_catalog、get_product 三个 UCP 目录工具。[1]
官方列出的受影响 REST 端点包括 GET /global/v2/search、GET /global/v2/p/{upid}、GET /global/v2/p/by-variant/{vid} 与 POST /global/v2/lookup。[1]
官方给出的迁移映射为：Search 对应 search_catalog；按 upid 或变体查询对应 get_product；Bulk lookup 对应 lookup_catalog。[1]
官方说明认证方式不变，可继续使用 Dev Dashboard 客户端凭据生成 bearer token。[1]

发生了什么

Shopify 在变更日志中说明，Global Catalog REST API 于 2026 年 4 月被废弃并由 Global Catalog MCP 取代，2026 年 11 月 2 日该 REST API 停止提供流量。此后所有发往 https://discover.shopifyapps.com/global/... 的请求都会失败，包括针对已保存目录的请求。[1]

官方要求仍在调用该 REST API 的应用在 2026 年 11 月 2 日前迁移至 Global Catalog MCP：将每个 REST 调用切换到匹配的 UCP 工具，请求发送至 https://catalog.shopify.com/api/ucp/mcp，并在每个请求中包含 meta.ucp-agent.profile 与代理档案 URL。[1]

对于已保存目录的查询，官方要求将目录 ID 作为 catalog.catalog_id 传入，而不是使用已保存目录的端点 URL；同时需将应用更新为 UCP 目录请求与响应 schema。官方还提到可在迁移前通过 Shopify AI Toolkit 或 UCP CLI 的 ucp catalog search 试用这些工具。[1]

这三个能力不要混为一谈

Global Catalog MCP 目录工具

作为 REST API 的替代接口，位于 https://catalog.shopify.com/api/ucp/mcp，提供 search_catalog、lookup_catalog、get_product 三个 UCP 目录工具，分别覆盖搜索、按标识批量查询与商品详情获取。

边界：提供目录工具不等于商品会获得推荐、流量或销量；官方材料未提供该接口被哪些 AI 代理调用及其对曝光或转化影响的可验证数据。

来源 [1]

REST 端点退役与迁移映射

界定退役范围与迁移路径：2026 年 11 月 2 日后 discover.shopifyapps.com/global/... 请求全部失败，官方给出 Search、按 upid 或变体查询、Bulk lookup 到对应 UCP 工具的映射。

边界：端点映射只说明调用方式的替换关系，不证明迁移后请求会被任何特定代理使用，也不证明商品信息会因此获得分发或交易结果。

来源 [1]

UCP 代理请求约束

规定迁移后的请求形态：请求发往 MCP 端点，每个请求需包含 meta.ucp-agent.profile 与代理档案 URL，已保存目录以 catalog.catalog_id 传入，并需适配 UCP 目录请求与响应 schema。

边界：满足请求约束只表明请求符合接口规范，不证明代理会实际发起调用，也不证明调用会带来推荐位、流量或销量。

来源 [1]

官方资料分别支持什么

官方事实

Global Catalog REST API 已于 2026 年 4 月被废弃，并将在 2026 年 11 月 2 日停止提供流量。

[1]

官方事实

停止服务后，所有发往 https://discover.shopifyapps.com/global/... 的请求都会失败，包括针对已保存目录的请求。

[1]

官方主张

Shopify 称 Global Catalog MCP 实现了 Universal Commerce Protocol（UCP），并作为 REST API 的替代方案。

[1]

Xiaotu Observation

小兔观察：接入AI渠道，不等于获得AI推荐

官方材料将迁移描述为端点与请求形态的替换，并给出明确的工具映射，因此可据此判断调用方需要调整的是接口层而非认证层，认证方式官方说明保持不变。依据 [1]
官方要求每个请求包含 meta.ucp-agent.profile 与代理档案 URL，这表明迁移后的调用需要携带代理身份信息，但官方材料未说明该字段如何被使用或校验。依据 [1]
官方对已保存目录的处理要求改为传入 catalog.catalog_id，而非使用已保存目录端点 URL，说明迁移涉及请求参数结构的变化，而不仅是域名替换。依据 [1]
官方提到可在迁移前通过 Shopify AI Toolkit 或 UCP CLI 试用工具，这为调用方提供了在正式切换前验证请求形态的公开途径，但官方材料未给出试用结果与生产效果之间关系的说明。依据 [1]
官方材料未提供该 MCP 接口被哪些 AI 代理调用、调用后是否影响商品曝光或购买转化的可验证数据，因此不能从本次退役公告推断推荐、流量或销量效果。依据 [1]

当前仍缺什么证据

该 MCP 接口实际被哪些 AI 代理调用，官方材料未提供可验证的调用方清单。
调用该 MCP 接口后是否影响商品曝光或购买转化，官方材料未提供可验证数据。
meta.ucp-agent.profile 字段在服务端的实际校验与使用方式，官方材料未展开说明。
UCP 目录请求与响应 schema 的具体字段差异，官方材料仅指向文档而未在变更日志中列出。
迁移后各 UCP 工具在真实代理场景下的调用频率与覆盖范围，官方材料未提供数据。

问题与回答

Global Catalog REST API 什么时候停止提供流量？

官方事实官方说明该 API 于 2026 年 4 月被废弃，并将在 2026 年 11 月 2 日停止提供流量；此后所有发往 https://discover.shopifyapps.com/global/... 的请求都会失败，包括针对已保存目录的请求。

来源 [1]

迁移后应该把请求发到哪里，需要包含什么？

官方事实官方要求将请求发送至 https://catalog.shopify.com/api/ucp/mcp，并在每个请求中包含 meta.ucp-agent.profile 与代理档案 URL；查询已保存目录时应传入 catalog.catalog_id，而不是使用已保存目录端点 URL。

来源 [1]

REST 端点与 UCP 工具如何对应？

官方事实官方映射为：Search（/global/v2/search）对应 search_catalog；按 upid 查询（/global/v2/p/{upid}）与按变体查询（/global/v2/p/by-variant/{vid}）对应 get_product，并传入 gid://shopify/p/{upid} 或 gid://shopify/ProductVariant/{id}；Bulk lookup（/global/v2/lookup）对应 lookup_catalog。

来源 [1]

迁移后商品是否一定会获得推荐、流量或销量增长？

基于证据的分析不能据此推断。官方材料只说明接口替代与请求约束，未提供该 MCP 接口被哪些 AI 代理调用、调用后是否影响商品曝光或购买转化的可验证数据；平台宣布接入能力不等于商品必然获得推荐，也不证明销量增长。

来源 [1]

官方来源

[1] Global Catalog REST API stops serving traffic on November 2, 2026Shopify · 2026-10-09T16:00:00+00:00