将 SHEIN Seller MCP 连接到 Gemini CLI

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

SHEIN 卖家 + Gemini

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

前提条件

请查看连接器中包含的完整设置说明（在选择连接器时可在应用内商店中查看）。此连接器所需的环境变量为：

SHEIN_API_HOST, SHEIN_APP_ID, SHEIN_APP_SECRET

第一步 — 获取凭证

你需要的：一个类型为 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 whitelist：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_upload_tracking_numbers。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）。

第二步 — 安装适配器

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

第三步 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list）— anythingmcp 应显示为已连接。
4. 开始输入提示 — Gemini CLI 现在可以调用 SHEIN 卖家 的工具。

可用工具

示例提示

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

常见问题

我需要粘贴商店密钥或令牌吗？ 不。你需要粘贴经过批准的 SHEIN 应用的 App ID 和 App Secret，然后点击 Authorize with Provider。SHEIN 的页面会要求商店的主账户进行批准，连接器会自行获取并存储商店的密钥。当授权结束时，再次点击 Authorize with Provider。

适用于哪些商店？ 订单、跟踪、库存更新和退货适用于自营和半管理商店；价格只能由自营商店设置。产品、类别、品牌、站点和库存读取也适用于完全管理的商店。选择你的应用类型的 API 地址：openapi.sheincorp.com 适用于自营和半管理，openapi.sheincorp.cn 适用于完全管理。SHEIN 仅接受来自应用白名单上地址的调用；在 AnythingMCP Cloud 上，设置页面会显示要添加的地址。

哪些工具安装时关闭？ shein_confirm_out_of_stock，用于取消订单行，shein_set_skc_shelf_status，用于下架产品，以及 shein_sign_return_order，用于确认退货。连接器中没有任何内容涉及资金转移、支付物流或决定售后案例。

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器登录页面
• 连接到 Claude