walmart

§00

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

§01

端点

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

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

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

§02

接入方式

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

Claude Code（CLI 一条命令）

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

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

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

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

stdio 桥接（本地不落密钥）

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

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

§03

端点清单

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

共 12 个端点。

端点	入参	说明
walmart_category_tree	node_id:string	Browse the Walmart category tree (US site only).
walmart_category_search_from_name	name*:string	Find Walmart categories by name and get their node ids.
walmart_category_report_by_node_id	node_id*:string	Real-time top-100 best sellers of a Walmart category.
walmart_product_search_from_name	name*:string · page:integer	Search Walmart products by name; up to 20 per page.
walmart_product_detail_by_product_id	product_id*:string	Full detail record of a single Walmart product.
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_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_product_traffic_terms	product_id*:string · page:integer	Keywords a Walmart product has recently been exposed under.
walmart_keyword_list	rank_min:integer · rank_max:integer · page:integer	Real-time hot keyword list for Walmart, by monthly search volume.
walmart_keyword_detail	keyword*:string	Detail record of one Walmart hot keyword.
walmart_keyword_extends	keyword*:string · page:integer	Extended keywords derived from a Walmart hot keyword.
walmart_keyword_search_results	keyword*:string · page:integer	Natural-position product list for a Walmart hot keyword.

§04

检索示例：anker

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

REST · curl

export CB_KEY=cb_live_xxx

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

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

{
  "ok": true,
  "data": {
    "…": "walmart_category_search_from_name 的返回体，字段随工具而异"
  },
  "meta": {
    "platform": "walmart",
    "domain": "ecommerce",
    "tool": "walmart_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（含逐平台单价）。