TikTok/Etsy 上架字段校验

为什么商品经常在上架环节被卡住

很多团队把精力花在改文案、调主图上，最后提交时商品依然建不出来。真正的原因往往很简单：字段形状不对。类目 ID 没填、图片写成了本地路径、Etsy 的 tag 数量不对。平台面对这些错误，通常只返回一句让人看不懂的报错，或者直接拒绝。

这套校验流程的作用是把这些拦截点提前到本地。你给它一份原始商品资料，它帮你拼出符合平台形状的 draft 字段，并返回一份校验报告：

• fail：平台会直接拒收，或者字段在结构上根本拼不出来。
• warn：能成功导入，但可能会影响点击和转化。

处理顺序很明确：先清 fail，再看 warn，不要混在一起改。

它具体做了什么

以 TikTok 为例，categoryId 是必填项，缺失就无法建品。如果没提供 quantity，工具会按测款默认值 5 来处理。图片必须是公网可访问的 http(s) 绝对地址，本地路径或内网地址会被丢弃，并在校验报告里点名。

Etsy 的检查更细。标题超过 140 字符、tag 数量不是正好 13 个、单个 tag 超过 20 字符，都会被判 fail。一些不影响上架但会掉转化的写法会被判 warn，例如主关键词没进标题前 40 字符、拿店名开头、缺尺寸对比图。

关于标题排序，平台搜索读取的是标题前段，买家第一眼看到的也是前段。不要把店名放在最前面，也不要堆同义词。同一个意思换三种说法不会拿到三份权重，反而会把有区分度的词挤出可见区。

边界在哪里

这个工具只做本地拼装与校验，它不会代替你提交商品，也不连接店铺后台，不读取库存或订单。当你看到 readyToImport 为 false 时，说明字段还没拼好，不要硬送。

校验通过不代表能过审。类目必填属性、资质证书、图片像素这类信息，只有平台后台才能验证。Etsy 侧由于不连接店铺，也判不了类目、属性、变体和运费模板是否完全正确。

批量上架前，先拿一条跑通。如果第一条出现 fail，多半是整批资料都存在同一个问题。