Skip to main content
Glama
shein-seller-mcp

shein-seller-mcp

by mrsxs

shein-seller-mcp

SHEIN seller MCP server + CLI built on the official SHEIN Open Platform API (no browser scraping). Covers every documented Open API (238, read and write) through a bundled catalog + generic call (writes need explicit confirmation), plus dedicated tools for compliance-label / real-photo requirements, label printing, real-photo upload, SKU sales, inventory, purchase orders and finance reports. Zero dependencies, Node ≥ 22.

基于 SHEIN 开放平台官方接口 的卖家 MCP 服务 + 命令行:全部 238 个文档接口(读和写)都能调(内置接口目录 + 通用调用,写操作要确认),常用的有专门工具:合规实拍图要求、打印合规标签(PDF)、上传绑定真实实拍图、SKU 销量、库存、采购单、报账单。零依赖,Node ≥ 22。

只主动调接口,不用 Webhook,不需要公网服务器。

准备

  1. 在 SHEIN 开放平台 建应用并审核通过,订阅要用的权限包(商品合规资质、采购单履约、库存同步、销量查询、账单接口等)。

  2. 本机配置目录 ~/.config/shein-open/(目录 700、文件 600;SHEIN_OPEN_DIR 可改):

    mkdir -p ~/.config/shein-open && chmod 700 ~/.config/shein-open
    # 应用 APP ID;apiHost:全托管 / SHEIN 自营用 .cn,半托管 / 自运营用 .com
    echo '{"appId":"你的 APP ID","apiHost":"https://openapi.sheincorp.cn"}' > ~/.config/shein-open/app.json
    # APP Secret(应用详情页「查看」)
    pbpaste > ~/.config/shein-open/app-secret.txt
    chmod 600 ~/.config/shein-open/*
  3. IP 白名单:开放平台「开发套件 › IP白名单」加上本机出口 IP。注意走代理时出口 IP 可能不是宽带 IP(openapi.sheincorp.cn 在国内,一般直连)。

  4. 店铺授权:店铺主账号在 Chrome 登录 SHEIN 卖家后台,Chrome 打开 chrome://inspect/#remote-debugging 允许远程调试,然后:

    npx -y shein-seller-mcp auth-watch --name 店铺名

    会在 Chrome 打开授权页,点「确认授权」后自动换取并保存店铺密钥(stores.json)。多家店:切换卖家后台店铺后再跑一次。 授权以最新一次为准,不要在多台电脑上重复授权同一家店;其他电脑用同一份配置文件(私下传)。

请求头 language 默认 zh-cn(商品发布规范、分类属性等接口必填;合规类文档里写的 CN 在商品类接口会报错,zh-cn 全部接口都认)。要别的语种:环境变量 SHEIN_LANGUAGE、app.json 的 language,或 shein_api_call 的 language 参数。

Related MCP server: Amazon Seller MCP

接入 MCP 客户端

{
  "mcpServers": {
    "shein-seller": { "command": "npx", "args": ["-y", "shein-seller-mcp@latest"] }
  }
}

Accio:设置 → MCP → 添加本地服务,命令 npx,参数 -y shein-seller-mcp@latest。

工具

工具

内容

shein_stores

已授权的店铺(不含密钥)

shein_label_status

哪些 SKC 的实拍图里还缺必须体现的信息(外包装 / 商品本体、站点、审核状态、驳回原因),按缺得最多的汇总;全店分段查(offset / max_skcs,返回 nextOffset)

shein_label_templates

SKC 可用的标签模板(环保标、GPSR、条码合并、欧洲通用…)

shein_label_materials

环保材料清单(打环保标用)

shein_label_print

打印合规标签,下载 PDF 到本机(不改店铺数据)

shein_photo_check

检查实拍图:格式、≤10MB、≤8000px、每个 SKC ≤15 张,不上传

shein_photo_bind

上传实拍图并绑定 SKC(会改店铺数据,要 confirm: true)

shein_sales

每个 SKU 的今日 / 昨日 / 近 7 天 / 近 30 天销量

shein_stock

库存(PI SHEIN 仓实物 / VI 虚拟 / JI JIT):总、可用、锁定、在途

shein_purchase_orders

采购单(备货单 / 急采单),≤60 天

shein_finance_reports

报账单:结算状态、按币种合计

shein_api_search

在全部 238 个官方接口里按关键词 / 分类 / 读写找接口(路径、方法、适用合作模式、是否只读)

shein_api_doc

实时读某个接口的官方文档:请求参数(类型、必填、含义)、返回字段

shein_api_call

调用任意官方接口(读和写)。读接口直接调;写接口不带 confirm: true 只返回将要发送的请求,不发送;支持上传文件(files)和带变量的路径

全部 238 个接口的读写分类、适用合作模式、对应工具和官方文档链接见 API.md。

明细写到本机 JSON / PDF:~/Documents/SHEIN数据/<店铺>/、~/Documents/SHEIN标签/<店铺>/(SHEIN_OUTPUT_DIR 可改)。

实拍图

实拍图用来证明合规标签真的贴在商品 / 包装上:平台会自动识别图里的信息和图物是否一致,异步审核。

  1. shein_label_status 找出缺信息的 SKC → 2. shein_label_templates + shein_label_print 打出标签 → 3. 贴到商品 / 外包装上,拍真实照片 → 4. shein_photo_check → 5. 用户确认后 shein_photo_bind(confirm: true)→ 6. 过一阵用 shein_label_status 复查。

只上传真实拍摄的照片。 本工具不生成、不合成、不修改图片;假图会被驳回,还可能导致商品被下架。

命令行

同一个命令带子命令就是命令行(输出 JSON):

npx -y shein-seller-mcp stores
npx -y shein-seller-mcp labels status --store 店铺 [--skc a,b] [--offset 0 --max-skcs 80]
npx -y shein-seller-mcp labels print --store 店铺 --skc X --type 5 --code 模板 --sku-code SKU --origin-country China --materials 6:66
npx -y shein-seller-mcp photos bind --store 店铺 --skc X --package a.jpg --apply
npx -y shein-seller-mcp data sales|stock|orders|finance --store 店铺
npx -y shein-seller-mcp call /open-api/goods/searchProduct --store 店铺 --json '{"pageNum":1,"pageSize":10}'
npx -y shein-seller-mcp --help

安全

  • 密钥只在 ~/.config/shein-open/(权限太宽会拒绝读取),不进 MCP 配置、不打印;报错里会遮住密钥、openKeyId 和授权临时码。

  • 读写分开:内置只读清单(查询 / 打印标签条码)之外的接口一律当作会改店铺数据——MCP 要 confirm: true、命令行要 --apply 才发送,不带时只预览;写操作断线不自动重试(不知道服务器有没有执行过),只读接口断线自动重试 2 次。

  • 让 AI 调写接口前,应先把「哪家店、改什么、改成什么」给人确认(工具说明里已要求)。

  • 命令行不认识的参数直接报错。

已知限制(实测)

  • skc-label-list 一次最多 10 个 SKC;全店 200 个 SKC 约 2 分钟(MCP 里分段查)。

  • material-quality-tree-v2 只能 GET;采购单查询至少要一个筛选条件(按更新时间)。

  • 库存接口不返回没有库存记录的 SKC(输出里单独计数,不当成 0)。

  • 流量、转化、广告、热搜词开放平台没有。

开发

npm test                            # 不连网,用自造数据
node scripts/build-catalog.mjs      # 开放平台加了新接口时刷新 lib/catalog.json(在线拉目录和每个接口的文档)

新接口默认当作「写」(要确认);确认是只查不改的,加到 lib/endpoints.mjs 的只读清单。

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    • Hosted MCP server for 3Dsellers, the multichannel selling platform. Connect Claude, ChatGPT, Cursor, VS Code or any MCP client and manage your eBay, Amazon, Walmart, Etsy, Shopify, WooCommerce and TikTok Shop stores in plain language: search and update products, publish listings, sync inventory, tag and track orders, run bulk actions and CSV imports, and reply to customer messages. 120+ tools. Sign in with OAuth or a personal token. No eBay developer account and nothing to install. Setup guides and config examples for every client: https://github.com/3dsellers/ebay-mcp-server

      https://api.3dsellers.com/mcp
    • Amazon Seller Central, Ads and Vendor Central in ChatGPT & Claude. 106 tools; writes need approval.

      https://mcp.vendooly.com/mcp
    • Connects Amazon Seller Central and Amazon Advertising to any MCP client. Settlement-accurate P&L - every fee, refund and reimbursement as Amazon posted it - plus contribution margin and breakeven per product, per marketplace, per day. Full Sponsored Products, Brands and Display management: search terms, placements, keyword and competitor research, dayparting, automation rules. 110 tools: 78 read-only (P&L, PPC at every grain, SQP/Brand Analytics, inventory, forecasting), 28 staged writes (every change is a proposal you review and confirm before it reaches Amazon - there is no autonomous-write mode), and 4 confirmation & support tools. 4 additional AI Workforce tools appear once a client is connected.

      https://www.amz-vault.com/mcp
    • One MCP endpoint for 414 data APIs across 90 platforms, including TikTok, Instagram, YouTube, Amazon, Xiaohongshu (RedNote) and Douyin, plus 17 web search tools and CAPTCHA solving for 52 types. Pay per call from $0.56 per 1,000 calls; failed or empty calls are not charged.

      https://api.everyinfra.com/mcp

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides full access to the Etsy Open API v3 for both buyer browsing and seller shop management through 37 specialized tools. It enables users to manage listings, process orders, handle shipping, and access inventory data via secure OAuth 2.0 authentication.
      41
      13
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables managing Amazon seller listings, orders, pricing, inventory, and reports through the SP-API via MCP tools.
      15
      26 npm
      4
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables searching Taobao products, retrieving item details, and turning listings or official campaign pages into affiliate promotion links, Taobao share codes (淘口令), and short URLs. It calls the official Taobao Alliance open API directly with your own AppKey, requiring no third-party wrapper services, so agents can generate commission-earning shopping links on demand.
      1
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents, scripts and REST clients to run 51 Pirate Ship operations — USPS and UPS rates, draft labels and batches, label downloads, SCAN Forms, shipments, tracking, reports and store orders — against your own signed-in Chrome session. It is self-hosted for personal use and omits the six tools that spend or refund money.
      2
      51
      84 PyPI
      6
      Elastic 2.0