§00
调用公开 API
工具目录可直接查看。调用已上线的 REST 或 MCP 工具，需要注册账户并在工作台创建 API Key。REST 使用 Bearer 或 X-API-Key 鉴权，取数按积分计费。以下示例先验证 Key，再读取 1688 类目树。
REST · curl
export CB_KEY="your_api_key"
curl -i https://claudebaby.cn/api/me -H "Authorization: Bearer $CB_KEY"
curl -i -X POST https://claudebaby.cn/v1/ecommerce/1688/tools/ali1688_category_tree -H "Authorization: Bearer $CB_KEY" -H "Content-Type: application/json" -d '{}'§01
平台与挂载点
已上线平台的挂载点总览。分组口径与首页矩阵一致：国内 / 国外 × 社媒 / 电商。
| 平台 | 市场 / 域 | MCP（Streamable HTTP） | 端点数 |
|---|---|---|---|
| 1688 | 国内 · 电商 | https://claudebaby.cn/mcp/1688 | 5 |
| amazon | 国外 · 电商 | https://claudebaby.cn/mcp/amazon | 20 |
| douyin | 国内 · 社媒 | https://claudebaby.cn/mcp/douyin | 4 |
| 国外 · 社媒 | https://claudebaby.cn/mcp/facebook | 3 | |
| 国外 · 社媒 | https://claudebaby.cn/mcp/linkedin | 3 | |
| 国外 · 社媒 | https://claudebaby.cn/mcp/reddit | 3 | |
| shopee | 国外 · 电商 | https://claudebaby.cn/mcp/shopee | 11 |
| temu | 国外 · 电商 | https://claudebaby.cn/mcp/temu | 7 |
| tiktok | 国外 · 社媒 | https://claudebaby.cn/mcp/tiktok | 4 |
| tiktokshop | 国外 · 电商 | https://claudebaby.cn/mcp/tiktokshop | 10 |
| walmart | 国外 · 电商 | https://claudebaby.cn/mcp/walmart | 12 |
| x | 国外 · 社媒 | https://claudebaby.cn/mcp/x | 4 |
| xiaohongshu | 国内 · 社媒 | https://claudebaby.cn/mcp/xiaohongshu | 4 |
| youtube | 国外 · 社媒 | https://claudebaby.cn/mcp/youtube | 4 |
REST 取数走统一入口 POST https://claudebaby.cn/v1/{domain}/{platform}/tools/{tool}，工具名即路径末段，参数走 JSON 体；MCP 与 REST 是同一份工具的两个门面。每个平台的接入命令与检索示例，点平台名进它自己的页面。
§02
业务层 MCP（默认入口）
业务层负责跨平台语义整合；平台原生接口仍保留给高级查询。
| 能力 | 状态 | 说明 |
|---|---|---|
| business_capabilities | 已上线 | List the business-layer tools and cross-platform capabilities. |
| source_support | 已上线 | Check whether a data source or a named source capability is supported before querying it. |
| product_research | 已上线 | Search comparable products across supported marketplaces and return source-aware partial results. |
| market_research | 规划中 | Compare market size, growth, concentration and demand signals. |
| content_search | 规划中 | Search and merge content from supported social platforms. |
| topic_monitor | 规划中 | Aggregate topic, brand and keyword signals across social platforms. |
远程入口：https://claudebaby.cn/mcp/business；REST 入口：POST https://claudebaby.cn/v1/business/business/tools/{tool}。只有能力目录标为已上线的工具会进入可调用工具清单。
§02a
查看全部接口倍率与报价状态
普通电商每次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 | 标准路由 | — | — | 待核价 | — | — |
未核价的接口暂不可调用。备用路由报价包含本次失败主路由的成本预算；明细以实际调用的账单为准。
§03
国外 · 社媒
共 6 个平台。端点清单由各平台进程自己上报，站点只按上线闸门过滤。
| 平台 | 端点 | 入参 | 说明 |
|---|---|---|---|
| /v1/social/facebook/tools/facebook_page_profile | url*:string | Fetch a public Facebook page profile. | |
| /v1/social/facebook/tools/facebook_page_posts | url*:string · limit:integer | Fetch recent public posts from a Facebook page. | |
| /v1/social/facebook/tools/facebook_post_detail | url*:string | Fetch a public Facebook post and its engagement data. | |
| /v1/social/linkedin/tools/linkedin_user_profile | url*:string | Public profile of a LinkedIn member. | |
| /v1/social/linkedin/tools/linkedin_company_profile | url*:string | Public page of a LinkedIn company. | |
| /v1/social/linkedin/tools/linkedin_post_detail | url*:string | Single LinkedIn post or article. | |
| /v1/social/reddit/tools/reddit_search_posts | subreddit*:string · query*:string · days:integer · limit:integer | Search posts in a subreddit by keyword within a time window. Returns up to `limit` matches, oldest first. `limit` is also the cost control:… | |
| /v1/social/reddit/tools/reddit_get_thread | post_id*:string · top_n:integer | Fetch the comment tree of a single post, optionally only the top N. | |
| /v1/social/reddit/tools/reddit_search_comments | subreddit*:string · query*:string · days:integer · limit:integer | Search comments in a subreddit by keyword within a time window. Returns up to `limit` matches, oldest first. `limit` is also the cost contr… | |
| tiktok | /v1/social/tiktok/tools/tiktok_user_profile | username:string · user_id:string | Public profile of a TikTok account. |
| tiktok | /v1/social/tiktok/tools/tiktok_user_posts | user_id*:string · cursor:string · count:integer | Videos published by a TikTok account, newest first. |
| tiktok | /v1/social/tiktok/tools/tiktok_post_detail | post_id*:string · region:string | Single TikTok video with its author and engagement counters. |
| tiktok | /v1/social/tiktok/tools/tiktok_post_comments | post_id*:string · cursor:string · count:integer | Top-level comments of a TikTok video. |
| x | /v1/social/x/tools/x_user_profile | username:string · user_id:integer | Public profile of an X account. |
| x | /v1/social/x/tools/x_user_posts | username:string · user_id:integer · cursor:string | Posts published by an X account. |
| x | /v1/social/x/tools/x_post_detail | post_id*:string | Single X post with its author and counters. |
| x | /v1/social/x/tools/x_search_posts | query*:string · cursor:string | Keyword search over X posts. |
| youtube | /v1/social/youtube/tools/youtube_video_detail | video_id*:string | Single YouTube video with description and counters. |
| youtube | /v1/social/youtube/tools/youtube_channel_profile | channel_id*:string | Public profile of a YouTube channel. |
| youtube | /v1/social/youtube/tools/youtube_channel_videos | channel_id*:string · cursor:string | Videos published by a YouTube channel. |
| youtube | /v1/social/youtube/tools/youtube_search_videos | query*:string · cursor:string · order_by:string | Keyword search over YouTube videos. |
§04
国外 · 电商
共 5 个平台。端点清单由各平台进程自己上报，站点只按上线闸门过滤。
| 平台 | 端点 | 入参 | 说明 |
|---|---|---|---|
| amazon | /v1/ecommerce/amazon/tools/category_tree | site:string · node_id:string | Browse the Amazon category tree; omit node_id for the top two levels. |
| amazon | /v1/ecommerce/amazon/tools/category_name_search | name*:string · site:string | Find Amazon sub-categories by name and get their node ids. |
| amazon | /v1/ecommerce/amazon/tools/category_report | node_id*:string · site:string | Top-100 best sellers of an Amazon sub-category, real time. |
| amazon | /v1/ecommerce/amazon/tools/category_report_from_history | node_id*:string · start_date*:string · end_date*:string · site:string | Top-100 best sellers of an Amazon sub-category in a past date range. |
| amazon | /v1/ecommerce/amazon/tools/category_trend | node_id*:string · trend_index:string · site:string | Historical trend of an Amazon sub-category market. |
| amazon | /v1/ecommerce/amazon/tools/category_keywords | node_id*:string · page:integer · site:string | Core keywords of an Amazon sub-category market. |
| amazon | /v1/ecommerce/amazon/tools/product_search | search_name:string · brand:string · seller_name:string · price_min:string · price_max:string · month_sales_min:string · month_sales_max:string · rating_min:string · rating_max:string · rating_count_min:string · rating_count_max:string · page:integer · site:string | Search live Amazon products with multi-dimensional filters. |
| amazon | /v1/ecommerce/amazon/tools/product_search_from_name | name*:string · page:integer · site:string | Search Amazon products by name; up to 20 per page. |
| amazon | /v1/ecommerce/amazon/tools/product_detail | asin*:string · site:string | Full detail record of a single Amazon product (one ASIN per call). |
| amazon | /v1/ecommerce/amazon/tools/product_trend | asin*:string · trend_type:string · site:string | Historical trend of an Amazon product (sales / price / rank). |
| amazon | /v1/ecommerce/amazon/tools/product_reviews | asin*:string · review_type:string · site:string | Up to 100 Amazon user reviews of a product from the last year. |
| amazon | /v1/ecommerce/amazon/tools/product_customers_say | asin*:string · site:string | Amazon `Customers Say` summary distilled from a product's reviews. |
| amazon | /v1/ecommerce/amazon/tools/product_variations | asin*:string · page:integer · site:string | Child-ASIN variation breakdown of an Amazon parent product. |
| amazon | /v1/ecommerce/amazon/tools/product_traffic_terms | asin*:string · page:integer · site:string | Keywords an Amazon product has recently been exposed under. |
| amazon | /v1/ecommerce/amazon/tools/product_ranking_trend_by_keyword | asin*:string · keyword*:string · page:integer · site:string | Exposure-ranking trend of an Amazon product under one keyword. |
| amazon | /v1/ecommerce/amazon/tools/keyword_list | site:string · page:integer · rank_min:string · rank_max:string · search_volume_min:string · search_volume_max:string | Live trending keyword list for an Amazon site, by weekly search volume. |
| amazon | /v1/ecommerce/amazon/tools/keyword_detail | keyword*:string · site:string | Detail record of one trending Amazon keyword. |
| amazon | /v1/ecommerce/amazon/tools/keyword_trend | keyword*:string · site:string | Historical trend of an Amazon keyword (volume / rank / CPC). |
| amazon | /v1/ecommerce/amazon/tools/keyword_extends | keyword*:string · site:string · page:integer | Extended / long-tail keywords derived from an Amazon keyword. |
| amazon | /v1/ecommerce/amazon/tools/keyword_search_results | keyword*:string · site:string · page:integer · position_type:string | Products holding organic positions for an Amazon keyword. |
| shopee | /v1/ecommerce/shopee/tools/shopee_category_tree | site:string · node_id:string | Browse the Shopee category tree for one site. |
| shopee | /v1/ecommerce/shopee/tools/shopee_category_search_from_name | name*:string · site:string | Find Shopee categories by name and get their node ids. |
| shopee | /v1/ecommerce/shopee/tools/shopee_category_request | node_id*:string · query_date:string · page:integer · site:string | Best-selling products under a Shopee category (sub-categories only). |
| shopee | /v1/ecommerce/shopee/tools/shopee_category_trend | node_id*:string · trend_index:string · site:string | Historical trend of a Shopee category market. |
| shopee | /v1/ecommerce/shopee/tools/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 | /v1/ecommerce/shopee/tools/shopee_product_search_from_name | name*:string · site:string · page:integer | Search Shopee products by name; up to 20 per page. |
| shopee | /v1/ecommerce/shopee/tools/shopee_product_request | product_id*:string · site:string | Full detail record of a single Shopee product. |
| shopee | /v1/ecommerce/shopee/tools/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 | /v1/ecommerce/shopee/tools/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 | /v1/ecommerce/shopee/tools/shopee_keyword_relation_results | keyword*:string · site:string · page:integer | Products related to a Shopee keyword, up to 20 per page. |
| shopee | /v1/ecommerce/shopee/tools/shopee_shop_request | shop_id*:string · site:string | Shopee seller profile plus a top-500 snapshot of its products. |
| temu | /v1/ecommerce/temu/tools/temu_category_tree | site:string · node_id:string | Browse the Temu category tree for one site. |
| temu | /v1/ecommerce/temu/tools/temu_category_search_from_name | name*:string · site:string | Find Temu categories by name and get their node ids. |
| temu | /v1/ecommerce/temu/tools/temu_category_request | node_id*:string · page:integer · site:string | Best-selling products under a Temu category. |
| temu | /v1/ecommerce/temu/tools/temu_product_search | node_id:string · brand:string · seller_name:string · price_min:string · price_max:string · sales_min:string · sales_max:string · star_min:string · star_max:string · comment_count_min:string · comment_count_max:string · site:string · page:integer | Search Temu products with filters, sorted by monthly sales. |
| temu | /v1/ecommerce/temu/tools/temu_product_search_from_name | name*:string · site:string · page:integer | Search Temu products by name; 20 per page. |
| temu | /v1/ecommerce/temu/tools/temu_product_request | product_id*:string · site:string | Full detail record of a single Temu product. |
| temu | /v1/ecommerce/temu/tools/temu_product_trend | product_id*:string · start_date:string · end_date:string · site:string | Historical trend of a Temu product (sales / price / comments / star). |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_category_tree | site:string · node_id:string | Browse the TikTok Shop category tree for one site. |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_category_search_from_name | name*:string · site:string | Find TikTok Shop categories by name and get their node ids. |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_category_request | node_id*:string · page:integer · site:string | Best-selling products under a TikTok Shop category. |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_category_trend | node_id*:string · trend_index:string · site:string | Historical trend of a TikTok Shop category market. |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_product_search | node_id:string · brand:string · seller_name:string · price_min:string · price_max:string · month_sales_min:string · month_sales_max:string · star_min:string · star_max:string · review_count_min:string · review_count_max:string · site:string · page:integer | Search TikTok Shop products with filters. |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_product_search_from_name | name*:string · site:string · page:integer | Search TikTok Shop products by name. |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_product_request | product_id*:string · site:string | Full detail record of a single TikTok Shop product. |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_product_trend | product_id*:string · trend_type:string · site:string | Historical trend of a TikTok Shop product. |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_shop_request | shop_id*:string · site:string | TikTok Shop seller details. |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_shop_search | node_id:string · month_sales_min:string · month_sales_max:string · star_min:string · star_max:string · site:string · page:integer | Search TikTok Shop sellers with filters. |
| walmart | /v1/ecommerce/walmart/tools/walmart_category_tree | node_id:string | Browse the Walmart category tree (US site only). |
| walmart | /v1/ecommerce/walmart/tools/walmart_category_search_from_name | name*:string | Find Walmart categories by name and get their node ids. |
| walmart | /v1/ecommerce/walmart/tools/walmart_category_report_by_node_id | node_id*:string | Real-time top-100 best sellers of a Walmart category. |
| walmart | /v1/ecommerce/walmart/tools/walmart_product_search_from_name | name*:string · page:integer | Search Walmart products by name; up to 20 per page. |
| walmart | /v1/ecommerce/walmart/tools/walmart_product_detail_by_product_id | product_id*:string | Full detail record of a single Walmart product. |
| walmart | /v1/ecommerce/walmart/tools/walmart_product_trend_by_product_id | product_id*:string · trend_type:string · start_date:string · end_date:string | Historical trend of a Walmart product (sales volume / amount and more). |
| walmart | /v1/ecommerce/walmart/tools/walmart_product_variation_sales_by_product_id | product_id*:string · start_date:string · end_date:string · page:integer | Child-item sales breakdown of a Walmart product. |
| walmart | /v1/ecommerce/walmart/tools/walmart_product_traffic_terms | product_id*:string · page:integer | Keywords a Walmart product has recently been exposed under. |
| walmart | /v1/ecommerce/walmart/tools/walmart_keyword_list | rank_min*:integer · rank_max*:integer · page:integer | Real-time hot keyword list for Walmart, by monthly search volume. |
| walmart | /v1/ecommerce/walmart/tools/walmart_keyword_detail | keyword*:string | Detail record of one Walmart hot keyword. |
| walmart | /v1/ecommerce/walmart/tools/walmart_keyword_extends | keyword*:string · page:integer | Extended keywords derived from a Walmart hot keyword. |
| walmart | /v1/ecommerce/walmart/tools/walmart_keyword_search_results | keyword*:string · page:integer | Natural-position product list for a Walmart hot keyword. |
§05
国内 · 社媒
共 2 个平台。端点清单由各平台进程自己上报，站点只按上线闸门过滤。
| 平台 | 端点 | 入参 | 说明 |
|---|---|---|---|
| douyin | /v1/social/douyin/tools/douyin_user_profile | username*:string | Public profile of a Douyin account. |
| douyin | /v1/social/douyin/tools/douyin_post_detail | post_id*:string | Single Douyin video with its author and counters. |
| douyin | /v1/social/douyin/tools/douyin_post_comments | post_id*:string · cursor:string · count:integer | Top-level comments of a Douyin video. |
| douyin | /v1/social/douyin/tools/douyin_search_videos | query*:string · cursor:string · sort_type:string · publish_time:string | Keyword search over Douyin videos. |
| xiaohongshu | /v1/social/xiaohongshu/tools/xiaohongshu_search_notes | query*:string · page:integer · sort_type:string · note_type:string · time_filter:string | Keyword search over Xiaohongshu notes. |
| xiaohongshu | /v1/social/xiaohongshu/tools/xiaohongshu_user_profile | user_id:string · url:string | Public profile of a Xiaohongshu account. |
| xiaohongshu | /v1/social/xiaohongshu/tools/xiaohongshu_user_notes | user_id:string · url:string · cursor:string | Notes published by a Xiaohongshu account. |
| xiaohongshu | /v1/social/xiaohongshu/tools/xiaohongshu_note_detail | note_id:string · url:string | Single Xiaohongshu note (image or video). |
§06
国内 · 电商
共 1 个平台。端点清单由各平台进程自己上报，站点只按上线闸门过滤。
| 平台 | 端点 | 入参 | 说明 |
|---|---|---|---|
| 1688 | /v1/ecommerce/1688/tools/ali1688_category_tree | node_id:string | Browse the 1688 category tree. |
| 1688 | /v1/ecommerce/1688/tools/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. |
| 1688 | /v1/ecommerce/1688/tools/ali1688_product_request | product_id*:string | Full detail record of a single 1688 offer. |
| 1688 | /v1/ecommerce/1688/tools/ali1688_product_variations | product_id*:string | SKU / variation data of a 1688 offer. |
| 1688 | /v1/ecommerce/1688/tools/ali1688_similar_product | search_name*:string · page:integer | Sourcing / wholesale suppliers for a product name — procurement cost view. |
§07
约定
REST 与 MCP 共用的那一层口径 —— 两边返回的是同一个 envelope。
| 项 | 口径 |
|---|---|
| 鉴权 | Authorization: Bearer <API Key>（也接受 X-API-Key） |
| 响应 | {"ok", "data", "meta"}；meta 只有平台 / 端点 / 积分 / 翻页游标 |
| 计费 | 单次扣减 = 每次积分 × 执行次数，见价目表 |
| 错误 | {"error": {"code", "message", "retryable"}}，见 错误码表 |
| 请求关联 | 每个响应都带 X-Request-Id |
机器可读的同名契约：/openapi.json（形状与错误码）、/v1/meta/tools（实时端点清单）、/.well-known/mcp.json（MCP 挂载点）。要在浏览器里逐条试，用 API 详情。
