将 Walmart Marketplace MCP 连接到 Cursor

💡 没有安装？直接使用 cloud.anythingmcp.com。 登录，点击 Connectors → Walmart Marketplace，粘贴你的凭证，生成一个 MCP API 密钥，完成。无需 Docker，无需 git clone，无需本地服务器。

Walmart Marketplace + Cursor

Walmart Marketplace API 适用于美国卖家：带确认和跟踪的订单、退货、商品和目录搜索、库存、价格、大宗数据、按需报告、WFS 入库和运输设置。客户端 ID 和密钥。

前提条件

请查看连接器中包含的完整设置说明（在选择连接器时可在应用内商店中查看）。此连接器所需的环境变量为：

WALMART_CLIENT_ID, WALMART_CLIENT_SECRET

第一步 — 获取凭证

设置大约需要 5 分钟。

1. 使用你的 Seller Center 登录信息登录 https://developer.walmart.com（选择 Marketplace 卖家）。
2. 打开 我的账户，然后选择 API 密钥（密钥管理），创建或复制 生产 客户端 ID 和客户端密钥。
3. 将客户端 ID 粘贴到 WALMART_CLIENT_ID，将客户端密钥粘贴到 WALMART_CLIENT_SECRET。

连接器在 POST /v3/token（HTTP Basic，客户端凭证）处交换它们，以获取有效期为 15 分钟 的访问令牌，直到快到期时重新使用并自动获取新的令牌。每次调用都携带 WM_SEC.ACCESS_TOKEN、WM_SVC.NAME 和新的 WM_QOS.CORRELATION_ID。使用你自己的卖家客户端凭证：委托访问密钥将被逐步淘汰（无法再创建新的，现有的将在 2027 年 4 月 30 日后停止工作）。

从哪里开始：walmart_marketplace_list_released_orders（等待你的订单），然后是 walmart_marketplace_get_order。walmart_marketplace_list_items 列出你的目录，walmart_marketplace_get_inventory 列出 SKU 的库存。

订单：walmart_marketplace_list_orders（所有状态），walmart_marketplace_list_released_orders（状态为 Created 的行），walmart_marketplace_get_order。一行的状态可以是 Created、Acknowledged、Shipped、Delivered 或 Cancelled。及时确认新订单，使用 walmart_marketplace_acknowledge_order，然后使用 walmart_marketplace_ship_order_line 发货每一行（承运人、方式、跟踪号码、发货时间以纪元毫秒表示）；发货会捕获客户付款。walmart_marketplace_cancel_order_line 和 walmart_marketplace_refund_order_lines 默认关闭：取消订单会影响你的卖家指标，退款会转移资金。订单列表最多可追溯 180 天，最多 10,000 个订单，默认显示最近 7 天的订单。

分页：订单和退货的响应中包含 meta.nextCursor，这是一个以 ? 开头的查询字符串。将其原样传递为 next_cursor，并省略其他过滤器。商品使用 nextCursor（以 * 开头，有效期 2 分钟）或限制和偏移量。

退货：walmart_marketplace_list_returns（状态为 INITIATED、DELIVERED、COMPLETED）。walmart_marketplace_refund_return 默认关闭，因为它会退款给客户。

商品和目录：walmart_marketplace_list_items、walmart_marketplace_get_item、walmart_marketplace_count_items、walmart_marketplace_search_my_catalog（带有 UNPUBLISHED 商品等过滤器的你的目录）和 walmart_marketplace_search_walmart_catalog（通过关键字、UPC 或 GTIN 搜索公共 Walmart.com 目录）。walmart_marketplace_retire_item 默认关闭：退役会移除列表。

库存和价格：walmart_marketplace_get_inventory、walmart_marketplace_get_inventory_by_ship_node、walmart_marketplace_update_inventory（绝对数量，单位为 EACH）、walmart_marketplace_get_wfs_inventory（WFS 持有的库存）。walmart_marketplace_update_price 设置一个 SKU 的基础价格（以 USD 计，限制为每小时 100 次调用）；walmart_marketplace_get_promotional_prices 显示促销价格。

数据源：大宗更改通过数据源进行。walmart_marketplace_submit_item_feed 和 walmart_marketplace_submit_price_feed 默认关闭，因为一个数据源会更改多个实时列表，并且大宗价格数据源每小时和每天都有限制（每小时 10 次，由所有价格和促销数据源共享）。使用 walmart_marketplace_list_feeds 和 walmart_marketplace_get_feed_status 检查结果（每项错误包含详细信息）。

报告：walmart_marketplace_request_report，然后使用 walmart_marketplace_list_report_requests 或 walmart_marketplace_get_report_request 直到状态为 READY，然后使用 walmart_marketplace_get_report_download_url。状态和下载调用每小时限制为 20 次，因此在检查之间等待几分钟。链接是短期有效的压缩 CSV。

WFS：walmart_marketplace_list_inbound_shipments、walmart_marketplace_list_inbound_shipment_items、walmart_marketplace_create_inbound_shipment_label（接收标签为 PDF 或 ZPL，免费）。

设置（只读）：walmart_marketplace_list_ship_nodes（运输节点 ID）、walmart_marketplace_list_carrier_methods、walmart_marketplace_list_shipping_templates、walmart_marketplace_get_lag_time（每小时 20 次调用）。

速率限制：每个 API 都有自己的令牌桶（所有订单每分钟 5,000 次，已发布订单每分钟 60 次，发货、确认和取消每分钟 60 次，库存每分钟 200 次，商品每分钟 300 次）。429 表示桶已空；头部 x-current-token-count 和 X-Next-Replenishment-Time 指示何时重试。

格式：日期为 ISO 8601 格式，使用 UTC；订单日期以纪元毫秒表示。货币为 USD。SKU 为你自己的卖家 SKU；Walmart ID 为 purchaseOrderId（订单）、returnOrderId（退货）、wpid 和 itemId（目录）。错误以 errors.error[] 的形式返回，包含代码、字段和描述；400 INVALID_REQUEST_HEADER 通常意味着令牌或头部问题。

第二步 — 安装适配器

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

第三步 — 在 Cursor 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话 — 智能体现在可以调用 Walmart Marketplace 的工具。

可用工具

示例提示

• "今天还有哪些已发布的 Walmart 订单需要发货？"
• "显示采购订单 1234567890123 的客户送货地址和订单行。"
• "哪些 SKU 在我的运输节点中的库存少于 5 个单位？"
• "将 SKU WM-1001 的价格设置为 24.99 美元。"
• "确认今天所有已发布的订单，并列出仍缺少跟踪的订单。"

常见问题

它覆盖哪些 Walmart 市场？ 美国 Walmart Marketplace（marketplace.walmartapis.com）。Walmart 加拿大、墨西哥和智利有单独的 API，不在覆盖范围内。

我需要解决方案提供商应用程序或委托访问吗？ 不需要。你可以使用卖家登录在 Walmart 开发者门户中创建自己的客户端 ID 和密钥。Walmart 不再发放新的委托访问密钥。

它可以取消订单或发放退款吗？ 工具存在但默认关闭：walmart_marketplace_cancel_order_line、walmart_marketplace_refund_order_lines 和 walmart_marketplace_refund_return。仅在连接器页面上启用它们，如果 AI 应该使用它们；它会要求你确认每个更改。

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持 — Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器登录页面
• 连接到 Claude