§01
端点
1688 的全部入口。REST 与 MCP 是同一份工具的两个门面。
| 项 | 值 |
|---|---|
| MCP（Streamable HTTP） | https://claudebaby.cn/mcp/1688 |
| MCP（SSE） | https://claudebaby.cn/sse/1688 |
| MCP（stdio） | claudebaby-mcp --platform 1688 |
| REST 取数 | POST https://claudebaby.cn/v1/ecommerce/1688/tools/{tool} |
| REST 端点一览 | https://claudebaby.cn/v1/ecommerce/1688/tools |
MCP 挂载点与其它已上线平台同形：同主机、同 /mcp/ 前缀，只有末段是 1688。把末段换成别的平台名就是那个平台的端点。
§02
接入方式
三种粘法任选一种。鉴权、计量、缓存都在云端，本地不落上游密钥。
Claude Code（CLI 一条命令）
# Claude Code：一条命令挂上
claude mcp add --transport http claudebaby-1688 https://claudebaby.cn/mcp/1688 \
--header "Authorization: Bearer $CB_KEY"
# 挂好后在会话里 /mcp 就能看到工具客户端配置（Claude Desktop / Cursor / 通用 JSON）
{
"mcpServers": {
"claudebaby-1688": {
"type": "http",
"url": "https://claudebaby.cn/mcp/1688",
"headers": { "Authorization": "Bearer <你的 API Key>" }
}
}
}stdio 桥接（本地不落密钥）
# 本地 stdio：本机不落任何密钥，取数仍回云端网关
uv tool install --from "git+https://github.com/lingling1989r/claudebaby.git#subdirectory=mcps" claudebaby-mcp
CLAUDEBABY_API_KEY=cb_live_xxx claudebaby-mcp --platform 1688Key 在控制台签发，明文只展示一次；余额不足会返回 insufficient_balance（HTTP 402）。
§03
端点清单
工具名即 REST 路径末段；同一批工具也挂在 MCP 上，返回的是同一个 envelope。
共 5 个端点。
| 端点 | 入参 | 说明 |
|---|---|---|
| ali1688_category_tree | node_id:string | Browse the 1688 category tree. |
| ali1688_product_search | node_id:string · supplier_name:string · price_min:string · price_max:string · cumulative_sales_min:string · cumulative_sales_max:string · recent_sales_min:string · recent_sales_max:string · repurchase_rate_min:string · sku_count_min:string · stock_count_min:string · page:integer | Search 1688 offers / suppliers with multi-dimensional filters. |
| ali1688_product_request | product_id*:string | Full detail record of a single 1688 offer. |
| ali1688_product_variations | product_id*:string | SKU / variation data of a 1688 offer. |
| ali1688_similar_product | search_name*:string · page:integer | Sourcing / wholesale suppliers for a product name — procurement cost view. |
§04
检索示例：anker
示例用 anker 作为检索词，调 1688 的 ali1688_product_search。检索词的位置按工具的真实入参填好了，其余必填项留占位符 —— 把 <…> 换成你的值即可。参数与说明见上一节的端点清单，或 https://claudebaby.cn/v1/ecommerce/1688/tools。
REST · curl
export CB_KEY=cb_live_xxx
curl -s -X POST https://claudebaby.cn/v1/ecommerce/1688/tools/ali1688_product_search \
-H "Authorization: Bearer $CB_KEY" \
-H "Content-Type: application/json" \
-d '{"node_id": "<node_id>", "supplier_name": "anker", "price_min": "<price_min>"}'响应结构（同一个 envelope，MCP 走 structuredContent）
{
"ok": true,
"data": {
"…": "ali1688_product_search 的返回体，字段随工具而异"
},
"meta": {
"platform": "1688",
"domain": "ecommerce",
"tool": "ali1688_product_search",
"request_id": "req_…",
"credits": "<本次消耗的积分，见 /pricing.json>"
}
}真实返回体要自己调一次才看得到（照它调一次照常计积分，按端点与路由倍率扣费）—— 上面的 data 是外壳，不是我们替你编的样例数据。要在浏览器里直接试，用 API 详情 填上自己的 Key。
§05
计费
按需充值或选购套餐；付费取数前预留积分，余额不足即拒。
普通电商每次1积分；标有×N的接口每次扣N积分。组合任务逐个子调用累计，翻页分别计费。执行前预留，成功结算、失败释放；超时等待核对。
| 调用类型 | 路由 | 基础积分 | 倍率 | 每次积分 | 原价 / 次 | 30 积分试用次数 |
|---|---|---|---|---|---|---|
| instagram / user.posts | 标准路由 | 1 | ×18 | 18 | ¥0.36 | 1 |
| tiktok / user.posts | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| xiaohongshu / search.notes | 标准路由 | 1 | ×23 | 23 | ¥0.46 | 1 |
| facebook / page.posts | 扩展路由 | 1 | ×113 | 113 | ¥2.26 | 0 |
| linkedin / user.profile | 备用路由 | 1 | ×131 | 131 | ¥2.62 | 0 |
| amazon / product.search | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
查看全部接口倍率与报价状态
| 调用类型 | 路由 | 基础积分 | 倍率 | 每次积分 | 原价 / 次 | 30 积分试用次数 |
|---|---|---|---|---|---|---|
| bilibili / search.videos | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| bilibili / user.profile | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| bilibili / user.videos | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| bilibili / video.comments | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| bilibili / video.detail | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| douyin / post.comments | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| douyin / post.detail | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| douyin / search.videos | 标准路由 | 1 | ×23 | 23 | ¥0.46 | 1 |
| douyin / user.profile | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| gongzhonghao / account.articles | 标准路由 | 1 | ×23 | 23 | ¥0.46 | 1 |
| gongzhonghao / account.profile | 标准路由 | 1 | ×23 | 23 | ¥0.46 | 1 |
| gongzhonghao / article.comments | 标准路由 | 1 | ×23 | 23 | ¥0.46 | 1 |
| gongzhonghao / article.detail | 标准路由 | 1 | ×23 | 23 | ¥0.46 | 1 |
| instagram / post.detail | 标准路由 | 1 | ×18 | 18 | ¥0.36 | 1 |
| instagram / search.users | 标准路由 | 1 | ×18 | 18 | ¥0.36 | 1 |
| instagram / user.posts | 标准路由 | 1 | ×18 | 18 | ¥0.36 | 1 |
| instagram / user.profile | 标准路由 | 1 | ×18 | 18 | ¥0.36 | 1 |
| kuaishou / search.videos | 标准路由 | 1 | ×23 | 23 | ¥0.46 | 1 |
| kuaishou / user.profile | 标准路由 | 1 | ×5 | 5 | ¥0.10 | 6 |
| lemon8 / post.detail | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| lemon8 / search.posts | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| lemon8 / user.profile | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| linkedin / company.profile | 标准路由 | 1 | ×18 | 18 | ¥0.36 | 1 |
| linkedin / post.detail | 标准路由 | 1 | ×18 | 18 | ¥0.36 | 1 |
| linkedin / user.profile | 标准路由 | 1 | ×18 | 18 | ¥0.36 | 1 |
| threads / user.posts | 标准路由 | 1 | ×5 | 5 | ¥0.10 | 6 |
| tiktok / post.comments | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| tiktok / post.detail | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| tiktok / user.posts | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| tiktok / user.profile | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| toutiao / article.detail | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| toutiao / post.comments | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| toutiao / user.profile | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| toutiao / video.detail | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| weibo / hot.list | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| weibo / post.detail | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| weibo / search.posts | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| weibo / user.profile | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| x / post.detail | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| x / search.posts | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| x / user.posts | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| x / user.profile | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| xiaohongshu / note.detail | 标准路由 | 1 | ×23 | 23 | ¥0.46 | 1 |
| xiaohongshu / search.notes | 标准路由 | 1 | ×23 | 23 | ¥0.46 | 1 |
| xiaohongshu / user.notes | 标准路由 | 1 | ×23 | 23 | ¥0.46 | 1 |
| xiaohongshu / user.profile | 标准路由 | 1 | ×23 | 23 | ¥0.46 | 1 |
| xigua / search.videos | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| xigua / user.videos | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| youtube / channel.profile | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| youtube / channel.videos | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| youtube / search.videos | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| youtube / video.detail | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| zhihu / answer.detail | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| zhihu / hot.list | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| zhihu / question.answers | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| zhihu / user.profile | 标准路由 | 1 | ×3 | 3 | ¥0.06 | 10 |
| facebook / page.profile | 扩展路由 | 1 | ×113 | 113 | ¥2.26 | 0 |
| facebook / page.posts | 扩展路由 | 1 | ×113 | 113 | ¥2.26 | 0 |
| facebook / post.detail | 扩展路由 | 1 | ×113 | 113 | ¥2.26 | 0 |
| linkedin / user.profile | 备用路由 | 1 | ×131 | 131 | ¥2.62 | 0 |
| linkedin / company.profile | 备用路由 | 1 | ×131 | 131 | ¥2.62 | 0 |
| linkedin / post.detail | 备用路由 | 1 | ×131 | 131 | ¥2.62 | 0 |
| amazon / category.tree | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / category.search | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / category.report | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / category.report_history | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / category.trend | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / category.keywords | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / product.search | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / product.search_from_name | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / product.detail | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / product.trend | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / product.reviews | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / product.customers_say | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / product.variations | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / product.traffic_terms | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / product.keyword_ranking | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / keyword.list | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / keyword.detail | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / keyword.trend | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / keyword.extends | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / keyword.search_results | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / category.tree | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / category.search | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / category.report | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / product.search_from_name | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / product.detail | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / product.trend | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / product.variations | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / product.traffic_terms | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / keyword.list | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / keyword.detail | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / keyword.extends | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / keyword.search_results | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / category.tree | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / category.search | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / category.report | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / category.trend | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / product.search | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / product.search_from_name | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / product.detail | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / product.trend | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / keyword.list | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / keyword.search_results | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / shop.detail | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| temu / category.tree | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| temu / category.search | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| temu / category.report | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| temu / product.search | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| temu / product.search_from_name | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| temu / product.detail | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| temu / product.trend | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / category.tree | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / category.search | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / category.report | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / category.trend | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / product.search | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / product.search_from_name | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / product.detail | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / product.trend | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / shop.detail | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / shop.search | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| 1688 / category.tree | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| 1688 / product.search | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| 1688 / product.detail | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| 1688 / product.variations | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| 1688 / product.similar_sourcing | 标准路由 | 1 | ×1 | 1 | ¥0.02 | 30 |
| reddit / posts.search | 标准路由 | — | — | 待核价 | — | — |
| reddit / comments.search | 标准路由 | — | — | 待核价 | — | — |
| reddit / comments.thread | 标准路由 | — | — | 待核价 | — | — |
未核价的接口暂不可调用。备用路由报价包含本次失败主路由的成本预算；明细以实际调用的账单为准。
单次扣减 = 每次积分 × 执行次数；1 积分 = ¥0.02。每个端点属于哪个档位见 /pricing.json（含逐平台单价）。
