任何 Shopify 店铺都能跑的十分钟代理就绪自查

摘要

六个公开端点就能告诉你代理到底够不够得着你的店:两个代理文件返回 200、UCP 能力 ≥ 8 项、payment_handlers 非空、permalink 在自有域名、约十五个工具、WebMCP 标记大于 0。这些是开关,不是曲线。

在谈任何 AI 可见度策略之前,有一个前置问题,答案只有是或否:代理到底够不够得着你的店?

六个公开端点就能回答。不需要 API key、不需要账号、不需要工具。把域名换成你自己的跑一遍,大约十分钟,而结果是二元的——这在营销里几乎是绝无仅有的。

核心要点

  • 六条命令,全部是公开端点,不需要任何凭证。
  • 健康的样子:两个代理文件都返回 200、UCP 能力 ≥ 8 项、payment_handlers 非空、permalink 在自有域名上、约 15 个工具、WebMCP 标记大于 0。
  • 这些是开关,不是曲线。没有部分得分,也没有缓慢衰减。
  • Headless 构建里最常见的失败是 /agents.md 与 /llms.txt 404。
  • 第二常见、也最安静的,是 payment_handlers: {}。
The ten-minute agentic readiness audit: six public endpoints, what healthy looks like for each, and who owns the fix.
The ten-minute agentic readiness audit: six public endpoints, what healthy looks like for each, and who owns the fix.

六项探测

1 —— 代理说明文件存在吗?

curl -sI https://yourstore.com/agents.md curl -sI https://yourstore.com/llms.txt

两者都应返回 200。在 Shopify 上这是同一份文件发两次——我们做过 diff,76 行只有一行不同。任意一个 404 都是构建或托管问题,这也是 Headless 店铺最常见的发现。

2 —— 协议发现文档健康吗?

curl -s https://yourstore.com/.well-known/ucp

用 JSON 格式化之后读三件事:capabilities 下有多少项(8 项以上算正常)、payment_handlers 是填好的还是空对象、dev.ucp.shopping.permalink 指向哪里。

3 —— payment_handlers 是空的吗?

这是最安静的一项。空对象意味着在 Google 的代理结算路径上没有声明任何支付轨。其他一切看起来都正常,而这一个字段单独取消了你在对话里成交的能力。

Measured /.well-known/ucp capability list from a live Shopify store, including payment_handlers and the permalink endpoint.
Measured /.well-known/ucp capability list from a live Shopify store, including payment_handlers and the permalink endpoint.

4 —— permalink 指向自有域名吗?

如果 dev.ucp.shopping.permalink 解析到 yourstore.myshopify.com/buy 而不是 yourstore.com/buy,那么每一条代理直达链接都会在购买节点离开你的品牌域。这是配置问题,不是代码问题。

5 —— 你对外暴露了哪些工具?

curl -s -X POST https://yourstore.com/api/ucp/mcp -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

这是匿名公开的。健康的店铺会返回约 15 个工具,覆盖目录、门店、购物车、结算、订单。注意没有的那个:协商出带日期协议版本的店铺上不会有 ask_business,因为 Ask 能力仍是 UCP draft。

6 —— 页面上注册了 WebMCP 工具吗?

curl -s --compressed https://yourstore.com/ | grep -ci 'modelContext\|webmcp'

应大于 0。Liquid 店通常会有若干匹配。0 意味着浏览器内代理没有结构化工具可用,只能退回去读页面——而官方说明恰恰禁止它这么做。

健康基线

探测项

健康的样子

谁来修

/agents.md、/llms.txt

均返回 200

主题或店面构建

/.well-known/ucp

200,能力 ≥ 8 项

平台侧,通常无需处理

payment_handlers

非空对象

支付与 Markets 配置

permalink 端点

指向自有域名

域名与渠道配置

tools/list

返回约 15 个工具

平台侧

首页 WebMCP

计数大于 0

主题,或 Hydrogen 版本与 ShopifyScripts

探测之前:收录资格

如果你的店铺没有 Shopify Catalog 收录资格,上面这些都帮不上忙,因为你根本不在结果集里。门槛很低但很硬:

  • 符合 Shopify 服务条款与可接受使用政策;付费套餐;店铺不处于密码保护状态。
  • 每个商品有标题、至少一张图、价格大于 0。免费商品不进目录。
  • 商品已发布到 Online Store、Hydrogen 或 headless 渠道。
  • Settings → Policies 里的服务条款、隐私政策、退换货政策全部填写完整,并同意代理店面补充条款。
  • 渠道层面还有各自门槛:ChatGPT 与 Microsoft Copilot 面向向美国买家销售的商家(不限店铺所在地);AI Mode 与 Gemini 目前只面向部分美国本土商家。

Fall '26 在后台新增了店铺收录资格检查,它会告诉你缺什么,而不是让你猜。

怎么读结果

六项全绿,你的工作就上移一层:目录字段、主推变体评分、可抽取的文案、履约承诺。下一篇该读两套目录,两套排名逻辑。

任意一项红,先停。在协议层或结算层断掉的情况下做内容,是在提高一个没人能调用的接口的质量。优先级要自下而上——六层栈解释了为什么。

这些检查很便宜,而这恰恰是现在就做的理由。对多数品牌,代理带来的量仍然很小。不对称在于:修它只要一个下午,而半年后才发现,意味着这条通道确立规则的时期你是缺席的。

常见问题

探测自己的店需要授权吗? 不需要。六个端点按设计都是公开且免鉴权的。tools/list 刻意做成匿名可调——清单公开,调用权受控。见信任分层与 Web Bot Auth。

能拿去测竞品吗? 技术上可以,端点是公开的,这也是合理的对标方式。但要注意未签名请求适用最严格的限流,不要高频自动化。

多久重跑一次? 每次主题发版、每次迁站、每次支付或市场配置变更之后,以及无论如何每季度一次。协议版本会动;今天的结果只代表今天。

看看你的品牌在 AI 搜索里的表现

GEOly 追踪 ChatGPT、Gemini、Google AI 如何提及、引用并推荐你的品牌,帮你赢下 AI 货架。

免费开始体验

免费注册 · 无需信用卡

在 Google 中将 GEOly 设为优先来源

领先消费品牌的共同选择

Anker SOLIX
eufy
soundcore
PLAUD
xTool
Ulike
Jackery
Roborock
Dreame
EcoFlow
Insta360
TCL
Beatbot
CASETiFY
Creality
Shokz
Segway
realme

12,000+ 品牌方正在用 GEOly 追踪并赢下 AI 搜索

从 Anker SOLIX 到 xTool——以上品牌已经在 GEOly 看到 ChatGPT、Gemini、Google AI 如何提及、引用并推荐它们。你的品牌此刻也正在被 AI 谈论,注册即可查看。

免费查看我的品牌 AI 表现

免费注册 · 无需信用卡