HasData Walmart

Walmart MCP 服务

一个托管的 Model Context Protocol（MCP）服务，为 Claude、Cursor、Windsurf 及其他任何 MCP 客户端提供三个只读的 Walmart 工具。运行关键词或类别搜索，读取一件商品及其购物车推荐位卖家，并翻阅该商品的客户评价；所有结果均为结构化 JSON，无需 Walmart 开发者账号，也无需自行托管。

该服务读取已退出登录的访客可查看的 Walmart 公开页面，网址为 walmart.com 和 walmart.ca。

每月提供 1,000 个免费额度，无需绑定银行卡，按每次调用 10 个额度计算，可调用 100 次 Walmart。

https://mcp.hasdata.com/mcp?apis=walmart

• 提示词和资源

目录

• 所需条件
• 快速开始
• 提示词示例
• 工具
• 错误和故障处理路径
• 定价、免费套餐和限制
• 工具选择
• 对比情况
• 常见问题
• HasData 链接
• 开发
• 参与贡献
• 许可证

所需条件

一个 MCP 客户端，以及从 dashboard 获取的 HasData API 密钥；创建密钥免费且无需绑定银行卡。免费套餐按每次调用 10 个额度计算，每月约可调用 100 次。这是远程服务，因此最简单的接入方式是使用 URL 和 x-api-key 请求头，无需运行容器。只支持 stdio 的客户端可通过轻量启动器连接该服务。启动器已发布到 npm，包名为 @hasdata/walmart-mcp；也已发布到 PyPI，包名为 hasdata-walmart-mcp，如下所示。

快速开始

所有客户端使用相同的服务 URL。我们已在 Claude Code 和 Claude Desktop 中实际运行。其他配置块遵循各客户端针对远程服务的文档格式。

支持 OAuth 的客户端可以将相同的 URL 添加为连接器，并登录，而无需将密钥写入配置文件。

claude mcp add --transport http walmart "https://mcp.hasdata.com/mcp?apis=walmart" \
  --header "x-api-key: HASDATA_API_KEY"

{
  "mcpServers": {
    "walmart": {
      "command": "npx",
      "args": ["-y", "@hasdata/walmart-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "walmart": {
      "command": "uvx",
      "args": ["hasdata-walmart-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "walmart": {
      "url": "https://mcp.hasdata.com/mcp?apis=walmart",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "walmart": {
      "serverUrl": "https://mcp.hasdata.com/mcp?apis=walmart",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "servers": {
    "walmart": {
      "type": "http",
      "url": "https://mcp.hasdata.com/mcp?apis=walmart",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

提示词示例

以下每条提示词都会调用一个工具；如果第二个工具需要第一个工具返回的商品 ID，则会依次调用两个工具。

• 在 Walmart 上查找价格低于 $30 的笔记本电脑支架，并按价格排序。
• 商品 18493462688 现在的价格是多少？谁持有购物车首选卖家位置？
• 列出所有其他销售该商品的卖家，以及他们加上运费后的报价。
• 阅读提及该商品电池续航时间的评论。
• 仅提取该商品的已验证购买评论，并总结其中的投诉。
• 比较该商品在 walmart.com 和 walmart.ca 上的价格。

如果提示词指定的是商品而非商品 ID，则会发起两次调用：先搜索以确定 ID，再查询商品信息。评论查询也是如此，搜索结果会包含这两种查询都需要的 ID。

工具

三个工具，每次成功调用消耗 10 个积分。每个工具都接受 domain（walmart.com 或 walmart.ca）和 language 参数，其中 walmart.com 支持 en 和 es，而 walmart.ca 支持 en 和 fr。如果指定的语言不是该商城提供的语言，则会回退到默认语言。

商品 ID 仅适用于对应的商城。在 walmart.com 上，ID 为数字，例如 18493462688；在 walmart.ca 上，ID 为字母数字组合，例如 6NZMJ5CW6MH2。一个商城的 ID 无法在另一个商城中查询。

获取 Walmart 搜索结果

hasdata_walmart_search_getSearchResults

获取某个关键词、类别或两者的搜索结果页面。

传入 q 进行搜索，传入 catId 浏览整个类别，或同时传入两者以在某个类别内搜索。两者都没有出现在架构的 required 数组中，因为单独传入其中任意一个即可完成调用。

返回 searchInformation、productResults 数组、facets 块和 pagination。每项结果包含 position、id、title、url、brand、isSponsored、badges、walmartPlusSavings、categoryPathId、price 对象、包含 rating 和 totalReviews 的 reviews、image、seller、availability 和 fulfillment。

facets 块列出了查询支持的所有筛选条件，每个值都包含要传回 facet 的确切字符串。先运行一次不带筛选条件的搜索来查看 facets，比猜测更省成本。

{
  "position": 1,
  "id": "18493462688",
  "title": "Incipio Portable Foldable Aluminum Laptop Stand and Riser with Adjustable Angles, Anti-Slip and Ventilated Design",
  "url": "https://www.walmart.com/ip/Portable-Laptop-Stand-Black/18493462688",
  "isSponsored": true,
  "badges": ["Overall pick"],
  "walmartPlusSavings": true,
  "categoryPathId": "4125_4134_1074326_9623037_7875081",
  "price": { "currentPrice": 9.96, "currentPriceDisplay": "$9.96" },
  "reviews": { "rating": 4.5, "totalReviews": 49 }
}

获取 Walmart 商品详情

hasdata_walmart_product_getWalmartProduct

获取单件商品的完整信息。

传入 itemId 或 url。与搜索调用相同，两者都未列为必填项，因为单独使用其中任意一个即可。

返回一个 product 对象，其中包含 itemId、title、url、brand、brandUrl、type、model、upc、condition、badges、availability、price 对象、占据购买框的 seller、reviews、images、categoryPath、categoryPathId、highlights、specifications、keyItemFeatures、productDetails 和 fulfillment。

基础调用已经会报告页面展示的竞品数量和最低竞品价格。只有在需要获取具体报价时才启用 otherOffers，因为它会向 Walmart 发起第二次请求，费用也会增加一半。

{
  "itemId": "18493462688",
  "brand": "Incipio",
  "condition": "New",
  "price": { "currentPrice": 9.96, "currentPriceDisplay": "$9.96", "currency": "USD" },
  "seller": {
    "name": "Walmart.com",
    "id": "F55CDC31AB754BB68FE0B39041159D63",
    "returnPolicy": "Free 30-day returns"
  },
  "reviews": {
    "totalReviews": 49,
    "rating": 4.5,
    "fiveStars": 38,
    "fourStars": 4,
    "threeStars": 3,
    "twoStars": 1,
    "oneStar": 3
  },
  "specifications": [{ "name": "Maximum screen size", "value": "16 in" }],
  "fulfillment": {
    "type": "FC",
    "message": "Pickup, today at Fredericksburg Massaponax Supercenter",
    "deliveryDate": "2026-09-09T21:59:00.000Z"
  }
}

获取 Walmart 商品评价

hasdata_walmart_reviews_getWalmartReviews

单个商品的评价流，每页 10 条评价。

返回 reviewsInformation、reviewResults 数组、filters 块、appliedFilters 和 pagination。

filters 是最值得优先查看的部分。它会列出该商品实际支持筛选的星级、常见提及内容和状况，每项都附有计数和需要传回的确切 value。例如，若看到 {"name": "Battery Life", "value": "6049", "count": 8}，则传入 aspectId: "6049"，预期会得到 8 条评价。与其在这里读取主题 ID，不如自行猜测；后者通常会导致结果为空。

reviewsInformation 包含商品评分、各星级的细分数据、各主题的评分，以及 Walmart 的 AI 评价摘要。它还会分别提供 totalRatings 和 totalReviews，两者含义不同：下方商品有 49 个评分，但只有 21 条文字评价，分页涵盖的是这 21 条。

{
  "reviewsInformation": {
    "rating": 4.49,
    "totalRatings": 49,
    "totalReviews": 21,
    "recommendedPercentage": 100,
    "ratingBreakdown": { "fiveStars": 38, "fourStars": 4, "threeStars": 3, "twoStars": 1, "oneStar": 3 }
  },
  "reviewResults": [
    {
      "position": 1,
      "id": "434698083",
      "rating": 5,
      "title": "Good value laptop stand.",
      "text": "Good value for money. Not the sturdiest, but that is to be expected for a collapsible laptop stand. Overall gets the job done, I'd buy it again.",
      "date": "8/1/2026",
      "verifiedPurchase": true,
      "helpfulVotes": 0,
      "notHelpfulVotes": 0,
      "badges": ["Verified Purchase"],
      "seller": "Walmart.com",
      "language": "English",
      "aspects": [{ "id": "284", "polarity": "Positive" }]
    }
  ],
  "filters": [
    { "name": "Star rating", "parameter": "rating", "values": [{ "name": "5 stars", "value": "5", "count": 38 }] },
    { "name": "Frequent mentions", "parameter": "aspectId", "values": [{ "name": "Sturdiness", "value": "828", "count": 6 }] }
  ],
  "pagination": { "currentPage": 1, "reviewsPerPage": 10, "totalPages": 3, "totalResults": 21, "nextPage": 2 }
}

提示词和资源

该服务提供 5 个资源，每个资源对应一个可接受值为固定列表的参数。读取资源比从被拒绝的调用中摸索可用值更省事，而且不消耗额度。每个 URI 的格式为 hasdata://walmart/<parameter>。

无需 API 密钥即可获取此列表，因此客户端可以在用户注册之前读取它。

错误和失败路径

请为这些情况做好准备，而不要假设一切都会顺利。

一次搜索响应中的两个总数不一致，但都正确。 searchInformation.totalResultsDisplay 是 Walmart 在页面上显示的字符串，例如 "1000+"；pagination.totalResults 则是其背后的数量，例如 8005。前者是显示文本，后者是整数，因此不要解析前者，也不要打印后者。

Walmart 大约在第 10 页后停止提供结果。 再往后的页面会返回空结果，而不是报错。无法通过翻页枚举大型关键词的所有结果，因此请改用 facet、价格区间或类别缩小范围。

价格对应一家门店，响应会说明是哪家。 searchInformation.storeId 会标明门店，fulfillment.message 则会用文字说明，精确到 "Pickup, today at Fredericksburg Massaponax Supercenter"。只有门店保持不变时，跨调用比较价格才有意义。

deliveryType: pickup 的查询会针对单家门店返回结果。 某件商品即使全国有货，也可能返回缺货，因为它在那家门店缺货，而不是所有门店都缺货。

商品工具报告的是评分，而不是评论数。 其 reviews.totalReviews 表示评分数量，上述商品有 49 条评分；评论工具则会分别报告 49 条评分和 21 条书面评论。两者有区别时，请使用评论工具。

评论日期是 M/D/YYYY 格式的字符串。 "8/1/2026" 表示 8 月 1 日，而不是 1 月 8 日。请根据已知格式解析，不要让日期库自行猜测。

评论可能带有 filters 中不存在的 aspect id。 该区块列出了可用于筛选商品的主题，其列表比评论所标记的主题列表短。请从评论中读取 aspects，并且只使用该区块提供的 id 进行筛选。

没有变体的商品不会返回空的 variants，而是缺少该字段。 读取前请先检查该键是否存在。

每个请求只能指定一个 condition。 该参数只接受单个值，因此查询两种 condition 需要调用两次。

包含数据的结果也会包含一个值得在支持请求中引用的 requestMetadata.id。

定价、免费套餐和限制

每次成功调用 Walmart 工具需 10 个 credits。启用 otherOffers 会使商品调用额外增加 5 个 credits，总计 15 个，而不是 10 个；除非关注的是竞争对手的报价，否则请保持关闭。响应大小不会改变价格。

免费套餐为 每月 1,000 个 credits，无需绑定银行卡，按基础费率可调用 Walmart 100 次。免费额度会随计费周期续期，因此低调用量的 Agent 可以无限期使用免费套餐。

付费套餐起价为 每月 $59，可获得 200,000 个 credits，相当于 20,000 次调用。调用量越大，单价越低：入门套餐每 1,000 次调用为 $2.95，Basic 套餐为 $1.19，Growth 各套餐为 $0.83。最新数据请查看定价页面。

套餐还会决定并发数。免费套餐允许同时处理 1 个请求，Startup 为 5 个，Basic 为 15 个，Growth 各套餐则为 50 到 500 个。对于无人值守的任务，遇到 429 错误时请采用退避策略重试，因为跨多个商品 id 扇出请求的 Agent 会比你更早触及上限。

返回非 200 状态码的请求不会计费。成功调用但未找到任何结果，也仍然算作一次调用。

工具选择

从提示提供的信息入手。关键词或类别应使用搜索工具，商品 ID 则直接使用商品或评论工具。为了获取已有的 ID 而额外调用搜索，是最常见的浪费。

然后根据问题的内容选择工具。对于多个商品的排名、价格扫描和货架份额分析，搜索结果就足够了。只有商品工具提供规格、购物车首选卖家和竞争报价数量。只有评论工具提供评论文本。

筛选前先阅读 filters 块。先调用一次不带筛选条件的评论工具，就能了解有哪些评分、主题和条件，以及每种条件下有多少条评论，从而把猜测的筛选条件变成已知信息。

对比

Walmart 自有的 Affiliate 和 Marketplace API 是获取这些数据的官方途径，但它们回答的问题各不相同。

决定性因素是范围。两种官方 API 都只能查询你有商业关系的目录，因此无法用于监控竞争对手。如果商品属于你自己，Marketplace API 具有权威性且免费，你应该使用它。

常见问题

有官方的 Walmart MCP 服务吗？

Walmart 没有发布官方服务。这个服务由 HasData 维护，读取 Walmart 的公开页面。

什么是 Walmart MCP 服务？

MCP 服务会公开 AI 客户端可以调用的工具。这个服务会将 Walmart 搜索结果、商品页面和评论源转换为 Agent 可用于推理的 JSON，无需在技术栈中使用浏览器或抓取库。

我需要 Walmart 账户或卖家账户吗？

不需要。你只需要 HasData 密钥。

支持哪些店面？

walmart.com 和 walmart.ca。它们拥有独立的目录、商品 ID、价格和货币，因此跨店面对比是真正的对比，而非货币换算。

为什么我的商品 ID 没有返回结果？

最常见的原因是该 ID 属于另一个店面。数字 ID 属于 walmart.com，字母数字 ID 属于 walmart.ca，二者都无法在另一个店面解析。传入 domain 以匹配店面，或传入完整的 url，让服务自动设置店面。

如何获取竞争报价？

在商品工具调用中设置 otherOffers。每条报价都会返回卖家名称、店面 URL、价格、条件、运费、送达日期和退货政策。由于需要向 Walmart 发起第二次请求，因此会额外消耗 5 个积分。

为什么同一搜索在不同日期返回的价格不一样？

部分原因是价格会变动，部分原因是响应基于某一家 Walmart 门店生成，门店信息以 searchInformation.storeId 返回。将门店保持一致后，再判断价格是否发生变化。

我可以将此服务与其他 HasData API 一起使用吗？

可以。一个密钥即可访问所有服务，一个端点通过 apis 参数提供所有服务。将客户端指向 ?apis=walmart,amazon，即可在同一连接中获取两组工具；也可以访问 mcp.hasdata.com/mcp 查看完整目录。

HasData 与 Walmart 有关联吗？

没有。HasData 是一项独立服务，与 Walmart 无关联，也未获得 Walmart 的认可或赞助。Walmart 是其各自所有者的商标。这些工具仅处理公开数据，您有责任确保按照 Walmart 的条款及适用于您的法律使用结果。

合规与个人数据

评价中包含评价者选择公开的作者姓名，以及已验证购买标记。商城卖家条目中包含商家名称和店铺 URL。这两类信息在进行情感分析或定价工作时都不需要作者字段，因此除非您的用途需要，否则请删除这些字段；存储这些信息前，请先确认您自身的义务。

HasData 链接

• Walmart API 文档，这些工具背后的 REST 端点
• MCP 服务文档
• 定价
• 控制面板

其他 HasData MCP 服务：Google Search、Google Maps、Google Trends、Google Flights、DuckDuckGo、YouTube、TikTok、Instagram、Amazon、Shopify、Yelp、Zillow、Redfin、Airbnb、Booking.com、Indeed。

开发

启动器是连接到远程服务的轻量级 stdio 桥接，因此无需构建。

npm install
HASDATA_API_KEY=your_key_here npm test

test/ 中的测试用于验证工具契约，也就是可能在此处没有提交的情况下发生变化的部分。测试会检查 ?apis=walmart 是否返回预期的工具数量、名称是否均未更改、每个工具是否仍带有说明、此 README 文档中描述的二选一参数是否仍存在于架构中，以及正在使用的密钥是否确实有效。最后一项检查会实际调用一个工具，并消耗 10 个 credits；这是为了一次可能因正确原因而失败的金丝雀测试所付出的代价。

这三个工具都没有声明必填参数，因为每个工具都接受两种输入之一。测试套件会固定这些可选项，而不是检查 required 数组；若只检查该数组，即使架构中没有任何说明，测试也可能通过。

契约测试套件还会按计划每周运行，因为上游工具列表可能发生变化，而无需有人修改此仓库。

贡献

如果工具表、响应示例或记录的行为与实际情况不符，欢迎提交 issue。我们专门为此提供了模板。欢迎针对这些问题以及启动器中的任何内容提交拉取请求。

许可证

MIT，详见 LICENSE。