用途:seo-ecommerce(M18)是条件式电商模块,仅在检测到电商信号(价格/货币文本、加购/购买控件、Product/Offer schema、og:type=product)时运行;否则所有 M18 发现均为 not_applicable(severity 0),不会把商品 schema 强加到非电商页面。它审计两部分:面向搜索的商品结构化数据,以及 AI 购物代理能否真正读取并操作店铺。
主要能力:检查 Product 的 name、image,Offer 的 price、priceCurrency、availability;若页面可见评分,则检查 AggregateRating/Review(不标记页面未展示的评分);比对 schema 与页面、商家 feed 的价格/货币/库存一致性;检查筛选类 URL(如 ?color=、?sort=)是否 canonical 或 noindex;多变体商品应使用 ProductGroup + hasVariant + variesBy。agentic commerce 检查包括 /.well-known/ucp 商家档案(版本为 YYYY-MM-DD、services/capabilities 结构)、按商品的目录资格(标题、图片、价格>0、可识别 URL、前台可见)、ACP 结账 feed 校验(必填字段、价格含货币如 "79.99 USD"、availability 枚举、GTIN mod-10、绝对 URL、item_id 不重复)、feed 与页面价格比对,以及 Merchant Center/平台提示。
使用方式:由调度信封指定的 PageSnapshot 工作,读取 <run_dir>/pages/<slug>.json、<run_dir>/site/discovery.json、<run_dir>/profile.json 等;无快照时可先运行 node "${CLAUDE_PLUGIN_ROOT}/scripts/snapshot.mjs" <target> --out "${CLAUDE_PLUGIN_DATA}/runs"。验证命令:node "${CLAUDE_PLUGIN_ROOT}/scripts/validate-jsonld.mjs" --snapshot <pages/<slug>.json>;node "${CLAUDE_PLUGIN_ROOT}/scripts/acp-feed-lint.mjs" --feed <path>;node "${CLAUDE_PLUGIN_ROOT}/scripts/ai-discovery.mjs" --snapshot <pages/<slug>.json>。修复分 AUTO/PROPOSED/ADVISORY,后端、feed、平台才是真相来源,工具不代写;不编造价格、评分、GTIN、端点。缺少 feed/API/商家账户时状态为 needs_api,绝不算通过。agentic 相关判断均为方向性;Shopify 上 /.well-known/ucp 等为平台默认,不代表商家作为。