shopee

§00

国外 · 电商 · 已上线 — 这一页是它的端点、接入命令与检索示例。

§01

端点

shopee 的全部入口。REST 与 MCP 是同一份工具的两个门面。

项	值
MCP（Streamable HTTP）	https://claudebaby.cn/mcp/shopee
MCP（SSE）	https://claudebaby.cn/sse/shopee
MCP（stdio）	claudebaby-mcp --platform shopee
REST 取数	POST https://claudebaby.cn/v1/ecommerce/shopee/tools/{tool}
REST 端点一览	https://claudebaby.cn/v1/ecommerce/shopee/tools

MCP 挂载点与其它已上线平台同形：同主机、同 /mcp/ 前缀，只有末段是 shopee。把末段换成别的平台名就是那个平台的端点。

§02

接入方式

三种粘法任选一种。鉴权、计量、缓存都在云端，本地不落上游密钥。

Claude Code（CLI 一条命令）

# Claude Code：一条命令挂上
claude mcp add --transport http claudebaby-shopee https://claudebaby.cn/mcp/shopee \
  --header "Authorization: Bearer $CB_KEY"

# 挂好后在会话里 /mcp 就能看到工具

客户端配置（Claude Desktop / Cursor / 通用 JSON）

{
  "mcpServers": {
    "claudebaby-shopee": {
      "type": "http",
      "url": "https://claudebaby.cn/mcp/shopee",
      "headers": { "Authorization": "Bearer <你的 API Key>" }
    }
  }
}

stdio 桥接（本地不落密钥）

# 本地 stdio：本机不落任何密钥，取数仍回云端网关
pip install claudebaby-mcp
CB_API_KEY=cb_live_xxx claudebaby-mcp --platform shopee

Key 在控制台签发，明文只展示一次；余额不足会返回 insufficient_balance（HTTP 402）。

§03

端点清单

工具名即 REST 路径末段；同一批工具也挂在 MCP 上，返回的是同一个 envelope。

共 11 个端点。

端点	入参	说明
shopee_category_tree	site:string · node_id:string	Browse the Shopee category tree for one site.
shopee_category_search_from_name	name*:string · site:string	Find Shopee categories by name and get their node ids.
shopee_category_request	node_id*:string · query_date:string · page:integer · site:string	Best-selling products under a Shopee category (sub-categories only).
shopee_category_trend	node_id*:string · trend_index:string · site:string	Historical trend of a Shopee category market.
shopee_product_search	node_id:string · price_min:string · price_max:string · month_sales_min:string · month_sales_max:string · star_min:string · star_max:string · comment_count_min:string · comment_count_max:string · site:string · page:integer	Search Shopee products with filters, sorted by monthly sales.
shopee_product_search_from_name	name*:string · site:string · page:integer	Search Shopee products by name; up to 20 per page.
shopee_product_request	product_id*:string · site:string	Full detail record of a single Shopee product.
shopee_product_trend	product_id*:string · start_date:string · end_date:string · site:string	Historical trend of a Shopee product (star / comments / price / sales).
shopee_keyword_search	keyword:string · rank_min:string · rank_max:string · search_volume_min:string · search_volume_max:string · site:string · page:integer	Trending keywords on Shopee, by monthly search volume.
shopee_keyword_relation_results	keyword*:string · site:string · page:integer	Products related to a Shopee keyword, up to 20 per page.
shopee_shop_request	shop_id*:string · site:string	Shopee seller profile plus a top-500 snapshot of its products.

§04

检索示例：anker

示例用 anker 作为检索词，调 shopee 的 shopee_category_search_from_name。检索词的位置按工具的真实入参填好了，其余必填项留占位符 —— 把 <…> 换成你的值即可。参数与说明见上一节的端点清单，或 https://claudebaby.cn/v1/ecommerce/shopee/tools。

REST · curl

export CB_KEY=cb_live_xxx

curl -s -X POST https://claudebaby.cn/v1/ecommerce/shopee/tools/shopee_category_search_from_name \
  -H "Authorization: Bearer $CB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "anker"}'

响应结构（同一个 envelope，MCP 走 structuredContent）

{
  "ok": true,
  "data": {
    "…": "shopee_category_search_from_name 的返回体，字段随工具而异"
  },
  "meta": {
    "platform": "shopee",
    "domain": "ecommerce",
    "tool": "shopee_category_search_from_name",
    "request_id": "req_…",
    "credits": "<本次消耗的积分，见 /pricing.json>"
  }
}

真实返回体要自己调一次才看得到（照它调一次照常计积分，最低 1 积分）—— 上面的 data 是外壳，不是我们替你编的样例数据。要在浏览器里直接试，用 API 详情填上自己的 Key。

§05

计费

预付费，无订阅费；余额不足即拒，不会透支。

档位	适用	积分系数	单价
list	搜索 / 榜单 / 社媒列表类	1	¥0.02 / 1 积分
detail	商品 / 内容详情类	2	¥0.03 / 2 积分
content	笔记 / 内容详情类（含正文与互动）	9	¥0.18 / 9 积分
keyword_task	关键词全量任务	50	¥1.00 / 50 积分
social_page	海外社媒整页采集	80	¥1.60 / 80 积分
ecom_page	国内电商整页采集（SKU 全量）	600	¥12.00 / 600 积分

单次扣减 = max(1 积分, 积分系数 × 数量)；1 积分 = ¥0.02。每个端点属于哪个档位见 /pricing.json（含逐平台单价）。