摘要
Walmart Marketplace API 适用于美国卖家：带确认和跟踪的订单、退货、商品和目录搜索、库存、价格、大宗数据、按需报告、WFS 入库和运输设置。客户端 ID 和密钥。
引导式设置
2 分钟将 Walmart Marketplace 连接到 Meta Muse
开始 AnythingMCP Cloud 免费试用，在引导式设置中连接 Walmart Marketplace，再把你的 MCP URL 添加到 Meta Muse。无需代码，也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Walmart Marketplace 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 没有安装？直接使用 cloud.anythingmcp.com。 登录，点击 Connectors → Walmart Marketplace，粘贴你的凭证，生成一个 MCP API 密钥，完成。无需 Docker，无需
git clone，无需本地服务器。
Walmart Marketplace + Meta Muse
Walmart Marketplace API 适用于美国卖家：带确认和跟踪的订单、退货、商品和目录搜索、库存、价格、大宗数据、按需报告、WFS 入库和运输设置。客户端 ID 和密钥。
前提条件
请查看连接器中包含的完整设置说明（在选择连接器时可在应用内商店中查看）。此连接器所需的环境变量为：
WALMART_CLIENT_ID, WALMART_CLIENT_SECRET
第一步 — 获取凭证
设置大约需要 5 分钟。
- 使用你的 Seller Center 登录信息登录 https://developer.walmart.com（选择 Marketplace 卖家）。
- 打开 我的账户，然后选择 API 密钥（密钥管理），创建或复制 生产 客户端 ID 和客户端密钥。
- 将客户端 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
第三步 — 在 Muse 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Muse 以自定义连接器的形式添加远程 MCP 服务器，并通过 OAuth 登录。
- 在 Muse 中打开 Settings → Connectors，选择 Add custom connector。
- 粘贴 MCP 服务器 URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。 - Muse 会打开 AnythingMCP 的登录页面：登录并批准访问。
- 在聊天中，向 Muse 提出需要用到
Walmart Marketplace的工具的请求。
你也可以在聊天中完成设置，适用于网页版、iOS 和 Android 应用以及 WhatsApp。给 Muse 发送这条消息：
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
自托管？请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Muse 从 Meta 的云端连接，因此 localhost 无法使用。
可用工具
| 工具 | 功能 |
|---|---|
walmart_marketplace_list_orders | 列出采购订单，按最新优先：list.meta（totalCount、limit、nextCursor）和 list.elements.order[]，包含 purchaseOrderId… |
walmart_marketplace_list_released_orders | 列出已发布的订单：状态仍为 Created 的采购订单，准备好供你确认和发货。与…相同的字段 |
walmart_marketplace_get_order | 读取一个采购订单：purchaseOrderId、customerOrderId、customerEmailId（中转地址）、orderDate、shippingInfo（电话… |
walmart_marketplace_acknowledge_order | 确认整个采购订单（每一行从 Created 转为 Acknowledged），确认你将履行该订单。Walmart 期望这样… |
walmart_marketplace_ship_order_line | 将一行订单标记为已发货，包含承运人和跟踪号码。Walmart 然后捕获客户付款，因此仅发货实际… |
walmart_marketplace_cancel_order_line | 取消无法发货的订单行的单位，需提供理由。此操作无法撤销，并会影响你的取消率；使用… |
walmart_marketplace_refund_order_lines | 向客户退款已发货的订单行（全额或部分）。这会将资金退回给客户，无法撤销。行使用… |
walmart_marketplace_list_returns | 列出退货订单（RMA），按最新优先：meta（totalCount、limit、nextCursor）和 returnOrders[]，包含 returnOrderId、customerOrderId… |
walmart_marketplace_refund_return | 为退货订单（RMA）的行发放退款。这会将资金退回给客户，无法撤销。返回退款结果… |
walmart_marketplace_list_items | 列出你的 Walmart 目录中的商品：ItemResponse[]，包含 sku、wpid、upc、gtin、productName、productType、shelf、price（金额… |
walmart_marketplace_get_item | 通过 SKU（默认）或其他标识符读取你的目录中的一项：sku、wpid、upc、gtin、productName、shelf、productType、price… |
walmart_marketplace_search_my_catalog | 使用查询、过滤器和排序搜索你自己的卖家目录：items[]，包含 sku、itemId、productName、brand、price、publishedStatus… |
walmart_marketplace_search_walmart_catalog | 通过关键字或 UPC、GTIN、EAN 或 ISBN 搜索公共 Walmart.com 目录（所有卖家），以查看产品是否已存在… |
walmart_marketplace_count_items | 计算你目录中某一状态（PUBLISHED、UNPUBLISHED、SYSTEM_PROBLEM、IN_PROGRESS 或 ALL）的商品数量。只读，便宜的概览… |
walmart_marketplace_retire_item | 通过 SKU 从 Walmart.com 退役（永久移除）一项商品。该列表将被下架；恢复需要重新设置新商品。返回… |
walmart_marketplace_get_inventory | 读取你默认运输节点或指定运输节点的一 SKU 库存：sku、数量（单位为 EACH，金额 = 可销售单位… |
walmart_marketplace_get_inventory_by_ship_node | 读取你账户中每个运输节点（或一个节点）的一 SKU 库存：sku 和 nodes[]，包含 shipNode、inputQty（你设置的… |
walmart_marketplace_update_inventory | 将一 SKU 的库存设置为在你默认运输节点（或指定运输节点）的绝对数量。该数量将替换当前值… |
walmart_marketplace_get_wfs_inventory | 读取 Walmart Fulfillment Services (WFS) 库存：headers（totalCount、limit、offset）和 payload.inventory[]，包含 itemInformation（sku、gtin… |
walmart_marketplace_update_price | 设置一 SKU 的常规（基础）销售价格，以 USD 计。返回 ItemPriceResponse，包含 sku 和消息。限制为每… |
walmart_marketplace_get_promotional_prices | 读取一 SKU 的促销价格：payload.itemIdentifier 和 pricingList.pricing[]，包含 currentPriceType（BASE、REDUCED、CLEARANCE… |
walmart_marketplace_submit_item_feed | 提交大宗商品数据源（创建或更新最多 10,000 项商品），作为 Walmart 商品规范中的 JSON 文档，例如 MP_ITEM，包含… |
walmart_marketplace_submit_price_feed | 提交大宗价格数据源（feedType PRICE_AND_PROMOTION，最多 10,000 个 SKU，推荐 1,000 个）… |
walmart_marketplace_list_feeds | 列出你最近的数据源（或一个数据源）：totalResults 和 results.feed[]，包含 feedId、feedType、feedSource、feedStatus（RECEIVED、INPROGRESS… |
walmart_marketplace_get_feed_status | 读取一个数据源的状态：feedStatus、itemsReceived、itemsSucceeded、itemsFailed、itemsProcessing，并且，包含 include_details… |
walmart_marketplace_request_report | 请求 Walmart 生成按需报告（ITEM 目录、INVENTORY、BUYBOX、CANCELLATION、RETURN_OVERRIDES、ITEM_PERFORMANCE、WFS… |
walmart_marketplace_list_report_requests | 列出过去 30 天内某一类型的报告请求：requests[]，包含 requestId、requestStatus（RECEIVED、INPROGRESS、READY、ERROR）… |
walmart_marketplace_get_report_request | 读取一个报告请求的状态：requestId、requestStatus（RECEIVED、INPROGRESS、READY、ERROR）、reportType、reportVersion… |
walmart_marketplace_get_report_download_url | 获取 READY 报告的下载链接：downloadURL（预签名，压缩的 CSV）、downloadURLExpirationTime、reportType 和… |
walmart_marketplace_list_inbound_shipments | 列出 WFS 入库（你的库存正在运往 Walmart 履行中心）：headers.totalCount 和 payload[]，包含 inboundOrderId… |
walmart_marketplace_list_inbound_shipment_items | 列出 WFS 入库的 SKU：headers.totalCount 和 payload[]，包含 inboundOrderId、shipmentId、sku、gtin、itemDesc、itemQty… |
walmart_marketplace_create_inbound_shipment_label | 为入库生成 WFS 接收标签（不是承运人标签：这些标签让履行中心将箱子或托盘与… |
walmart_marketplace_list_ship_nodes | 列出你的履行中心（运输节点）：shipNode（其他工具使用的 ID）、shipNodeName、nodeType、status、timeZone、postalAddress… |
walmart_marketplace_list_carrier_methods | 列出可用于你的运输配置的承运人方式：carrierMethodId、carrierMethodName、carrierMethodType 和… |
walmart_marketplace_list_shipping_templates | 列出你的运输模板：totalRecords 和 shippingTemplates[]，包含 id、name、type（DEFAULT、CUSTOM、DELIVERR）、status（ACTIVE… |
walmart_marketplace_get_lag_time | 读取一 SKU 的履行延迟时间：sku 和 fulfillmentLagTime（订单和发货之间的天数；2 天或更多需要 Walmart… |
示例提示
- "今天还有哪些已发布的 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 应该使用它们；它会要求你确认每个更改。
Muse 在哪些地区可用？ Meta 目前在美国和加拿大提供 Muse，可在网页版、iOS 和 Android 应用以及 WhatsApp 中使用。
Meta 会审核这个连接器吗？ 不会。Meta 不审核自定义连接器。Muse 只能看到你在 AnythingMCP 中为此 MCP 服务器启用的工具，你也可以随时在 Settings → Connectors 中断开它。
下一步
这份指南对你有帮助吗?