walmart

@striderlabs/mcp-walmart

用于 Walmart 零售购物的 MCP 服务连接器——通过浏览器自动化搜索商品、管理购物车和跟踪订单。

面向 Agent

此连接器可让 Agent 代表用户自主购物。Agent 可以：

• 了解要买什么： 理解购物清单、饮食偏好、预算限制和季节性需求
• 智能搜索： 使用筛选条件（价格、评分）查找商品并比较选项
• 高效执行： 添加商品到购物车、查看总价，并提交给用户确认最终购买
• 跟踪订单： 监控配送状态，并在商品送达时通知用户

Agent 工作流示例：

用户：“我需要一周的食品杂货。预算是 $100，并且需要素食选项。”

Agent 执行：

1. set_address → 获取本地门店的商品库存情况
2. search → 搜索“有机蔬菜”，设置 max_price: 50
3. search → 使用筛选条件搜索“大米、意大利面、豆类”
4. get_product → 查看每件商品的营养信息和价格
5. add_to_cart → 添加商品，构建低于 $100 的优化购物车
6. checkout → 查看总价（$94.32），并向用户返回摘要
7. 用户批准 → Agent 完成购买

所有操作都在一次连贯的 Agent 交互中完成。

概述

此软件包提供一个 Model Context Protocol (MCP) 服务，使 AI Agent 能通过 Playwright 浏览器自动化与 Walmart.com 交互，并使用隐身功能避免被检测为机器人。

安装

npx @striderlabs/mcp-walmart

或全局安装：

npm install -g @striderlabs/mcp-walmart
mcp-walmart

MCP 配置

添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "walmart": {
      "command": "npx",
      "args": ["@striderlabs/mcp-walmart"]
    }
  }
}

工具

status

检查 Walmart 身份验证状态和会话信息。

无需参数。

{}

---

login

通过浏览器自动化使用电子邮件和密码登录 Walmart 账户。

参数	类型	必填	说明
email	string	是	Walmart 账户电子邮件地址
password	string	是	Walmart 账户密码
headless	boolean	否	以无头模式运行浏览器（默认值：true）。设置为 false 可显示浏览器窗口。

---

logout

清除 Walmart 会话和已存储的 Cookie。

无需参数。

---

set_address

设置 Walmart 的配送或自提地址。此设置会影响商品库存情况和价格。

参数	类型	必填	说明
zip_code	string	否*	邮政编码（例如，"90210"）
address	string	否*	完整地址（例如，"123 Main St, Chicago, IL 60601"）

*必须至少提供 zip_code 或 address 其中之一。

---

search

根据查询词搜索 Walmart 商品，可选择使用筛选条件。

参数	类型	必填	说明
query	string	是	搜索词
min_price	number	否	最低价格筛选条件
max_price	number	否	最高价格筛选条件
sort_by	string	否	排序方式：relevance、price_low、price_high、best_seller、rating_high
limit	number	否	结果数量上限（默认值：10，最大值：24）

---

get_product

获取商品详细信息，包括价格、描述和库存情况。

参数	类型	必填	说明
url	string	否*	Walmart 商品完整 URL
item_id	string	否*	Walmart 商品项目 ID

*必须至少提供 url 或 item_id 其中之一。

---

add_to_cart

将商品添加到 Walmart 购物车。

参数	类型	必填	说明
url	string	否*	Walmart 商品 URL
item_id	string	否*	Walmart 商品项目 ID
quantity	number	否	添加数量（默认值：1）

*必须至少提供 url 或 item_id 其中之一。

---

view_cart

查看当前 Walmart 购物车中的商品和总价。

无需参数。

---

update_cart

更新 Walmart 购物车中商品的数量。

参数	类型	必填	描述
quantity	number	是	新数量（必须 >= 1）
item_id	string	否*	Walmart 商品 ID
product_name	string	否*	用于匹配的部分商品名称

*必须提供 item_id 或 product_name 中的至少一项。

---

remove_from_cart

从 Walmart 购物车中移除指定商品。

参数	类型	必填	描述
item_id	string	否*	Walmart 商品 ID
product_name	string	否*	用于匹配的部分商品名称

*必须提供 item_id 或 product_name 中的至少一项。

---

checkout

预览 Walmart 购物车的结账摘要。返回订单详情，但不会下单。

无需参数。

注意：此工具不会下单。它会返回订单摘要（商品、小计、税费和总计），供你查看后再手动继续操作。

---

get_orders

获取 Walmart 订单历史记录。

参数	类型	必填	描述
limit	number	否	返回近期订单的数量（默认：10）

---

会话持久化

Cookie 和身份验证信息存储在 ~/.striderlabs/walmart/ 中，并会在会话之间保留。登录后，后续工具调用会复用现有会话，无需重新进行身份验证。

技术详情

• 传输方式：stdio（标准 MCP 传输方式）
• 浏览器：通过 Playwright 使用 Chromium，并应用隐身补丁
• 绕过机器人检测：移除 webdriver 标志，伪造插件和语言信息，并修补 permissions API
• 会话存储：~/.striderlabs/walmart/cookies.json 和 ~/.striderlabs/walmart/auth.json

要求

• Node.js >= 18.0.0
• Chromium（随 Playwright 自动安装）

许可证

MIT — Strider Labs