用途:在 Shopify 店铺中对某个集合(collection)或标签(tag)下的所有商品变体批量调整价格,无需手动在后台逐个修改或导出导入 CSV。适用于全店或集合级促销、活动结束后恢复原价、传导供应商成本上涨、统一某类商品定价等场景。
主要能力:按集合 ID 或标签筛选商品;调整类型支持 percent(百分比)和 fixed(固定金额),正数为涨价、负数为降价(如 -10 表示降价 10%);可通过 min_price 设置价格下限、max_price 设置价格上限;dry_run 可在不执行变更的情况下预览;输出 CSV 文件 price_changes_<YYYY-MM-DD>.csv,包含 product_id、variant_id、sku、title、old_price、new_price 列。
使用方式:需先通过 Shopify CLI 认证(shopify auth login --store <domain>),并具备 read_products、write_products 权限。必填参数为 store 与 adjustment_type、adjustment_value,且 collection_id 与 tag 至少提供一个。技能先以 products 查询分页拉取商品及变体(每页 250,变体每次 100),再对每个商品调用 productVariantsBulkUpdate 变体批量更新 mutation,接口版本为 2025-01。可选 format=human 或 json 控制输出。
限制与注意:第 2 步的 productVariantsBulkUpdate 会立即修改线上价格,且 API 不支持批量撤销,只能逐个变体还原,因此务必先用 dry_run: true 核对 CSV 再提交;遇到 429 限流需减小批处理并指数退避重试;mutation 返回的 userErrors 会按变体记录但不中断执行,提交后建议在后台抽样核对价格。未提供其他定价、收费或平台信息。