idealo MCP Server

idealo MCP サーバーガイド

idealo MCP サーバーを使うと、idealo の商品に関する情報を AI アシスタントで直接活用できます。商品を検索し、数百のショップの価格を比較し、エディターを離れることなく、ヨーロッパの 6 つのマーケットプレイス（DE、AT、GB、FR、IT、ES）における 30 日間の価格履歴を分析できます。

メモ

すべての idealo MCP サーバーツールにはレート制限が適用されます。

デフォルトの Trial ティアは、OAuth によるセルフサービスで利用でき、ユーザーごとに 3 req/s · 6 burst · 500 calls/day が適用されます。Trial のレスポンスには商品画像が 1 枚だけ含まれ、get_product_offers は商品ごとに 10 件のオファーまでに制限されます。また、ショップのロゴ、外部リンク、詳細なユーザーレビューは含まれません。

Partner tier では、より高いレート制限、すべての画像を含む配列、ショップのロゴ、テストレポートへのリンク、ユーザーレビューの全データを利用できます。Partner アクセスを申請するには、[email protected] からお問い合わせください。

ツールの詳細なリファレンス（入力スキーマ、レスポンスの例、ティアごとのフィールドの違い）については、docs/tools.md を参照してください。

機能

• カタログ検索 — カテゴリ、ブランド、価格帯、在庫状況、お買い得商品で絞り込める全文検索を、ヨーロッパの 6 つのマーケットプレイスで利用できます。他のツールに渡す暗号化された productRef が返されます。

• 商品詳細 — トップオファー、レビューの概要、専門家によるレビュー、テストレポート、技術仕様、長所と短所、30 日間の価格推移を含む、完全な商品プロフィールを 1 回の呼び出しで取得できます。

• ページ分割されたオファー — 商品のすべてのオファーを、ショップ名、評価、価格の内訳、配送予定、支払い方法、返品無料ポリシー、送料とともに確認できます。1 ページあたり 5 件のオファーが表示されます。

• 価格履歴と分析 — 30 日間の価格推移に加え、最小値・最大値・平均値の統計、変動率、サンプリングの粒度、ASCII チャート、AI が生成する購入のおすすめを確認できます。

インストールとセットアップ

MCP クライアントによってセットアップ方法が多少異なります。お使いのクライアントに該当する手順に従ってください。

Claude Desktop

Custom Connectors を利用する方法をおすすめします。

1. Claude を開き、Settings → Connectors に移動します。
2. Add custom connector をクリックします。
3. URL https://mcp.idealo.com/mcp を入力して、Add をクリックします。
4. プロンプトが表示されたら認証します。Claude が OAuth のハンドシェイク用にブラウザーを開きます。

{
  "mcpServers": {
    "idealo": {
      "type": "url",
      "url": "https://mcp.idealo.com/mcp"
    }
  }
}

Claude Code

ターミナルで以下のコマンドを実行します。

claude mcp add --transport http idealo https://mcp.idealo.com/mcp --callback-port 6274

{
  "mcpServers": {
    "idealo": {
      "type": "url",
      "url": "https://mcp.idealo.com/mcp",
      "oauth": {
        "callbackPort": 6274
      }
    }
  }
}

VS Code

1. ショートカット ⌘ Shift P を使って、MCP: Add Server を検索します。
2. HTTP を選択します。
3. https://mcp.idealo.com/mcp を貼り付けて、Enter を押します。
4. サーバー ID の入力を求められたら、idealo と入力します。
5. global または workspace のスコープを選択します。

作成される mcp.json は次のようになります。

{
  "servers": {
    "idealo": {
      "type": "http",
      "url": "https://mcp.idealo.com/mcp"
    }
  }
}

チャットツールバーを開き、Agent モードに切り替えて、#search_products と入力し、ツールが利用可能であることを確認します。何も表示されない場合は、VS Code を再起動してください。

メモ

VS Code で MCP を利用するには、GitHub Copilot を有効にする必要があります。

Cursor

{
  "mcpServers": {
    "idealo": {
      "url": "https://mcp.idealo.com/mcp"
    }
  }
}

その他のエディター

Streamable HTTP トランスポートに対応したクライアントであれば接続できます。以下を使用してください。

{
  "mcpServers": {
    "idealo": {
      "url": "https://mcp.idealo.com/mcp"
    }
  }
}

認証

サーバーは、Dynamic Client Registration（DCR）+ PKCEを使用した OAuth 2.0 を採用しています。仕様に準拠した MCP クライアントは、.well-known/oauth-protected-resource を通じて認証フローを自動的に検出するため、Trial ティアでは client_id / client_secret の設定は不要です。初回接続時に、クライアントがブラウザーを開いてログインします。トークンはクライアント側にキャッシュされ、自動的に更新されます。

Partner ティアの認証情報は、リクエストに応じて idealo から別途発行されます。

MCP クライアントへのプロンプト

接続したら、自然な言葉でクライアントに指示してください。4 つのツールは、search_products が返す不透明な productRef を使って連携します。

例：

• 「ドイツで購入できる、100 ユーロ未満のランニングシューズを探してください。」
• 「最も安い検索結果について、詳細、上位のオファー、メリットとデメリットを表示してください。」
• 「PayPal が利用でき、送料無料の商品が見つかるまで、すべてのオファーを確認してください。」
• 「過去 30 日間の価格履歴を表示し、今が買い時かどうか教えてください。」

ヒントとベストプラクティス

• productRef を使用してください。 search_products は各検索結果に対して暗号化された productRef を返します。その文字列を get_product_details、get_product_offers、get_product_price_history にそのまま渡してください。不透明で、マーケットプレイスに対応し、有効期間が短い値です。
• includeSearchFilters と includeSizeFilters には includeCategories が必要です。 数値のカテゴリ ID を 1 つ以上指定せずに属性フィルターまたはサイズフィルターを送信すると、サーバーは呼び出しを拒否します。まずフィルターなしで検索し、レスポンスに含まれる利用可能な categoryId を確認してください。
• 適切な国を選択してください。 country には 2 文字の ISO コード（DE、AT、GB、FR、IT、ES）を指定します。不明なコードを指定すると、通知なくドイツにフォールバックします。
• オファーを適切にページネーションしてください。 get_product_offers は 1 回の呼び出しで 5 件のオファーと nextOffset を返します。nextOffset === 0 になるまで繰り返してください。
• 一部のショップは除外されます。 コンプライアンス上のブロックリストにより、すべてのティアで Amazon、eBay、Otto のオファーが除外されます。これは意図的なもので、ティアに関係なく適用されます。
• 同じマーケットプレイスを一貫して指定してください。 country=DE の productRef を country=GB で再利用しても、有用なデータは返されません。

対応市場

🇩🇪 ドイツ · 🇬🇧 イギリス · 🇫🇷 フランス · 🇮🇹 イタリア · 🇪🇸 スペイン · 🇦🇹 オーストリア

サポート

• ウェブサイト：idealo.de
• ツールリファレンス：docs/tools.md
• Partner ティアのお問い合わせ：[email protected]
• 新しい MCP クライアントのサポート依頼：[email protected]