如何通过 MCP 将 Shopee Seller 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Shopee Seller、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Shopee Seller + Gemini

让你的 AI 操作你的 Shopee 店铺：商品和规格、订单、物流与跟踪、退货、订单收入、折扣活动和广告数据，并可按需更新库存和价格。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

SHOPEE_HOST, SHOPEE_PARTNER_ID, SHOPEE_PARTNER_KEY

步骤 1 — 获取凭证

首次设置大约需要 15 分钟，另外还要等 Shopee 审核新应用。你需要一个自己的 Shopee 开放平台应用，以及该店铺的卖家账号。

1. 登录 open.shopee.com，完成开发者注册，然后打开 Console → App List，为你自己的店铺创建一个应用（例如 Seller In House System 类型）。新应用上线前需要通过 Shopee 审核。
2. 在应用的编辑页面，把 Test Redirect URL Domain 和 Live Redirect URL Domain 都设为你的 AnythingMCP 地址：AnythingMCP Cloud 填 https://cloud.anythingmcp.com，自托管则填你自己服务器的地址。回调到其他域名的授权会被 Shopee 拒绝。
3. 把应用的 Partner ID 复制到 SHOPEE_PARTNER_ID，把 Partner Key 复制到 SHOPEE_PARTNER_KEY。正式应用和测试应用的密钥不同：请使用与主机对应的那一对。
4. 设置 SHOPEE_HOST：正式店铺（东南亚、台湾、拉美及其他市场）用 https://partner.shopeemobile.com；应用由巴西提供服务时用 https://openplatform.shopee.com.br；中国大陆开发者用 https://openplatform.shopee.cn；使用测试密钥和沙盒测试店铺时用 https://openplatform.sandbox.test-stable.shopee.sg（或 https://partner.test-stable.shopeemobile.com）。
5. 安装连接器，打开它并点击 Authorize with Provider。在 Shopee 上用 店铺账号 登录（主账号或商户账号会被拒绝），选择店铺和授权期限并确认。然后运行 shopee_get_shop_info：它会显示店铺、所在地区、状态以及授权到期时间。

令牌会自动续期：访问令牌有效期约 4 小时，会自动续期。背后的刷新令牌有效期约 30 天，因此超过这段时间无人使用的连接器，或在 Shopee 卖家中心被取消授权的连接器，需要重新授权。连接器会提示这一点，所有者会收到一封邮件，点击 Authorize with Provider 即可恢复。

Partner Key 只留在 AnythingMCP 中：每次调用都用它签名，密钥本身从不发送。签名有效期为 5 分钟，所以如果自托管服务器的时钟不准，Shopee 会返回 error_sign。

可读取的内容：店铺及其公开资料；包含名称、SKU、类目、状态、价格、库存、图片、重量和物流信息的商品，以及销量、浏览量、点赞和评分；商品的规格（颜色、尺码等）及其各自的价格和库存；包含买家、商品、金额、付款方式、承运商、包裹和地址的订单；尚待发货的订单；订单的交接方式（上门取件时段和自送网点）、物流单号和物流轨迹；你的物流渠道；包含原因、买家照片和退款金额的退货退款申请；扣除佣金、各项费用、运费和优惠券后每笔订单的实际收入；你的折扣活动；以及 Shopee 广告余额和 CPC 广告的每日数据（曝光、点击、花费、订单、GMV 和 ROAS）。

时间窗口：Shopee 每次最多返回 15 天内的订单和退货，所以查询整月时 AI 会分两次查询再汇总。广告数据每次最多一个月，且只限最近 6 个月。

安装时关闭：shopee_update_stock 和 shopee_update_price。它们会修改线上店铺：库存会被覆盖（不能低于订单已占用的数量），新价格立即生效，正在进行的活动保留各自的价格。管理员可以有意识地开启它们，即便开启后，AI 也会逐个展示商品或规格的新旧数值，等你同意后再执行。

不涉及资金操作：没有任何工具会发货、取消订单、退款、回复买家或创建活动。安排发货、处理退货和回复买家仍在 Shopee 卖家中心完成。

限制：Shopee 按应用限制调用次数。遇到 error_rate_limit 或 429 时，AI 会等一分钟再重试。广告相关工具需要你的应用具备 Ads 权限。

常见错误：error_sign 或 invalid_partner_id 表示 Partner ID、Partner Key 和主机不匹配，例如在沙盒主机上使用了正式密钥。error_permission 表示应用没有该 API 的权限。error_param 表示参数有误或时间窗口过长。source_ip_undeclared 表示你的应用在 Console 中设置了 IP 白名单，但其中没有 AnythingMCP 的地址。

该连接器不会安排发货、取消订单、处理退货或退款、回复买家或聊天、创建折扣或广告，也不会上传新商品。

步骤 2 — 安装 adapter

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

步骤 3 — 在 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 现在可以调用 Shopee Seller 的工具。

可用工具

示例提示

• “现在有哪些订单在等待发货？每笔分别用哪家承运商？”
• “上周的订单扣掉 Shopee 佣金、各项费用和优惠券后，我实际赚了多少？”
• “这个月哪些商品卖得最好？其中哪些快要缺货了？”
• “列出所有未处理的退货申请，以及每笔的原因和退款金额。”
• “过去 14 天我的 Shopee 广告表现如何？按天给我看花费、订单和 ROAS。”

FAQ

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

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT