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

- Canonical: https://www.geoly.ai/zh/blog/agentic-readiness-audit
- Published: 2026-10-29
- Updated: 2026-10-29
- Author: [GEOly AI](https://www.geoly.ai/zh/blog/author/geoly-ai)
- Tags: [GEO](https://www.geoly.ai/zh/blog/tag/geo), [Agentic Commerce](https://www.geoly.ai/zh/blog/tag/agentic-commerce), [Shopify](https://www.geoly.ai/zh/blog/tag/shopify), [How To](https://www.geoly.ai/zh/blog/tag/how-to), [UCP](https://www.geoly.ai/zh/blog/tag/ucp)

> **Summary:** 六个公开端点就能告诉你代理到底够不够得着你的店：两个代理文件返回 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.](https://gslkfhamqhkktynnjqng.supabase.co/storage/v1/object/public/cms-media/agentic-readiness-audit-fig1.png)

## 六项探测

**1 —— 代理说明文件存在吗？**

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

两者都应返回 200。在 Shopify 上这是同一份文件发两次——[我们做过 diff，76 行只有一行不同](https://www.geoly.ai/zh/blog/shopify-agents-md-llms-txt)。任意一个 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.](https://gslkfhamqhkktynnjqng.supabase.co/storage/v1/object/public/cms-media/agentic-readiness-audit-fig2.png)

**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](https://www.geoly.ai/zh/blog/shopify-knowledge-base-ask)。

**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 在后台新增了店铺收录资格检查，它会告诉你缺什么，而不是让你猜。

## 怎么读结果

六项全绿，你的工作就上移一层：目录字段、主推变体评分、可抽取的文案、履约承诺。下一篇该读[两套目录，两套排名逻辑](https://www.geoly.ai/zh/blog/global-vs-storefront-catalog)。

任意一项红，先停。在协议层或结算层断掉的情况下做内容，是在提高一个没人能调用的接口的质量。优先级要自下而上——[六层栈](https://www.geoly.ai/zh/blog/shopify-agentic-commerce-stack)解释了为什么。

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

## 常见问题

**探测自己的店需要授权吗？** 不需要。六个端点按设计都是公开且免鉴权的。`tools/list` 刻意做成匿名可调——清单公开，调用权受控。见[信任分层与 Web Bot Auth](https://www.geoly.ai/zh/blog/ucp-trust-tiers-bot-auth)。

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

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