HasData Walmart

Walmart MCP サーバー

Claude、Cursor、Windsurf、その他の MCP クライアントに、読み取り専用の Walmart ツールを 3 つ提供するホスト型の Model Context Protocol（MCP）サーバーです。キーワードまたはカテゴリで検索し、購入ボックスを保持する販売者がいる商品を 1 つ読み込み、そのカスタマーレビューをページごとに取得できます。すべて構造化された JSON で取得でき、Walmart の開発者アカウントもホスティング環境も不要です。

サインアウトした訪問者が閲覧できる、walmart.com および walmart.ca の公開 Walmart ページを読み取ります。

毎月 1,000 クレジットを無料で利用でき、カードは不要です。10 クレジットのレートで、Walmart への呼び出しを 100 回行えます。

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

• プロンプトとリソース

目次

• 必要なもの
• クイックスタート
• プロンプトの例
• ツール
• エラーと失敗時の処理
• 料金、無料枠、制限
• ツールの選び方
• 比較
• FAQ
• HasData のリンク
• 開発
• コントリビューション
• ライセンス

必要なもの

MCP クライアントと、ダッシュボードで取得できる 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" }
    }
  }
}

プロンプトの例

以下の各プロンプトは1つのツールを呼び出します。2つ目のツールが1つ目のツールの返す商品 ID を必要とする場合は、順番に2つのツールを呼び出します。

• Walmart で30ドル未満のノートパソコンスタンドを探し、価格順に並べてください。
• 商品 ID 18493462688 の現在の価格と、購入ボックスを獲得している販売者を教えてください。
• この商品を販売している他のすべての販売者と、送料込みの価格を見せてください。
• バッテリー駆動時間について言及している、この商品のレビューを読んでください。
• この商品の認証済み購入レビューだけを取得し、苦情を要約してください。
• walmart.com と walmart.ca でのこの商品の価格を比較してください。

商品 ID ではなく商品名を指定するプロンプトでは、商品 ID を特定する検索と、その商品情報を取得する検索の2回の呼び出しが必要です。レビューも同様で、検索結果にはどちらの呼び出しにも必要な ID が含まれています。

ツール

ツールは3つあり、呼び出しが成功するごとに10クレジットかかります。各ツールでは domain に walmart.com または walmart.ca を、language に言語を指定します。walmart.com では en と es、walmart.ca では en と fr を利用できます。ストアフロントで提供されていない言語を指定すると、デフォルトの言語にフォールバックします。

商品 ID はストアフロントごとに異なります。walmart.com では 18493462688 のような数字のみ、walmart.ca では 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 に指定する正確な文字列が含まれています。フィルターなしで検索を 1 回実行してファセットを確認するほうが、推測するよりも低コストです。

{
  "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 を指定します。検索と同様、どちらか一方だけで機能するため、どちらも必須として記載されていません。

itemId、title、url、brand、brandUrl、type、model、upc、condition、badges、availability、price オブジェクト、購入ボックスの商品を販売する seller、reviews、images、categoryPath、categoryPathId、highlights、specifications、keyItemFeatures、productDetails、fulfillment を含む product オブジェクトを返します。

基本の呼び出しでも、ページに表示されている競合数と、競合商品の最安価格が返されます。オファーそのものが必要な場合に限り、otherOffers を有効にしてください。Walmart へのリクエストがもう 1 回必要になり、コストも 1.5 倍になるためです。

{
  "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

1商品のレビューフィードです。1ページあたり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つのリソースを公開します。受け付ける値が固定リストになっている各パラメーターに1つずつ対応しています。拒否された呼び出しから用語を覚えるより、リソースを1つ読むほうが手軽で、クレジットも消費しません。各URIはhasdata://walmart/<parameter>です。

このリストはAPIキーなしで提供されるため、クライアントはユーザーがサインアップする前に読み取れます。

エラーと失敗時の処理

正常に動作するケースだけを想定せず、こうした状況にも備えてください。

1 回の検索レスポンスで合計数が食い違っていても、どちらも正しい場合があります。 searchInformation.totalResultsDisplay は、Walmart がページ上に表示する文字列で、たとえば "1000+" です。一方、pagination.totalResults は、その背後にある数値で、たとえば 8005 です。一方は表示用のテキスト、もう一方は整数なので、前者を数値として解析したり、後者を表示したりしないでください。

Walmart はおよそ 10 ページを超えると結果を返さなくなります。 それ以降はエラーではなく、空のページが返ってきます。大まかなキーワードではページをたどってすべての結果を取得できないため、代わりに facet、価格帯、またはカテゴリで絞り込んでください。

価格は 1 つの店舗のもので、レスポンスにはどの店舗かが示されます。 searchInformation.storeId に店舗名が記載され、fulfillment.message には "Pickup, today at Fredericksburg Massaponax Supercenter" のように言葉で示されます。呼び出し間で価格を比較する意味があるのは、同じ店舗が対象になっている場合だけです。

deliveryType: pickup は 1 つの店舗を対象に応答します。 全国的には在庫がある商品でも、その店舗では在庫がないために、利用不可として返されることがあります。

商品ツールは、レビューを読む場面で評価数を報告します。 上記の商品では reviews.totalReviews は評価数の 49 を示しますが、レビュー用ツールは評価数 49 件と文章付きレビュー 21 件を別々に報告します。両者の違いが重要な場合は、レビュー用ツールを使ってください。

レビューの日付は M/D/YYYY 形式の文字列です。 "8/1/2026" は 8 月 1 日であり、1 月 8 日ではありません。日付ライブラリに推測させず、形式を明示して解析してください。

レビューに、filters に存在しないアスペクト ID が含まれることがあります。 このブロックには、その商品で絞り込み可能なトピックが列挙されていますが、レビューにタグ付けされたトピックよりも少ないリストです。レビューからアスペクトを読み取り、ブロックにある ID だけを使って絞り込んでください。

バリエーションがない商品では、variants は空ではなく、キー自体がありません。 読み取る前に、キーの存在を確認してください。

1 回のリクエストで指定できる condition は 1 つだけです。 このパラメーターには単一の値を指定するため、2 つの条件を対象に検索するには、2 回呼び出す必要があります。

データを含む結果には、サポートへの問い合わせ時に伝えると役立つ requestMetadata.id も含まれます。

料金、無料枠、制限

Walmart ツールは、成功した呼び出し 1 回につき 10 クレジットかかります。otherOffers を有効にすると、商品呼び出しは 10 クレジットではなく 15 クレジットになり、5 クレジット追加されます。競合する販売情報が目的でない限り、オフのままにしてください。レスポンスのサイズによって料金は変わりません。

無料枠は、カード登録不要で毎月 1,000 クレジットです。基本料金で Walmart を 100 回呼び出せます。請求サイクルごとに更新されるため、呼び出し頻度の低いエージェントは、無料枠を期限なく利用できます。

有料プランは、200,000 クレジットを利用できる月額 $59から始まります。呼び出し回数にすると 20,000 回です。単価は利用量に応じて下がり、エントリープランの呼び出し 1,000 回あたり $2.95から、Basic では**$1.19**、Growth ティアでは**$0.83**になります。最新の料金は料金ページをご覧ください。

同時実行数もプランによって異なります。無料枠では同時に 1 件、Startup では 5 件、Basic では 15 件まで、Growth ティアでは 50 件から 500 件まで実行できます。無人で実行する処理では、429 が返されたらバックオフを設定して再試行してください。商品 ID を複数に分けて並行処理するエージェントは、あなたが上限に達する前に同時実行数の上限に達するためです。

200 以外のステータスコードで返されたリクエストには課金されません。何も見つからなかった場合でも、成功した呼び出しとして課金されます。

ツールの選び方

まず、プロンプトで与えられた情報を確認します。キーワードまたはカテゴリなら検索ツール、商品 ID なら商品ツールまたはレビュー ツールに直接進みます。すでに商品 ID が分かっているのに、検索を呼び出して探すのは最もよくある無駄です。

次に、質問の内容に応じて選びます。検索結果は、複数商品のランキング、価格調査、棚シェア分析に十分です。仕様、カートボックスの販売者、競合出品数を取得できるのは商品ツールだけです。レビュー本文を取得できるのはレビュー ツールだけです。

フィルターを適用する前に、filters ブロックを確認してください。フィルターなしでレビューを一度呼び出すと、どの評価、トピック、条件があり、それぞれにレビューが何件あるかが分かるため、推測で選んでいたフィルターを、把握したうえで選べるようになります。

比較

Walmart の公式 Affiliate API と Marketplace API は、このデータを取得するための公式な方法ですが、それぞれ答えられる質問は異なります。

決め手となるのは対象範囲です。どちらの公式 API も、商取引上の関係があるカタログについての質問に答えるため、競合の動向を調べる用途には適しません。自社の商品を対象とする場合は、Marketplace API が最も信頼でき、無料で利用できるため、そちらを使ってください。

よくある質問

公式の Walmart MCP サーバーはありますか？

Walmart は公開していません。このサーバーは HasData が保守しており、公開されている Walmart のページを読み取ります。

Walmart MCP サーバーとは何ですか？

MCP サーバーは、AI クライアントが呼び出せるツールを公開します。このサーバーは、Walmart の検索結果、商品ページ、レビューのフィードを、スタックにブラウザーやスクレイピングライブラリを追加することなく、エージェントが推論できる JSON に変換します。

Walmart アカウントや販売者アカウントは必要ですか？

いいえ。必要な認証情報は HasData キーだけです。

対応しているストアフロントはどれですか？

walmart.com と walmart.ca です。それぞれカタログ、商品 ID、価格、通貨が異なるため、ストアフロントをまたいだ比較は、単なる通貨換算ではなく実際の比較になります。

商品 ID を指定しても結果が返らないのはなぜですか？

多くの場合、商品 ID が別のストアフロントのものだからです。数値 ID は walmart.com、英数字の ID は walmart.ca のものであり、互いのストアフロントでは解決されません。一致する domain を渡すか、ストアフロントの判定を任せるために完全な url を渡してください。

競合の出品を取得するにはどうすればよいですか？

商品ツールの呼び出しで otherOffers を設定してください。各出品について、販売者名、ストアフロントの URL、価格、コンディション、送料、配達日、返品ポリシーが返されます。Walmart へのリクエストがもう 1 回必要になるため、追加で 5 クレジットかかります。

同じ検索でも日によって価格が異なるのはなぜですか？

価格自体が変動することに加え、レスポンスが特定の Walmart ストアを対象としており、そのストアは searchInformation.storeId で報告されます。価格の変化を価格変動として捉える前に、対象のストアを固定してください。

他の HasData API と併用できますか？

はい。1 つのキーですべてを利用でき、1 つのエンドポイントから apis パラメーターを通じてすべてにアクセスできます。クライアントを ?apis=walmart,amazon に向けると、1 つの接続で両方のツールセットを利用できます。または、すべてのカタログを利用する場合は mcp.hasdata.com/mcp を指定してください。

HasData は Walmart と提携していますか？

いいえ。HasData は独立したサービスであり、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 クレジットを消費します。これは、適切な理由で失敗する可能性のあるカナリアテストの料金です。

3 つのツールはいずれも必須パラメーターを宣言していません。それぞれが 2 つの入力のいずれかを受け付けるためです。テストスイートでは、スキーマに何も記載されていなくても通過してしまう required 配列ではなく、代替の入力を固定して検証します。

上流のツール一覧は、このリポジトリに変更がなくても変わる可能性があるため、契約テストスイートはスケジュールに従って毎週実行されます。

貢献

ツールの表、レスポンスのサンプル、または実際の動作と異なる説明については、Issue を作成する価値があります。そのためのテンプレートを用意しています。同様の内容や、ランチャーに関する変更のプルリクエストも歓迎します。

ライセンス

MIT。詳しくは LICENSE をご覧ください。