SHEIN 希音铺货发品

概述

这条 skill 会真的往你店里写东西。 它不是拼个草稿交回给你（那是lingxiao-listing-build），它走的是完整发品：建任务 → 生图或用你的图 → 写文案 →出上架预览 → 人工确认 → 发布到你自己的希音店铺。发出去就对消费者可见。

有自己的商品图就一分钱不花。 花钱只花在生图上。

前提：店铺授权，Agent 代不了

先调 shein_shop_status，这是希音相关的第一跳。它回答三件事：这个账号的组织有没有授权过希音店铺、能不能发正式品、首次发品的风险确认签过没有。

返回 production.configured=false 表示还没绑店。这不是故障、重试没有意义——需要人去官网走一次希音授权，那是店主本人在希音后台点的：<https://www.lingxiaochuhai.com/app/tools/auto-listing?from=skill-shein>

接 MCP 要 key（希音这组是 tenant 档，读的是你自己店铺的数据）：

{ "mcpServers": { "lingxiao": {
  "url": "https://www.lingxiaochuhai.com/mcp",
  "headers": { "x-api-key": "<你的 key>" } } } }

领 key：<https://www.lingxiaochuhai.com/app/membership?from=skill-shein> 接入说明：<https://www.lingxiaochuhai.com/connect?from=skill-shein>

发品要的四个 id 都猜不出来

希音的发品体要 categoryId、productTypeId、colorValueId、sizeValueId。后两个是取值 id 而不是文字——填 "red" 或 "M" 一定失败。而且类目不能沿用别的店的，希音按店铺资质开放不同类目。

shein_categories({})                              // 类目树，找 id 用返回里的 flat
shein_attributes({ productTypeId: 1234 })         // 颜色/尺码的取值 id
shein_sites_brands({})                            // 能发哪些站点（如 shein-us）与品牌编码
shein_products({ pageNum: 1, pageSize: 20 })      // 店里在售的，查重复铺货与价格带

这四个都不花钱，而且是直接问希音，看到的就是店里当下的真实状态，没有缓存。

建任务 → 预览 → 发布

shein_listing_start({
  draft: {
    name: "Linen Wide-Leg Pants",
    categoryName: "women pants",
    brief: "夏季亚麻阔腿裤，卖给通勤白领，主打透气与显瘦",
    imageUrls: ["https://cdn.example.com/1.jpg"]   // 给了就完全不生图、不扣额度
  },
  categoryId: "...", productTypeId: "...",
  colorValueId: "...", sizeValueId: "...",
  siteCode: "shein-us", brandCode: "...",
  costPrice: "39", suggestPrice: "19.9", stock: 99,
  confirm: true
})

这一步不会把商品发到店里，它停在预览等人确认。三件事要先知道：

一、先问用户手上有没有图。 draft.imageUrls 给了公网直链就一张都不生成、一分钱不花，这是最省的一条路。手上是本地文件，用 asset_upload_ticket 换公网地址。

二、要生图就先确认能不能还原这件货。 生图会去找这件货在链接生成器里的素材集（可以用 assetSetId 直接指定），找到就按里面的商品图复刻；找不到只能照商品名画一批示意图——那种图不是用户的货，不该直接发到店里。结果里的result.assets.imageFidelity 写明了这次是哪一种，拿到预览要如实转述。

三、任务是后台跑的。 用 shein_listing_status 查 stage：

到 listing_review 之后一定要把标题、价格、图片贴给用户看过再发。发出去的商品直接对消费者可见，改回来的成本远高于多问一句。

首次发品还要过一次风险确认：把风险原话念给用户（商品会直接上架到他自己的希音店铺并对消费者可见，价格、图片、材质与合规信息由店主承担），他明确同意之后才可以调shein_listing_ack_risk。每个组织只需要一次。不要为了让流程跑通而自己替用户确认——这道闸门存在的唯一目的，就是让人在商品对外可见之前亲自点一次头。

shein_listing_publish({
  workflow_id: "...",
  previewToken: "<shein_listing_status 里 result.previewToken 的值>",
  note: "价格已与用户核对",
  confirm: true
})

previewToken 是那份预览的指纹，必须是你刚给用户看过的那一份的 token，对不上会返回 LISTING_PREVIEW_CHANGED 并拒绝发品。这一步不可逆，发出去要撤只能去希音后台。

预览里有要改的，走 revise 不要走 publish

shein_listing_publish 不能改任何字段（价格、类目、SKU 都不行）。这是刻意的：能改就会出现"人看的是一份预览、发出去的是另一份"。

shein_listing_revise({ workflow_id: "...", reason: "价格填错", suggestPrice: "24.9" })

它把任务退回、用新参数重出预览，沿用已经生成的图，不重新生图、不重复扣费。重跑也是后台的，拿到新预览再让人看一眼，用新的 previewToken 发布。

边界

• 没授权过店铺时，除 shein_shop_status 外其余希音工具都会失败。先查状态。
• 店铺信息单独取失败通常是凭证已过期，需要重新授权一次，不是"查不到状态"。
• 这组工具只碰你自己的店。组织归属由票的身份反查，没有任何入参可以指定别人的店。
• 上架成功不等于过审。类目必填属性、资质证书、图片像素以希音后台的裁决为准。
• 铺货前先跑通一条。第一条缺的 id 通常是整批共有的。