用途：为 Shopify 店铺添加主题无法自行生成的结构化数据（JSON-LD），例如 Recipe、FAQPage、更丰富的 Article/Collection 节点。核心原则是只补充缺失内容，绝不重复主题已输出的 schema；meta 标签、描述与 Open Graph 属于另一技能 shopify-seo-metadata 的范围。
主要能力：将 JSON-LD 存入按实体划分的 metafield（namespace custom、key json、类型 multi_line_text_field），通过一个 Liquid snippet 原样渲染，渲染时不转换内容，因此存储值必须已是合法 JSON-LD。使用 metafieldsSet（GraphQL）写入，按 namespace/key 执行 upsert，避免 REST 重复创建 metafield 的问题。
使用方式：店铺访问有两种通道。通道 A 使用自定义应用令牌，需在 Shopify 后台创建应用并授予最小权限 read_products、write_products、read_content、write_content，令牌仅通过环境变量提供，不写入磁盘；渲染 snippet 还需主题编辑权限。通道 B 使用 Shopify CLI OAuth：shopify store auth --store $SHOPIFY_STORE --scopes read_products,write_products,read_content,write_content，再执行 shopify store execute。建议先运行 shopify version，缺失则安装；可搭配 Shopify 官方 AI 工具包插件。
适用场景：为产品页、集合页、页面、文章补充 FAQ、Recipe 等补充性 schema。
限制与注意：写入前先只读审计，抓取首页、产品页、集合页与博客文章，提取所有 application/ld+json 块，主题已覆盖的不要改动。补充 schema 必须是同页的独立类型，不能是第二个 Product 节点。两条硬性规则：不要输出裸 Product 节点（Google 要求 offers、review 或 aggregateRating），引用产品用 Thing；不要输出不完整的 VideoObject。FAQPage 对商业站点已不再产生富媒体结果，不应宣传为 SERP 可见性收益。生成内容只能断言源文本中存在的事实，禁止编造。写入后应通过 Admin API 读回 metafield 验证，而非抓取店铺前台（CDN 缓存可能延迟数分钟到数小时）。批量写入前先备份，空白 metafield 会删除值而非跳过。切勿打印或提交访问令牌。GraphQL 固定为 Admin API 2025-07，Shopify 每季度弃用版本，使用前需确认版本。