Walmart Marketplace MCP 服务器：订单与库存

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

Walmart Marketplace

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

设置

设置大约需要 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（带有未发布商品等过滤器的你的目录）和 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 的基础价格（以美元计，限制每小时 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；订单日期以纪元毫秒表示。货币为美元。SKU 是你自己的卖家 SKU；Walmart ID 为 purchaseOrderId（订单）、returnOrderId（退货）、wpid 和 itemId（目录）。错误以 errors.error[] 形式返回，包含代码、字段和描述；400 INVALID_REQUEST_HEADER 通常表示令牌或头部问题。

先决条件：WALMART_CLIENT_ID、WALMART_CLIENT_SECRET

本地安装连接器

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

打开 http://localhost:3000/connectors/store，选择 Walmart Marketplace 并粘贴在先决条件下列出的环境变量。

可用工具

示例提示

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

下一步

• 连接到 Claude
• 连接到 ChatGPT