SHEIN Seller MCP 服务器：订单、库存与物流

💡 不需要安装？直接使用 cloud.anythingmcp.com。 登录，点击 Connectors → SHEIN Seller，粘贴 App ID 和 App Secret，点击 Authorize with Provider，并使用 SHEIN 商店的主账户进行批准，生成 MCP API 密钥，完成设置。无需 Docker，无需 git clone，无需本地服务器。

SHEIN 卖家

让你的 AI 与你的 SHEIN 卖家商店协作：订单、买家地址和跟踪上传、包裹跟踪、带有价格和库存的产品、库存和价格更新、类别和属性、售后案例和退货。

设置

你需要的：一个类型为 Seller Self-Developed 的 SHEIN 开放平台开发者账户（使用商店的商户信息进行验证），一个经过批准的商店合作模式应用，以及商店的主账户以进行批准。大约需要 20 分钟的工作，加上 SHEIN 对账户和应用的审核。

1. 在 https://open.sheincorp.com 注册，选择开发者类型 Seller Self-Developed 并提交所需的商户信息（所有信息都在卖家后台）。一旦批准，类型无法更改。
2. 在控制台打开 Application Management 并创建一个应用。选择商店合作模式的应用类型：Self-Operated 或 Semi-Managed（一个商店在多种模式下需要为每种模式创建一个应用）。名称、图标和描述会显示给卖家，提交后无法编辑。SHEIN 会审核该应用；在获得批准之前，没有有效的 App ID 或 App Secret。
3. 在应用的详细信息页面检查 API Permission Package：必须订阅订单、产品、库存、售后和退货 API（通常在批准时授予；否则点击申请权限包）。将此服务器的出站 IP 地址添加到应用的 IP 白名单：SHEIN 拒绝来自其他地址的生产调用（openapi00002）。在 AnythingMCP Cloud 中，设置页面会显示该地址。
4. 将 App ID 复制到 SHEIN_APP_ID，将 App Secret 复制到 SHEIN_APP_SECRET，并为 SHEIN_API_HOST 选择 API 地址：自营和半托管应用使用 https://openapi.sheincorp.com，全托管、SHEIN 操作和其他应用使用 https://openapi.sheincorp.cn。
5. 安装连接器并点击 Authorize with Provider（设置指南的最后一步会执行此操作）。SHEIN 的页面会打开：使用商店的 主账户 登录卖家后台并点击授权按钮。SHEIN 会将浏览器返回到 <SERVER_URL>/api/shein-auth/callback（在 AnythingMCP Cloud 中为 https://cloud.anythingmcp.com/api/shein-auth/callback），连接器会在 SHEIN 允许的 10 分钟内获取商店的密钥。

商店密钥：SHEIN 会提供商店的 openKeyId 和 secretKey（secretKey 使用 App Secret 加密，AnythingMCP 解密一次）；两者都以加密形式存储在连接器中。SHEIN 没有文档说明它们的有效期和续期。当卖家解除应用绑定或重置密钥、商店关闭、SHEIN 重置或解除绑定，或密钥过期时，授权结束：调用会失败并返回 openapi00004（“用户已过期”），连接器会显示需要新的授权，某人再次点击 Authorize with Provider。

如何签名：每个调用都携带 x-lt-openKeyId、x-lt-timestamp（Unix 毫秒）和 x-lt-signature：五个随机字符后跟 openKeyId&timestamp&path 的小写十六进制 HMAC-SHA256 的 Base64，使用 secretKey 加上这五个字符作为密钥。查询不需要签名。时间戳有效期为 5 分钟，因此服务器时钟必须正确。

从哪里开始：shein_get_store_info 检查授权并命名商店；shein_list_sites 提供站点代码和货币。

• 订单：shein_list_orders（最多 48 小时的时间窗口是强制的），然后 shein_get_orders 一次最多获取 30 个订单。只有库存模式为 3 的订单由卖家发货；printOrderStatus 为 1 表示订单现在可以处理。
• 自行发货：shein_get_order_address（handle_type 2 也会将订单移至发货状态），shein_list_warehouse_addresses、shein_list_shipping_channels，然后按件上传跟踪号码（goodsId）。shein_get_logistics_track 跟踪包裹。当承运人扫描包裹时，SHEIN 会标记订单为已发货。shein_confirm_out_of_stock 在安装时关闭。
• 产品：shein_search_products（代码、上架状态、价格、库存和活动锁定）、shein_list_products（所有代码）、shein_get_product（一个完整的 SPU）。对于新上架：shein_get_category_tree、shein_get_attribute_templates、shein_list_brands。shein_set_skc_shelf_status 在安装时关闭。
• 库存和价格：shein_list_warehouses、shein_get_stock、shein_update_stock（每行使用一个幂等性密钥）、shein_update_prices（提价可能需要等待 SHEIN 的价格审核）。shein_get_sku_sales 提供管理商店的销售单位。
• 售后：shein_list_after_sales_orders 和 shein_get_after_sales_orders，shein_list_return_orders 和 shein_get_return_orders 仅供读取；shein_sign_return_order 在安装时关闭。

代码、时间和金额：SPU、SKC 和 SKU 代码（spuName、skcName、skuCode）是 SHEIN 的；supplierCode 和 supplierSku 是卖家自己的。一个多次销售的 SKU 每件都有一个 goodsId，跟踪号码、取消和退货收据按 goodsId 处理。goodsId 值为 64 位数字：连接器将每个过长的 ID 作为文本读取，保持其确切数字，工具将 ID 作为文本处理并将其作为数字发送给 SHEIN，因此请准确复制它们，正如订单或退货所示。订单、售后和退货窗口为北京时间（UTC+8），格式为 yyyy-MM-dd HH:mm:ss；订单详情的响应格式为 yyyy-MM-dd'T'HH:mm:ss.SSSZ，跟踪事件为 Unix 毫秒。金额为小数，单位为旁边命名的货币（orderCurrency、currency、currencyCode）。

限制：每个 API 对每个应用都有自己的每秒调用限制（产品搜索为 20，其他为 30 到 300），超出时返回 openapi00006 或 832213。订单和退货列表每页 30 个，产品搜索每页 10 个；一个订单窗口最多返回 10,000 个订单，产品列表最多返回 50,000 个代码。相同的 SKC 和站点每 20 分钟只能更改一次上架状态。

响应和错误：SHEIN 的响应 code 为 "0" 且结果在 info 中；任何其他 code 都是错误，包含 msg 和一个 traceId，需在三天内引用给 SHEIN 支持。连接器请求英文消息（language: en）。openapi00001：签名被拒绝；如果服务器时钟正确，这意味着商店密钥已更改（重新授权或在其他地方重置），因此请再次授权。openapi00002：此服务器的 IP 地址不在应用的白名单中。openapi00003：应用没有此 API 的权限，API 不适用于商店的模式，或开发者账户被禁用。openapi00004：授权已结束；请再次授权。写入调用返回列表时，响应 code 为 0，并命名被拒绝的行（failedList、failure_results 或 info）。

先决条件：SHEIN_API_HOST、SHEIN_APP_ID、SHEIN_APP_SECRET

本地安装连接器

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

打开 http://localhost:3000/connectors/store，选择 SHEIN Seller 并粘贴在先决条件下列出的环境变量。

可用工具

示例提示

• “我现在可以处理过去 24 小时内的哪些 SHEIN 订单？”
• “为订单 GSH12345678901 的两个件上传 UPS 跟踪号码 1Z999AA10123456784。”
• “我的哪些 SKU 库存少于 10 个？”
• “将 SKU 代码 I8xk2m4p0q 在我的主仓库的库存设置为 60。”
• “本周有哪些退货订单和售后案例进来，买家说了什么？”

下一步

• 连接到 Claude
• 连接到 ChatGPT