MCP 経由で eBay Browse (product search) を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → eBay Browse (product search) をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

eBay Browse (product search) + Gemini

eBay の Browse API で、出品中の eBay 商品を検索し、商品の詳細を読み取ります。価格、状態、出品者、配送、商品の仕様を、キーワード、カテゴリ、GTIN、商品 ID で調べられます。アプリケーショントークンで公開マーケットプレイスのデータを読むため、セラーアカウントは不要です。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

EBAY_CLIENT_ID, EBAY_CLIENT_SECRET, EBAY_MARKETPLACE_ID

ステップ 1 — 認証情報を取得

セットアップは約 5 分です。production の keyset を持つ無料の eBay 開発者アカウントが必要です。eBay のセラーアカウントやユーザーのサインインは不要です。

1. developer.ebay.com にサインインし、Application Keys を開いて production の keyset を作成します (sandbox ではありません)。
2. App ID (Client ID) を EBAY_CLIENT_ID に、同じ keyset の Cert ID (Client Secret) を EBAY_CLIENT_SECRET にコピーします。
3. EBAY_MARKETPLACE_ID に検索したい eBay サイトを設定します。たとえば EBAY_US、EBAY_GB、EBAY_DE です。AnythingMCP が eBay の client credentials フローでアプリケーショントークンを取得し、2 時間ごとに自動で更新します。
4. コネクタをインストールし、キーワード book、件数 1 で ebay_browse_search_items を実行します。設定したマーケットプレイスの出品が 1 件返ってきます。

購入側のみ: このコネクタは、購入者から見える公開出品を検索して読み取ります。販売 (ご自身の注文、在庫、出品オファー) は別のコネクタ eBay Sell が担当し、セラーのユーザートークンが必要です。両方を並べてインストールできます。

読み取れるデータ: 設定したマーケットプレイスの出品中の商品です。キーワード、カテゴリ、GTIN (EAN、UPC、ISBN)、eBay の商品 ID (ePID) で探し、タイトル、価格、状態、出品者名と評価、配送オプション、購入方法 (即決価格、オークション、ベストオファー)、商品の所在地、出品ページの URL を返します。1 件の出品については、説明文全体、状態の説明、商品の仕様、ブランド、MPN と GTIN、画像、配送と返品の条件、在庫数、お届け予定日を読み取ります。

商品番号とバリエーション: 出品 URL の番号 (ebay.com/itm/123456789012) を貼り付けると、AI が ebay_browse_get_item_by_legacy_id で開きます。サイズや色を選べる出品はアイテムグループで、ebay_browse_get_item_group が各バリエーションを個別の価格と在庫状況つきで返します。

検索と絞り込み: 検索にはキーワード、カテゴリ、GTIN、ePID のうち少なくとも 1 つが必要です。AI は price:[10..50],priceCurrency:USD、conditions:{NEW}、buyingOptions:{FIXED_PRICE}、itemLocationCountry:US などのフィルターで絞り込み、価格順、新着順、終了間近の順で並べます (指定がなければベストマッチ)。色などの商品の仕様で絞り込む場合は、カテゴリも必要です。

価格は常に変わります: 価格は通貨つきの文字列で、出品者が別の通貨で出品していない限り、マーケットプレイスの通貨です。価格と在庫は絶えず変わるため、AI は必ず取得した時刻を添えて伝えます。

読み取り専用: 書き込みツールはありません。このコネクタは購入、入札、価格交渉など eBay 上の変更を一切行わないため、確認が必要な操作はありません。

制限: アプリケーションの keyset は、最初は Browse の呼び出しが 1 日 5,000 回までです。1 ページは最大 200 件で、ページ送りは 10,000 件 (offset と limit の合計) までです。そのため範囲の広い検索では、AI はすべてをページ送りせずフィルターで絞り込みます。

よくあるエラー: eBay が App ID や Cert ID を拒否する場合は、sandbox のキーを貼り付けている可能性が高いです。production の keyset のキーを使ってください。キーワード、カテゴリ、GTIN、ePID のどれもない検索は拒否されます。EBAY_MARKETPLACE_ID は EBAY_US のように EBAY_ で始まる形式にしてください。

このコネクタは購入や入札を行わず、eBay アカウントにサインインせず、終了済みや落札済みの出品は検索せず、ご自身の出品、注文、在庫の管理も行いません (それは eBay Sell コネクタの役割です)。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が eBay Browse (product search) のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「eBay で LEGO Technic 42115 を 300 ドル以下、即決のみ、米国内発送で探して、価格の安い順に並べてください。」
• 「eBay の出品 123456789012 には、商品の状態、送料、返品について何と書かれていますか？」
• 「eBay で EAN 4006381333931 を検索して、新品の最安値の出品を送料込みで見せてください。」
• 「eBay の出品 123456789012 で、まだ在庫があるサイズと色はどれですか？それぞれの価格も教えてください。」
• 「中古の iPhone 15 128GB は今 eBay でいくらで出品されていますか？最安値、相場、最高値を教えてください。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続