用途：分两步为 Shopify 商品做分类。第一步用 productUpdate 把商品 category 设为标准商品分类；第二步填充该分类暴露的类目元字段。第二步依赖第一步，只有商品已归入分类，类目元字段面板才存在。
主要能力：通过 Admin GraphQL 查询 taxonomy 分类及其属性与允许值；按标签、商品类型、标题/供应商、描述的优先级判定分类；对每个商品输出置信度，高置信度直接写入，模糊项（套装、跨类目等）转人工复核；按需创建保留值 metaobject 再引用；用 metafieldsSet 批量写入（每次≤25条）。
使用方式：需店铺访问权限。方式 A 用自定义应用令牌，最小权限为 read_products、write_products、read_metaobjects、write_metaobjects，令牌只放环境变量：export SHOPIFY_STORE="your-store.myshopify.com" 与 export SHOPIFY_ACCESS_TOKEN="<your Admin API access token>"。方式 B 用 Shopify CLI OAuth：shopify store auth --store $SHOPIFY_STORE --scopes read_products,write_products,read_metaobjects,write_metaobjects，再 shopify store execute。可选搭配官方 AI 工具包：claude plugin marketplace add Shopify/Shopify-AI-Toolkit 与 claude plugin install shopify-plugin@shopify-ai-toolkit。
限制与注意：分类 ID 必须对照官方 taxonomy 校验，不可猜测，猜错会静默失败；类目元字段是 shopify 命名空间下 list.metaobject_reference 类型，值为 Metaobject GID 数组，写入时不能用 TaxonomyValue GID；缺少 read_metaobjects 时相关值会返回 null；Metaobject GID 因店而异，需按店重建；Matrixify 无法创建这些保留 metaobject。写入前先只读计数预览，只填缺失值（空值会删除元字段），首批 userErrors 即中止，并通过 Admin API 回读校验，不要依赖店面（有 CDN 缓存）。GraphQL 固定为 Admin API 2025-07，最后验证日期 2026-07-05。