Amazon.in MCP Server

amazon-in-mcp

LLM が Amazon.in で買い物できるようにするMCP サーバーです。
在庫のある最安商品。最もお得な商品。価格履歴。有料 API は不要です。

概要

LLM が amazon.in で呼び出せる 3 つのツールです。

API キーやアカウントは不要です。stdio 経由でローカル実行します。ユーザーエージェントをローテーションし、ボットチェックページでは再試行しながら、HTML を直接スクレイピングします。

クイックスタート

1. インストール（Claude Code）：

git clone https://github.com/justadityaraj/amazon-in-mcp.git
cd amazon-in-mcp && npm install && npm run build
claude mcp add amazon-in -- node "$PWD/dist/index.js"

2. MCP クライアントを再起動します（Claude Code、Cursor、Claude Desktop など）。

3. 次のように依頼します：

「amazon.in で、₹10,000 未満の良質な 1TB 外付け SSD を探してください。最もお得な商品を選んでください。」

LLM は search_amazon_in を呼び出してお得度順に並べ替え、現在の価格と価格履歴を確認できる Keepa リンクを添えて、実際の商品を返します。

表示例

search_amazon_in("wireless mouse", max_results=3) を実際に呼び出すと、次のような結果が返されます。

{
  "query": "wireless mouse",
  "page": 1,
  "total_results": 3,
  "results": [
    {
      "asin": "B0CQRNWJM2",
      "title": "ZEBRONICS Blanc Slim Wireless Mouse...",
      "url": "https://www.amazon.in/dp/B0CQRNWJM2?tag=artech-21",
      "price_inr": 423,
      "mrp_inr": 799,
      "rating": 4.0,
      "review_count": 7801,
      "in_stock": true,
      "delivery": "FREE delivery Tomorrow",
      "price_history_url": "https://keepa.com/#!product/12-B0CQRNWJM2"
    }
  ],
  "cheapest_in_stock": { "asin": "...", "price_inr": 199, "...": "..." },
  "best_value":        { "asin": "...", "rating": 4.3, "...": "..." }
}

get_product は bullets[]、brand、seller、discount_percent、availability を追加します。

MCP クライアントの設定

claude mcp add amazon-in -- node /absolute/path/to/amazon-in-mcp/dist/index.js

{
  "mcpServers": {
    "amazon-in": {
      "command": "node",
      "args": ["/absolute/path/to/amazon-in-mcp/dist/index.js"]
    }
  }
}

設定

すべて任意です。MCP クライアント設定の env ブロックで指定できます。デフォルトでは元の動作が維持されます。

例 — プロキシ経由にし、キャッシュ期間を 30 秒に短縮します。

{
  "mcpServers": {
    "amazon-in": {
      "command": "node",
      "args": ["/path/to/dist/index.js"],
      "env": {
        "AMAZON_IN_PROXY": "http://user:[email protected]:8080",
        "AMAZON_IN_CACHE_TTL_MS": "30000"
      }
    }
  }
}

自動ルーティング（「Amazon MCP を使って」と言う必要はありません）

インストールすると、サーバーがクライアントに対して、これらのツールを自動的に利用するよう指示します。initialize ハンドシェイクで返される MCP サーバーの指示が含まれており、amazon.in での買い物、価格、在庫状況、レビューに関する質問には、モデルがデフォルトで search_amazon_in / get_product を使うよう指示します。amazon.in のリンクや ASIN を貼り付けただけの場合も対象です。ツールの説明にも同じトリガーキーワードが含まれているため、サーバーの指示は読まずにツールの説明だけを読むクライアントにも対応できます。

「3000 未満のメカニカルキーボードを探して」と尋ねたり、商品リンクを貼り付けたりするだけで、クライアントはサーバー名を指定しなくてもこのサーバーにルーティングします。これはホスト（Claude Code、Claude Desktop、Cursor など）が提示するモデルレベルのガイダンスであり、プロトコルによる強制的な保証ではない点にご注意ください。サーバーの指示とツールの説明を無視するクライアントに、ルーティングを強制することはできません。

画像検索

このサーバーは、プロバイダーに依存しない設計を保つため、画像入力を意図的に受け付けません。代わりに、画像を LLM クライアントに貼り付けて商品を説明するよう依頼すると、適切なキーワードを使って search_amazon_in が自動的に呼び出されます。MCP 対応クライアントなら、どれでも同じように動作します。

「コストパフォーマンス」のスコア算出方法

在庫があり、レビューが 10 件以上ある商品を対象にします。

$$ \text{score} = \frac{\text{rating} \times \log_{10}(\text{reviews} + 10)}{\sqrt{\text{price}}} $$

スコアが最も高い商品が選ばれます。cheapest_in_stock は、在庫がある商品のうち price_inr が最も低い商品を返すだけです。バランスよりも単純な安さを重視したい場合に便利です。

堅牢性

頻繁に利用すると、リクエストの約 1〜5% がボットチェックで失敗することがあります。30〜60 秒待ってから再試行するか、別のネットワークから実行するか、AMAZON_IN_PROXY を設定してください。

このプロジェクトの資金源

デフォルトでは、このサーバーが返す amazon.in の URL に、作者の Amazon アソシエイトタグ（artech-21）が含まれます。あなた（または LLM）がリンクをクリックして商品を購入すると、作者に少額の紹介料が入ります。価格は変わりません。 これが、このプロジェクトを無料の MIT ライセンスで公開し、積極的にメンテナンスし続ける唯一の方法です。

AMAZON_IN_AFFILIATE_TAG 環境変数で、いつでも上書きまたは無効化できます。

例 — 独自のタグを使用する場合：

{
  "mcpServers": {
    "amazon-in": {
      "command": "node",
      "args": ["/path/to/dist/index.js"],
      "env": { "AMAZON_IN_AFFILIATE_TAG": "yourtag-21" }
    }
  }
}

ロードマップ

• npm に公開し、npx -y amazon-in-mcp-server でインストールできるようにする
• 実際の価格履歴データを取得するため、Keepa API サポートをオプションで追加する（ユーザーがキーを用意）
• フィルターヘルパー — min_rating、min_reviews、under_price
• キャッシュ済み HTML フィクスチャを使ったスモークテストスイート

開発

npm install
npm run dev      # tsx watch
npm run build    # tsc → dist/
npm start        # node dist/index.js

MCP Inspector を使って対話的にテストします。

npx @modelcontextprotocol/inspector node dist/index.js

プロジェクトの構成：

src/
  index.ts        # MCP server + 3 tool registrations
  scraper.ts      # fetch with UA rotation, retry, bot-check, proxy, cache
  parse.ts        # cheerio selectors for search + product pages
  cache.ts        # in-memory TTL + LRU cache
  constants.ts    # UAs, headers, tuning constants, affiliate/proxy/cache config
  types.ts        # SearchResultItem, ProductDetail

免責事項

個人の調査およびアシスタントでの利用を目的として、公開されている amazon.in のページを取得します。認証、ペイウォール、CAPTCHA を回避することはありません。Amazon がボットチェックを表示した場合、ツールは処理を停止してエラーを報告します。

本ツールは、Amazon の利用規約および地域の法律に従って使用する責任があります。稼働時間、正確性、特定の目的への適合性について保証はありません。DOM セレクターは最善を尽くして設定していますが、Amazon がレイアウトを更新すると動作しなくなる場合があります。プルリクエストを歓迎します。

ライセンス

MIT © Aditya Raj Singh

問題の報告、バグ報告、セレクターの修正を歓迎します。Amazon の DOM は数か月ごとに変化するため、このツールは時折動作しなくなり、最新の状態を保つにはコミュニティの協力が必要になります。