woo-agent-storefront

Woo Agent Storefront

描述

将 WooCommerce 商店打造为适配 Agent 的店面：提供始终最新的商品 Feed、商店的 llms.txt、平台注册引导，以及带来源归因的购物车链接。

AI 助手会向数百万购物者推荐商品，而它们只能销售自己能读取的商品。本技能会带你走完整个流程：配置并生成平台实际接收的格式的 Feed（Google Shopping XML、OpenAI/ChatGPT JSONL、Meta CSV、Pinterest CSV、TikTok CSV、通用 CSV），在注册任何内容之前根据各项规范验证 Feed，在网站根目录提供商店的 llms.txt，引导商家完成各个平台的注册（包括有准入门槛的平台），最后生成带签名的购物车链接，并将订单归因到对应的 Agent 来源。

需要 Respira WooCommerce Add-on v3.1+。

---

触发语句

用户说出以下任意内容时，本技能会触发：

• “让我的商店对 ChatGPT 可见”
• “设置商品 Feed”
• “WooCommerce Google Shopping Feed”
• “为我的商店启用代理式购物”
• “让我的商店适配 Agent”
• “通过 AI 助手销售”
• “OpenAI 商品 Feed”
• “将商品提交到 Google Merchant Center”
• “为我的商店创建 llms.txt”
• “TikTok 目录 Feed” / “Pinterest 目录 Feed” / “Meta 商品 Feed”
• “为 AI Agent 创建购物车链接”
• “Agent 店面”

**不要在以下情况触发：**仅修复目录内容，且不涉及商品发现或 Feed（这属于 woo-catalog-perfection）、一般 SEO 请求，或未使用 WooCommerce 的商店。

---

执行工作流

第 1 步：确认功能可用

调用 respira_get_site_context 确认连接，然后调用 woocommerce_get_feed_status。如果缺少 Feed 工具，说明商店使用的 Add-on 版本早于 3.1：停止操作，并告知用户先更新 Respira WooCommerce Add-on。

第 2 步：检查目录基线

运行 woocommerce_validate_feed，并指定 google（规范要求最严格）。用通俗语言报告评分和未通过的检查项。如果评分低于 70，建议先运行 woo-catalog-perfection 技能，并询问是否仍要继续：平台会拒绝单条记录，而不是整个 Feed。

第 3 步：配置

询问用户关注哪些平台（默认：Google + OpenAI + 通用 CSV；也可提供 Meta、Pinterest、TikTok）。然后调用 woocommerce_configure_feed，并设置：

• 根据回答设置 enabled_formats
• 除非网站已有 llms.txt，否则设置 llms_txt: true
• cadence：大多数商店设为 daily；价格或库存频繁变动的商店设为 hourly（注意：OpenAI 建议频繁刷新，这需要真正的服务器 cron，而不是 wp-cron）
• include_out_of_stock：保留默认值 true（平台更倾向于保留标记为缺货的记录，而不是让记录消失）

使用 woocommerce_set_feed_category_mapping，将商店的顶级商品分类映射到 Google 的分类体系。该工具会列出尚未映射的分类项；优先映射数量最多的分类。

第 4 步：生成并验证

运行 woocommerce_generate_feed，然后反复调用 woocommerce_get_feed_status，直到每种已启用格式都显示有记录且时间戳为最新。分别获取每个公开 URL 一次，并确认它返回了内容（先检查美化 URL；如果主机拦截未知路径，再检查 /wp-json 回退地址）。确认网站根目录下的 /llms.txt 可正常访问。原样呈现状态中的任何 cron_warning，并说明解决方法（设置真正的 cron，访问 wp-cron.php）。

步骤 5：向各个平台注册

向用户提供每个平台的确切 feed URL，并附上简短的注册步骤：

• Google Merchant Center：产品 → 数据源 → 添加产品来源 → 使用 google.xml URL 定时抓取。Bing Merchant Center 接受相同的文件。
• OpenAI / ChatGPT：前往 chatgpt.com/merchants 申请商品发现功能；他们会抓取 openai.jsonl URL 中的 feed。Instant Checkout 需逐个商家审批；商品发现则可直接申请。
• Meta Commerce Manager：目录 → 数据源 → 数据 feed → 使用 meta.csv URL 定时抓取。
• Pinterest：商业中心 → 目录 → 使用 pinterest.csv URL 添加数据源。
• TikTok：Seller Center → 产品 → 使用 tiktok.csv URL 上传目录。TikTok 要求为每件产品填写品牌；如果缺少品牌，feed 会回退使用店铺名称，但填写真实品牌更容易匹配。

将这些内容整理成清单，方便商家之后自行完成；这些平台的控制面板都无法通过 MCP 访问。

步骤 6：AI 爬虫访问权限

运行 woocommerce_catalog_ai_readiness，并检查 robots/AI 爬虫部分。如果 robots.txt 中屏蔽了 GPTBot、OAI-SearchBot、Google-Extended 或 PerplexityBot，准确告知用户具体哪一行屏蔽了哪个助手，以及移除该行会产生什么效果。未经明确批准，不要编辑 robots.txt。

步骤 7：带来源归因的购物车链接

端到端演示整个流程：使用 woocommerce_create_cart_link 创建一个购物车链接（包含两件真实产品，来源标签如 chatgpt），说明该链接会在服务端填充购物车，并将用户带到店铺自己的结账页面；再展示如何通过 woocommerce_agent_orders_report 查看相关数据。结账、付款和客户数据都保留在店铺内。

步骤 8：报告

结束时列出：已启用的格式及其 URL、目录评分、已映射/未映射的类别、llms.txt 状态、每个平台的注册清单及已完成/待处理事项，以及示例购物车链接。

---

安全

• Feed 生成过程只会读取目录；它只写入自身的选项行和 feed 文件。
• 未经用户明确批准，切勿在此技能中编辑 robots.txt、价格或产品；内容修复应交由 woo-catalog-perfection 处理。
• Feed URL 包含无法猜测的令牌。请将其视为能力 URL：仅分享给平台，不要发布在公开帖子中。