walmart

@striderlabs/mcp-walmart

Walmart での小売ショッピング向け MCP サーバーコネクターです。ブラウザー自動化を通じて、商品検索、カート管理、注文追跡を行います。

エージェント向け

このコネクターにより、エージェントはユーザーに代わって自律的に買い物できます。エージェントは次のことができます。

• 購入する商品を把握する： 買い物リスト、食事の好み、予算の制約、季節ごとのニーズを理解します
• 的確に検索する： フィルター（価格、評価）を使って商品を見つけ、選択肢を比較します
• 効率的に実行する： カートを作成し、合計金額を確認して、最終購入の確認のために引き継ぎます
• 注文を追跡する： 配送状況を監視し、商品が到着したらユーザーに通知します

エージェントのワークフロー例：

ユーザー：「今週分の食料品が必要です。予算は $100 で、ベジタリアン向けの商品が必要です。」

エージェントが実行：

1. set_address → 地元の店舗での在庫状況を取得
2. search → 「有機野菜」、max_price: 50
3. search → フィルターを設定して「米、パスタ、豆類」を検索
4. get_product → 各商品の栄養情報と価格を確認
5. add_to_cart → $100 以内で最適化したカートを作成
6. checkout → 合計金額（$94.32）を確認し、概要をユーザーに返す
7. ユーザーが承認 → エージェントが購入を完了

すべてをシームレスなエージェントのターンで行います。

概要

このパッケージは、Playwright のブラウザー自動化とボット検出を回避するためのステルス機能を使用して、AI エージェントが Walmart.com とやり取りできるようにする Model Context Protocol (MCP) サーバーを提供します。

インストール

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	いいえ*	ZIP コード（例："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 のカート内商品の数量を更新します。

Parameter	Type	Required	Description
quantity	number	Yes	新しい数量（1 以上である必要があります）
item_id	string	No*	Walmart 商品アイテム ID
product_name	string	No*	照合する商品の部分的な名前

*item_id または product_name の少なくとも一方が必要です。

---

remove_from_cart

Walmart のカートから特定の商品を削除します。

Parameter	Type	Required	Description
item_id	string	No*	Walmart 商品アイテム ID
product_name	string	No*	照合する商品の部分的な名前

*item_id または product_name の少なくとも一方が必要です。

---

checkout

Walmart のカートのチェックアウト概要をプレビューします。注文を確定せずに注文の詳細を返します。

パラメーターは不要です。

注：このツールは意図的に注文を確定しません。手動で続行する前に確認できるよう、注文概要（商品、小計、税額、合計）を返します。

---

get_orders

Walmart の注文履歴を取得します。

Parameter	Type	Required	Description
limit	number	No	取得する最近の注文数（デフォルト：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