HasData Amazon

Amazon MCP Server

Claude、Cursor、Windsurf、その他すべての MCP クライアントに、読み取り専用の Amazon ツールを4つ提供するホスト型 Model Context Protocol（MCP）サーバーです。キーワード検索、ASINによる商品の詳細確認、出品者の検索、その出品者が取り扱う商品のページングを、すべて構造化された JSON で実行できます。Amazon の開発者アカウントも、ホストするものも必要ありません。

ログアウト状態の訪問者が閲覧できる公開 Amazon ページを、23の地域別ドメインすべてで読み取ります。

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

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

• プロンプトとリソース

目次

• 必要なもの
• クイックスタート
• プロンプトの例
• ツール
• エラーと失敗時の処理
• 料金、無料枠、制限
• ツールの選択
• 比較
• よくある質問
• HasData のリンク
• 開発
• コントリビュート
• ライセンス

必要なもの

MCP クライアントと、ダッシュボードで取得できる HasData API キーが必要です。カード登録なしで無料で作成でき、無料枠では10クレジットのレートで月に約100回呼び出せます。これはリモートサーバーなので、最も簡単な方法は URL と x-api-key ヘッダーを使うことです。コンテナを実行する必要はありません。stdio のみを使用するクライアントからは、薄いランチャーを介して接続できます。このランチャーは npm では @hasdata/amazon-mcp、PyPI では hasdata-amazon-mcp として公開されており、以下に示します。

クイックスタート

サーバー URL はどのクライアントでも同じです。Claude Code と Claude Desktop では実際に動作させる手順を紹介します。その他のブロックでは、各クライアントがリモートサーバー向けにドキュメント化している形式に従います。

OAuth に対応しているクライアントでは、同じ URL をコネクターとして追加してサインインすれば、設定ファイルにキーを記載せずに利用できます。

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

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

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

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

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

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

プロンプトの例

以下のプロンプトはそれぞれ1つのツールを呼び出します。2つ目のツールが1つ目のツールから返される識別子を必要とする場合は、順番に2つ呼び出します。

• Amazon で40ドル未満のノートパソコンスタンドを探し、平均カスタマーレビュー順に並べてください。
• ASIN B0DHJ7SBDR の現在の価格と、出品している他の販売者の数を教えてください。
• この ASIN の価格を amazon.com と amazon.de で比較してください。
• ASIN B0DHJ7SBDR の販売者は誰で、これまでの評価はどうなっていますか？
• 販売者 ATQQBVXK188KS が在庫している商品をすべて確認し、割引商品を抽出してください。
• 10001 への配送に対応しているワイヤレスイヤホンを検索し、最も早く届く商品を教えてください。

ASIN ではなく商品名を指定するプロンプトでは、ASIN を特定するための検索と、商品情報を取得するための照会の2回の呼び出しが必要です。販売者 ID ではなくブランド名で販売者を指定するプロンプトも同様で、販売者 ID を見つけるための商品照会と、プロフィールを取得するための販売者照会が必要です。

ツール

ツールは5つで、成功した呼び出し1回につき10クレジットです。すべてのツールで domain を指定してマーケットプレイスを切り替えられます。値は23種類あり、www.amazon.com からヨーロッパ、アジアなどの各地域のマーケットプレイスまで対応しています。また、マーケットプレイスが複数の言語に対応している場合は language も指定できます。

Amazon の検索結果を取得

hasdata_amazon_search_getSearchResults

キーワードの検索結果の1ページ分です。

productResults、スポンサー枠のads配列、およびtotalResults、currentPage、nextPageUrl、otherPageUrlsを含むpaginationを返します。各結果には、position、asin、title、url、isSponsored、priceオブジェクト、image、ratingとtotalReviewsを含むreviews、badgesオブジェクト、boughtInPastMonth、deliveryInfoが含まれます。

検索結果には、意図的に必要最低限の情報だけが含まれています。ブランド、特徴、バリエーション、画像、販売者の情報はここにはなく、以下の商品ツールで取得します。まずASINを特定してから、商品情報を取得してください。

{
  "position": 1,
  "asin": "B077B9W343",
  "title": "Nulaxy Ergonomic Adjustable Laptop Stand for Desk, Dual Foldable Computer Riser...",
  "isSponsored": false,
  "price": { "symbol": "$", "currentPrice": 15.99, "beforePrice": 17.99 },
  "image": "https://m.media-amazon.com/images/I/61jtA8kHq9L.jpg",
  "reviews": { "totalReviews": 16800, "rating": 4.7 },
  "badges": { "amazonChoice": true, "amazonPrime": false, "bestSeller": false },
  "boughtInPastMonth": "10K+",
  "deliveryInfo": { "freeDelivery": "Join Prime", "fastestDelivery": "Mon, Sep 14" },
  "url": "https://www.amazon.com/dp/B077B9W343"
}

Amazon の商品詳細を取得

hasdata_amazon_product_getProductDetails

ASINを指定して、1つの商品情報をすべて取得します。

asin、url、title、brand、isAvailable、condition、priceオブジェクト、primaryFeatures、より幅広い情報を含むfeaturesマップ、featureBullets、description、variants、breadcrumbs、whatIsInTheBox、画像と動画のコレクション、specification、reviewsInfo、配送予定日、現在の販売者とそのsellerUrlを含むproductオブジェクトを返します。

priceオブジェクトには、currentPrice、商品が割引されている場合のbeforePrice、discount、priceFrom、otherOfferQuantityが含まれます。最後の項目は競合する出品数です。基本の呼び出しでは、出品情報を取得せずに件数のみを返します。出品情報そのものが必要な場合に限り、otherSellersを指定してください。追加コストが基本料金の半分かかります。

{
  "asin": "B0DHJ7SBDR",
  "title": "Apple iPhone 16 Pro Max, 1TB, Desert Titanium",
  "brand": "Apple",
  "condition": "Refurbished - Excellent",
  "price": {
    "symbol": "$",
    "currentPrice": 974,
    "beforePrice": 949.99,
    "discount": "-11%",
    "otherOfferQuantity": 11
  },
  "seller": "WirelessSource",
  "deliveryIsoDate": "2026-09-11T00:00:00.000Z"
}

Amazon の販売者詳細を取得

hasdata_amazon_seller_getSellerDetails

1人の販売者の公開ストアフロントプロフィールです。

sellerId、url、storefrontUrl、name、businessName、businessAddress、aboutブロック、およびoneMonthRatings、threeMonthRatings、twelveMonthRating、lifetimeRatingという4つの期間別評価を含むsellerオブジェクトを返します。各期間の評価には、totalVotes、averageRating、星の数ごとのvotesとpercentの内訳が含まれます。

このツールを呼び出す価値があるのは、4つの期間別評価が得られるためです。2,701件の投票で生涯平均が4.5の販売者と、4件の投票で1か月平均が2の販売者では、状況が大きく異なります。両方の評価を見比べることで、評価が下がりつつあることが分かります。

{
  "sellerId": "ATQQBVXK188KS",
  "name": "Expercom - Apple Premier Partner",
  "businessName": "Expercom of Utah, Inc",
  "lifetimeRating": { "totalVotes": 2701, "averageRating": 4.5 },
  "oneMonthRatings": { "totalVotes": 4, "averageRating": 2 }
}

Amazon の出品者の商品を取得する

hasdata_amazon_seller_products_getSellerProducts

ある出品者が取り扱う商品の1ページ分です。

検索ツールの出力と同様の形式で、productResults と pagination を返します。各項目には position、asin、title、url、price、image、reviews、badges、boughtInPastMonth、deliveryInfo、colorUrls が含まれます。ページ番号を推測するのではなく、pagination をたどってカタログの残りを取得してください。

プロンプトとリソース

このサーバーには、ユーザーにツール呼び出しを作成させる代わりにクライアントが提示できる、すぐに使えるワークフローであるプロンプトが1つ用意されています。

また、このサーバーは、受け付ける値が固定リストになっているパラメーターごとに1つ、計9つのリソースを公開しています。値が無効な呼び出しで用語を学ぶより、リソースを読むほうが効率的で、クレジットも消費しません。各URIは hasdata://amazon/<parameter> です。

どちらのリストもAPIキーなしで提供されるため、クライアントはユーザーが登録する前に読み取ることができます。

エラーと失敗するケース

正常に処理される場合だけを想定せず、以下のケースに備えてください。

検索で一致するものがない場合、エラーではなく、空の productResults 配列を含む成功結果が返されます。 requestMetadata.status は引き続き ok です。反復処理の前に配列の長さを確認してください。

選択したマーケットプレイスに存在しないASINの場合、空の商品ではなくエラーが返されます。 同じASINがあるドメインには存在しても、別のドメインには存在しないことがよくあります。そのため、www.amazon.de での失敗は、ASINが間違っていることを意味しません。

出品者IDもマーケットプレイスごとに異なります。 www.amazon.com の商品から返されるIDは、別のドメインでは解決できません。

販売中の商品でも価格がない場合があります。 在庫切れ、他の出品者経由でのみ販売、またはプロモーションの利用が条件となっている商品は、使用可能な currentPrice なしで返されます。価格を比較する前に isAvailable を確認してください。

deliveryZip と shippingLocation は、配送欄だけでなく回答全体を変えます。 配送先によって在庫状況、価格、出品者の構成がすべて変わるため、郵便番号をまたいで比較する場合は、ほかのすべてのパラメーターを固定する必要があります。

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

料金、無料枠、制限

Amazon の各ツールは、呼び出しが成功するごとに10クレジットかかります。otherSellers を有効にすると商品呼び出しに5クレジットが加算され、10ではなく15クレジットになります。競合商品の情報が目的でない限り、無効のままにしてください。レスポンスのサイズによって料金は変わりません。

無料枠は、カード登録不要で毎月1,000クレジットです。基本料金で100回の Amazon 呼び出しができます。請求サイクルごとに更新されるため、呼び出し量の少ないエージェントなら、無料枠のまま利用し続けられます。

有料プランは、200,000クレジット、つまり20,000回の呼び出しが可能な月額59ドルのプランから始まります。単価は利用量に応じて下がり、エントリープランでは呼び出し1,000回あたり1.48ドル、Basicでは0.60ドル、Growthの各プランでは0.41ドルです。最新の料金は料金ページをご覧ください。

プランによって同時実行数も決まります。無料枠は一度に1リクエスト、Startupは5、Basicは15、Growthは50～500です。無人で実行するものでは、429が返された場合にバックオフしてリトライしてください。ASINを複数に並列展開するエージェントは、あなたが気づく前に上限に達します。

200以外のステータスコードが返されたリクエストには課金されません。結果が見つからなくても、呼び出しが成功すれば課金されます。

ツールの選び方

ほとんどの場合、2つのルールで選べます。

プロンプトに含まれる情報を起点にしてください。キーワードなら検索ツール、ASINなら商品ツール、出品者IDなら2つある出品者ツールのいずれかを使います。すでにASINがわかっているのに、検索呼び出しを使ってASINを探すのが、最もよくある無駄です。

次に、必要な情報の詳しさで選びます。検索ツールと出品者の商品ツールは、同じ簡易的な商品データを返します。複数商品のランキング付け、絞り込み、価格調査に適しています。ブランド、特徴、バリエーション、画像、出品者を返すのは商品ツールだけです。単一の商品について質問する場合に使う価値があるのは、このツールだけです。

比較

Amazon の Product Advertising API は、こうしたデータを取得するための公式ルートですが、これはそれとは異なるツールです。

選択を左右するのは利用資格です。Product Advertising API はアフィリエイト向けに作られており、アクセスにはすでに売上を上げていることが条件となるため、調査、監視、エージェントに代行させるあらゆる用途には適しません。利用資格を満たし、広告掲載可能な商品だけが必要なら、公式 API のほうが適しています。

よくある質問

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

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

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

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

Amazon アカウントや API キーは必要ですか？

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

対応しているマーケットプレイスはどれですか？

www.amazon.com から欧州やアジアのマーケットプレイスまで、API が受け付ける23のドメインすべてに対応しています。切り替えるには domain を指定してください。マーケットプレイスごとに価格、在庫状況、出品者の構成が異なるため、ドメインをまたいだ比較は単なる通貨換算ではなく、実際の比較になります。

検索結果にブランドや特徴が表示されないのはなぜですか？

Amazon は検索結果ページにそれらを掲載していません。検索ツールはページに表示される情報を返し、商品ツールは商品ページの情報を返します。この違いが、2つのツールの料金が同じで、取得できる情報の詳しさが異なる理由です。

otherOfferQuantity とは何ですか？

商品ページに表示されている、同じ商品を出品している他の販売者の数です。基本の呼び出しで取得できます。出品情報自体の取得には otherSellers が必要で、クレジットが 10 追加でかかります。

これをほかの HasData API と一緒に使えますか？

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

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

いいえ。HasData は独立したサービスであり、Amazon との提携、推奨、後援を受けていません。Amazon はそれぞれの所有者の商標です。ツールは公開されているデータのみを使用します。取得した結果は、Amazon の規約およびお客様に適用される法律に従ってご利用ください。

コンプライアンスと個人データ

販売者のプロフィールには、Amazon がストアフロントページで公開している事業者名と事業所の住所が含まれます。自由記述データではなく事業者情報として取り扱い、保存する前に、ご自身に適用される義務を確認してください。

HasData のリンク

• Amazon Scraper API：これらのツールの基盤となる REST エンドポイント
• API ドキュメント
• MCP サーバーのドキュメント
• 料金
• ダッシュボード

その他の HasData MCP サーバー：Google Search、Google Maps、Google Trends、Google Flights、DuckDuckGo、YouTube、TikTok、Instagram、Zillow、Airbnb、Booking.com、Indeed。

開発

ランチャーはリモートサーバーへの薄い stdio ブリッジなので、ビルドは不要です。

npm install
HASDATA_API_KEY=your_key_here npm test

test/ のテストでは、ここでのコミットなしに変更される可能性のあるツールの契約を検証します。?apis=amazon が想定される数のツールを返すこと、名前が変更されていないこと、すべてのツールで必須パラメーターが宣言され、説明が記載されていること、使用中のキーが実際に受け付けられることを確認します。最後のチェックでは実際にツールを呼び出すため、10 クレジットかかります。これは、適切な理由で失敗する可能性があるカナリアテストの費用です。

この README では説明していないツールも、もう 1 つテストしています。サーバーにはレビュー用ツールも表示されますが、接続先のエンドポイントは廃止され、エラーを返します。これを記載すると、読者を行き止まりに導くことになるため、説明していません。テストではその状態を無視せず固定しており、エンドポイントが復旧したとき、またはサーバーからツールが削除されたときに失敗します。その時点で、この README をどうするか判断する必要があります。

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

コントリビューション

ツールの表、レスポンスのサンプル、または実際の動作と異なる説明があれば、ぜひ Issue を作成してください。そのためのテンプレートがあります。同様の修正や、ランチャーに関する変更のプルリクエストも歓迎します。

ライセンス

MIT。詳細は LICENSE を参照してください。