STORE INSPECTOR · AI 购物就绪

AI 购物助手，能找到并读懂你的店吗？

这一页讲 AI 购物助手能在一家网店上看到哪些公开文件和标记、每一项意味着什么、该怎么改。写给独立站卖家和代理商，不承诺排名、推荐或流量。

“未观察到”不等于不支持。平台可以在这些公开文件之外开启 AI 渠道，所以缺一个文件，只说明值得去核对，并不能证明助手无法从你这里下单。

扩展里的就绪检查将随 Store Inspector 0.6 推出。这份指南和扩展版本无关：它讲的是这些信号的原理和修复方法。

以上内容已于 2026-10-31 对照官方资料核对。

状态是什么意思

观察到（Observed）: 在标准公开路径找到了预期的文件或标记，并且能读取。
部分（Partly）: 找到了，但有缺口或限制，比如搜索类爬虫被整站屏蔽，或商品标记里没有标识符。
未观察到（Not observed）: 标准公开路径下什么也没找到。店铺仍可能通过别的方式支持这项能力。
无法读取（Unreadable）: 文件存在但格式不对，或请求失败、被拒绝，因此无法判断。
未检查（Not checked）: 没有可检查的对象，比如当前页面不是商品页，就没法检查商品数据。
Present / Absent: 用于页面级拒绝标记，只是提示，不计入“观察到 N/M 项”。

扩展是怎么读取这些信号的

针对你正在看的这家店，扩展向下面这些标准公开路径各发一次只读的 GET 请求，不带凭证，并限制响应大小；另外会解析同一域名下的一个商品页。它不会改动店铺。

Universal Commerce Protocol 配置（UCP）

Universal Commerce Protocol（UCP）是一个开放协议，让平台、AI 代理和商家能从发现商品一直协作到结账。规范写明：商家把自己的配置发布在 /.well-known/ucp。ucp.dev 列出的共同开发方包括 Google、Shopify 和 Walmart。

这个配置是一份 JSON。按规范，它必须有一个 ucp 对象，里面是 YYYY-MM-DD 格式的版本号、商家提供的服务和支付处理方；有能力声明时，会以 dev.ucp.shopping.checkout 这样的名称列出。规范还要求配置端点使用 HTTPS，且不要跳转。

在 Shopify 上，开发者文档说这份配置位于店铺前台，地址是 {shop}.myshopify.com/.well-known/ucp。请直接打开自己店铺的这个地址，看它实际返回什么。

路径: /.well-known/ucp
格式: HTTPS 上的 JSON，不跳转
扩展读取: 能找到的版本号和 dev.ucp.* 能力名称

Agentic Commerce Protocol（ACP）

Agentic Commerce Protocol（ACP）是 Stripe、OpenAI 和 Meta 共同创建的开放标准，用来让 AI 代理替买家和商家完成购买。它由几块组成：代理式结账、购物车与商品 feed、委托支付、委托授权，以及订单 webhook。

和 UCP 的区别：ACP 规定的是结账和支付接口，UCP 则围绕一份公开的配置文件，让商家声明自己支持什么。两者并不互斥。

扩展还会把 /.well-known/acp.json 当作可选提示来检查：在那里找到可读的配置有参考价值，没找到则几乎说明不了什么。

谁需要它：ACP 写明任何商家或 AI 平台都可以实现，商家可以搭配任何兼容的支付服务商。多数卖家是通过电商平台或支付服务商间接接入的，直接问他们是否支持、怎么开启即可。

检查的路径: /.well-known/acp.json（可选提示）
扩展读取: 该路径下是否有可读的 JSON 配置

llms.txt

llms.txt 是放在 /llms.txt 的纯 Markdown 文件，给大语言模型一份简短的、经过挑选的站点地图。它由 Jeremy Howard 在 2024 年 9 月提出，是一种约定，不是官方标准。

提议的格式是：H1 写站点名，一段引用块写简介，可以有几段不带标题的说明，然后是若干 H2 小节，每节是链接列表，每条写成 [名称](网址)，后面可以加一句说明。名为 Optional 的小节放“可以跳过”的链接。

对网店来说，适合放目录入口、运费和退货、联系方式，以及买家下单前常问的内容。ecomwith.com 自己也发布了 /llms.txt。Shopify 默认就提供一个（见下面 Shopify 的步骤）。Google 说它在搜索里的 AI 功能不需要特殊文件或标记，所以这个文件是给其他代理看的，不是给 Google AI 概览看的。

路径: /llms.txt
格式: Markdown，不是 HTML
扩展读取: 是否存在文本文件，且不是 HTML 兜底页

网店用的最小 llms.txt

# Example Goods

> Small-batch canvas bags and accessories, shipped from Portland.

Key facts a shopper or assistant often needs.

## Shop

- [All products](https://example.com/collections/all): the full catalog
- [Shipping and returns](https://example.com/pages/shipping): rates, times, return window

## Optional

- [About us](https://example.com/pages/about)

robots.txt 里的 AI 爬虫规则

robots.txt 是网站告诉爬虫“哪些能抓”的地方。AI 公司发布了好几种令牌，分工不同：训练类爬虫收集可能用于训练模型的内容；搜索类爬虫决定你是否出现在该 AI 产品的搜索回答里；用户触发的助手则是因为有人提问才去取一个页面。

区别决定了屏蔽的代价。屏蔽训练类令牌，表达的是对训练的态度；屏蔽搜索或助手类令牌，可能让该产品更少地推荐或引用你。如果搜索类爬虫被整站屏蔽，扩展会报告为“部分”。

还有两点要清楚。其一，用户触发的抓取不一定遵守 robots.txt：OpenAI 说 robots.txt 规则可能不适用于 ChatGPT-User，Perplexity 说 Perplexity-User 通常忽略，Meta 说 meta-externalfetcher 可能绕过。其二，robots.txt 只是一种请求，不是访问控制。

只退出训练

# Opt out of model training; leave search and assistant agents alone
User-agent: GPTBot
User-agent: ClaudeBot
User-agent: CCBot
User-agent: Google-Extended
User-agent: Applebot-Extended
User-agent: meta-externalagent
Disallow: /

也可以明确写出欢迎搜索类爬虫

# Say explicitly that search agents may crawl the whole site
User-agent: OAI-SearchBot
User-agent: Claude-SearchBot
User-agent: PerplexityBot
Allow: /

扩展会查找的 14 个 AI 爬虫令牌

“分组”一列沿用扩展自己的清单；“说明”一列概括了各运营方文档里的说法。

令牌	分组	说明
`OAI-SearchBot`	搜索	让网站出现在 ChatGPT 搜索里，可通过 robots.txt 控制。
`ChatGPT-User`	助手	为用户主动发起的操作取页面；robots.txt 规则可能不适用。
`GPTBot`	训练	抓取可能用于训练 OpenAI 模型的内容；禁止它表示内容不应用于训练。
`Claude-SearchBot`	搜索	用于提升 Claude 的搜索结果质量；屏蔽可能降低在其中的可见度。
`Claude-User`	助手	在 Claude 用户的问题需要时取页面。
`ClaudeBot`	训练	收集可能用于训练的内容；屏蔽后将排除之后的内容。
`PerplexityBot`	搜索	让网站出现在 Perplexity 搜索里并附带链接；不用于训练基础模型；遵守 robots.txt。
`Perplexity-User`	助手	按用户请求访问页面；通常忽略 robots.txt。
`Google-Extended`	训练	只是控制令牌，没有独立的爬虫；管理 Gemini 的训练和 grounding；不影响在 Google 搜索中的收录或排名。
`Applebot-Extended`	训练	本身不抓取；决定 Applebot 抓到的数据能否用于训练 Apple 模型；不会让你从搜索、Siri 或 Spotlight 中消失。
`Amazonbot`	搜索	用于改进亚马逊的产品与服务，也可能用于训练亚马逊模型；遵守 robots.txt。
`meta-externalagent`	训练	抓取内容以训练 Meta 模型或建立索引；可在 robots.txt 中屏蔽。
`CCBot`	训练	构建 Common Crawl 开放数据集；通过 CCBot 令牌屏蔽。
`Bytespider`	训练	字节跳动的爬虫令牌，扩展把它和训练类爬虫归为一组。

像 meta-externalfetcher 这样由用户触发的抓取器不在扩展的清单里；Meta 说它们可能绕过 robots.txt。

站点地图

站点地图列出你希望被发现的网址。只要 robots.txt 里声明了 Sitemap 行，或者 /sitemap.xml 返回 XML，扩展就算作观察到。

Shopify 说明每家店都会自动生成 sitemap.xml，包含商品、集合、页面和博客文章的链接。其他平台各不相同，请以平台文档为准。

路径: robots.txt 中的 Sitemap 行，或 /sitemap.xml
扩展读取: 响应是否为 XML

Shopify：查找站点地图

商品结构化数据

当商品页用 JSON-LD 写出 schema.org 的 Product 标记，助手回答“多少钱”“有没有货”时最稳。扩展会读当前页（如果是商品页），否则读同一域名下的一个商品页。

扩展看六个核心字段：name、image、description、price、priceCurrency 和 availability，也会报告有没有标识符（sku、gtin 或 mpn）、品牌和评分。作对照，Google 的商家商品展示文档要求 name、image、price 和 priceCurrency，建议再提供 description、availability、sku、gtin、mpn、brand 和 aggregateRating。

最常见的缺口是标识符：没有 gtin 或 mpn，商品就更难在不同来源之间对上号。

包含上述字段的商品 JSON-LD

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Canvas tote bag",
  "image": ["https://example.com/images/tote-1.jpg"],
  "description": "Heavy cotton tote with an inner zip pocket.",
  "sku": "TOTE-001",
  "brand": { "@type": "Brand", "name": "Example Goods" },
  "offers": {
    "@type": "Offer",
    "price": "24.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "112"
  }
}

页面级拒绝标记

有的网站会在 <meta name="robots"> 里加 noai 或 noimageai，请 AI 系统不要使用该页面或其中的图片。这类标记是非正式约定。作对照，Amazon 在文档里写明 Amazonbot 遵守 noarchive（不要把页面用于模型训练）和 noindex。

扩展只报告你检查的这个页面上有没有这类标记，仅作提示。要留意的副作用往往是无意中造成的：如果主题、应用或 SEO 插件把它加到了整站，你可能在不知情的情况下退出了自己想要的东西。

位置: 被检查页面上的 <meta name="robots">

按平台，具体怎么做

下面的步骤来自各平台自己的官方文档，读取于上面标注的日期，菜单名称按文档原文引用。

Shopify

Shopify 默认帮你做的比大多数平台多：自动提供给 AI 读取的发现文件，可以把商品目录同步到 AI 渠道，也会自动生成站点地图。你要做的主要是核对这些东西、补全商品数据，并决定限制什么。

1. 先看看店铺已经在提供什么

在你自己的域名下依次打开：/agents.md、/llms.txt、/llms-full.txt、/robots.txt、/sitemap.xml 和 /.well-known/ucp。不需要登录后台，扩展读取的也是这些公开网址。
Shopify 帮助中心说明：每家店都会自动提供 /agents.md，作为规范的“代理发现”网址；/llms.txt 和 /llms-full.txt 是为只认这两个路径的旧 AI 爬虫准备的。默认情况下三者内容相同：店铺名称、店铺网址、站点地图链接、店铺政策，以及其他店铺信息的端点。不需要任何第三方应用。
Shopify 开发者文档把 UCP 配置放在店铺前台的 /.well-known/ucp。请直接打开它，看你的域名实际返回什么。

2. 需要时修改 llms.txt 或 agents.md

在 Shopify 后台进入“Online Store”，打开主题的操作菜单（三个点），选择“Edit code”。点“Add a new template”，选 agents.md、llms.txt 或 llms-full.txt，点“Create template”，编辑后保存。
agents.md.liquid 会同时改变这三个网址；像 llms.txt.liquid 这样针对单个网址的模板，只覆盖它自己的那个网址。Shopify 建议：只有当 /llms.txt 必须和 /agents.md 不一样时，才另外添加 llms.txt.liquid。
模板是 Liquid（不能是 JSON 模板），可以写纯文本、Markdown 和 Liquid，但只能用 request 和 agents 对象，不能用 shop、collections 之类的全局对象。文件位于主域名下，没有语言前缀；一旦添加了模板，内容就要由你自己负责保持最新。
像上面 llms.txt 一节里那样的一份简短 Markdown，就是合法内容。

3. 决定哪些 AI 渠道可以卖你的商品

Shopify 帮助中心说，agentic storefronts（代理式店面）让顾客能在 ChatGPT、Google AI Mode 和 Gemini、Microsoft Copilot、Meta 等 AI 渠道里发现并购买商品。符合条件的店铺默认启用，同意 Agentic Storefronts 补充条款后，在“Sales channels > Agentic”里管理。
商品通过 Shopify Catalog 到达这些渠道，默认会同步每个商品的标题、描述、选项、图片、价格、库存状态和其他关键属性。Google AI Mode 和 Gemini 则改用 Google & YouTube 渠道或 Google Merchant Center。
在 robots.txt 里屏蔽 AI 爬虫，并不能阻止 Shopify Catalog 把商品数据发给你已启用的 agentic storefronts。要在代理式店面的设置里管理，而不是在 robots.txt 里。

4. 编辑 robots.txt，允许或限制 AI 爬虫

后台路径：Online Store > 主题的操作菜单 > Edit code > Add a new template > robots > Create template。Shopify 会预填默认内容；用 Liquid 增删指令，然后保存。改动立即生效，不过爬虫不一定马上反应。
保留 Shopify 的默认输出，把你的规则加在旁边。Shopify 不建议把模板整个替换成纯文本规则，因为这些规则会过时，并建议尽量使用它提供的 Liquid 对象。发布前，把渲染结果和当前的 /robots.txt 对比一下。
这属于不受支持的自定义：Shopify 客服不协助修改，并警告用错可能损失流量。先清除旧的变通办法，比如 Cloudflare 这类第三方服务。删除 robots.txt.liquid 就能恢复默认。
用 ThemeKit 或命令行改主题会保留这个文件；从“主题”页面上传主题则不会导入它。
你要加的规则就是普通的 robots.txt 行，比如上面“只退出训练”那一段。

5. 补全 AI 会读取的商品数据

条码（GTIN、UPC、EAN、ISBN）：进入 Products > 商品 > Inventory > Barcodes。每个商品或变体最多可加 20 个，GTIN 为 8、12、13 或 14 位。如果商品没有 GTIN，Shopify 说明要在 Google & YouTube 渠道里补品牌和 MPN。
Shopify 关于“为 Shopify Catalog 优化商品”的指南列出：标题、清晰详细的描述、图片、商品类型、供应商、集合和标签、条码，以及带选项名称的变体。如果标题或描述放在 metafield 里，可以用“Channel mapping”页面。
页面标记：主题可以在 type 为 application/ld+json 的 script 标签里，用 {{ product | structured_data }} 输出 Product 标记。没有变体的商品会输出成 schema.org 的 Product，有变体的输出成 ProductGroup。如果 SEO 应用也加了商品标记，请查看页面源码，确认同一个商品没有被描述两遍。

WordPress 与 WooCommerce

这里有两层。WordPress 核心负责提供 robots.txt；WooCommerce 管商品，新版本里还有一个“代理式商务”设置。llms.txt 是可选项，和 robots.txt 一样，是放在站点根目录的普通文件。

1. 先看看站点在提供什么

在你的域名下打开 /robots.txt、/sitemap.xml、/llms.txt 和 /.well-known/ucp，记下各自返回什么。再打开一个商品页，查看页面源码里的 Product 标记。

2. 编辑 robots.txt

WordPress 核心用 do_robots() 函数生成默认的 robots.txt。默认输出是一个通配符 User-agent 分组：禁止后台目录，允许 admin-ajax.php。核心提供了 robots_txt 过滤器（自 3.0.0 起）和 do_robotstxt 动作来修改它。
把下面的代码放进一个站点专用的小插件，或子主题里。改完后打开 /robots.txt 确认：如果主机商或某个插件在站点根目录放了真实的 robots.txt 文件，访客看到的就是那个文件，过滤器不会生效，这时请直接改那个文件。SEO 插件通常自带 robots.txt 编辑器，请按它们的文档操作。

用 robots_txt 过滤器屏蔽训练类爬虫

add_filter( 'robots_txt', function ( $output, $public ) {
    return $output . "\nUser-agent: GPTBot\nUser-agent: ClaudeBot\nUser-agent: CCBot\nDisallow: /\n";
}, 10, 2 );

3. 开启代理式商务（可选）

WooCommerce 文档说：进入“WooCommerce > Settings > WooCommerce AI”，打开“Enable agentic commerce”。前提是 WooCommerce 处于启用状态、账号是管理员或店铺经理、店铺和用户账号已连接 WordPress.com，并完成所选购物服务的接入，且该服务要支持你店铺的支付方式。
同一页说兼容的代理会通过店铺的 UCP 发现文档找到你。开启后，请在你的域名下打开 /.well-known/ucp，看它返回什么。

4. 补全商品数据

WooCommerce 自己关于 AI 商品发现的文章说，WooCommerce 会把许多核心商品字段映射成商品页上的 schema.org JSON-LD：标题、描述、图片、SKU、价格、币种和库存状态。更丰富的字段和变体层面的数据，可能需要扩展或自定义标记。
WooCommerce 9.2 在经典商品编辑器里新增了“GTIN, UPC, EAN or ISBN”字段，商品和变体都有。它的用法像 SKU，每个值必须唯一。填好之后，请查看页面源码，确认它出现在 Product 标记里。
品牌和评分通常来自某个扩展或你的 SEO 插件。每次改动后，都回到商品页源码里检查，应该有一个完整的 Product 块。

其他平台

同样的检查适用于任何平台，只是其中哪些由平台替你做好，各不相同。

该问什么、做什么

问问你的平台或支付服务商：有没有发布 UCP 配置、是否支持 ACP、在哪里设置。不要凭记忆手写配置，UCP 规范已经定义了结构。
robots.txt、llms.txt 和站点地图都是普通文件，能不能编辑、在哪里编辑，取决于平台。
商品标记和标识符，几乎总是你能自己改好的部分：在商品目录里补全标识符、品牌和描述字段，然后检查页面源码。

卖家常问的几个问题

我要不要屏蔽 GPTBot？

这是关于训练的决定，不是关于能不能被找到。OpenAI 把 GPTBot 描述为抓取可能用于训练其模型的内容的爬虫，禁止它表示你的内容不应被用于训练。OAI-SearchBot 是另一个令牌，管的是你会不会出现在 ChatGPT 搜索里，所以只屏蔽 GPTBot 不会让你从中消失。只有当你愿意在某个产品里被更少地推荐时，才去屏蔽它的搜索或助手类令牌。

没有 llms.txt 会怎样？

不会有什么影响。它是可选的、提议中的约定，不是硬性要求。Shopify 店铺会自动提供一个默认的 /llms.txt；其他平台想加的话可以自己加。扩展把它当作多个信号之一，缺了它只是“观察到”的数量少一项。

“未观察到”是不是说明 AI 代理没法从我店里下单？

不是。平台可以在这些公开文件之外开启 AI 渠道。把“未观察到”当作提醒，去核对平台设置即可。

这个检查会改动我的店吗？

不会。扩展只对你正在看的店铺的几个公开路径，以及同一域名下的一个商品页，各发一次只读的 GET 请求，不带凭证，并限制响应大小，不会往店铺里写任何东西。

想出现在 Google 的 AI 概览或 AI 模式里，需要做这些吗？

Google 说，它在搜索里的 AI 功能没有额外要求，也不需要特殊优化：不需要新建机器可读文件、AI 文本文件或特殊标记，关键是页面被收录，并且在普通搜索里有资格显示摘要。本指南里的这些信号，主要对其他代理和协议有意义，也对商品数据本身的质量有意义。

发布了 UCP 配置，助手就会推荐我的商品吗？

没有保证。配置的作用，是让遵循协议的代理能够发现你支持什么；助手会不会推荐你的商品，由助手自己决定。

检查你自己的店

Store Inspector 会在你的浏览器本地，读取你正在查看的这家店的这些信号，并逐项给出来源。

安装 Chrome 扩展回到 Store Inspector