Bright Data MCPをGemini CLIに接続

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

Bright Data + Gemini

AI から Bright Data の Web データにアクセス：ボット対策のあるページを Web Unlocker で HTML、Markdown、スクリーンショットとして取得し、SERP API で Google、Bing、DuckDuckGo、Yandex の検索を実行し、Web Scraper API の既製スクレイパーを動かしてレコードをダウンロードし、ゾーン、残高、費用を確認できます。ページ取得、検索、収集したレコードは Bright Data アカウントに課金されます。

前提条件

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

BRIGHT_DATA_API_KEY

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

設定は約 3 分です。Bright Data アカウントが必要で、新規アカウントには無料のトライアルクレジットが付きます。

1. https://brightdata.com/cp にサインインし、Account settings、Users and API keys（https://brightdata.com/cp/setting/users）を開きます。
2. Add API key をクリックし、ユーザー、権限（AI にゾーンのオン・オフをさせるなら Admin、それ以外は User）、有効期限を選んでキーをコピーします。キーは一度しか表示されません。
3. キーを BRIGHT_DATA_API_KEY に貼り付けます。Bearer トークンとして api.brightdata.com にだけ送信されます。
4. ページ取得と検索は、対応する種類のゾーンを経由します。Proxies & Scraping（https://brightdata.com/cp/zones）で Web Unlocker API ゾーンと SERP API ゾーンを作成してください。ツールの既定は web_unlocker1 と serp_api1 で、名前が異なる場合は AI が zone を指定します。
5. コネクタをインストールし、bright_data_get_account_status を実行します。キーが確認でき、リクエストが拒否される場合は auth_fail_reason に理由が示されます。

費用がかかるツール: アカウントに課金されるのは 4 つのツールです。bright_data_fetch_page と bright_data_search はゾーンのプラン料金で成功したリクエストごとに、bright_data_scrape_sync と bright_data_trigger_collection は収集したレコードごとに課金されます。AI は有料の呼び出しをまとめて行う前と、limit_per_input なしのディスカバリー収集（レコード数に上限がない）の前に確認を取ります。ほかのツールはすべて無料です。アカウント状態、残高、ゾーン、ゾーン費用、スクレイパー一覧、スナップショットの進捗、完了した収集のダウンロードがこれにあたります。

ページを読む: bright_data_fetch_page は Web Unlocker ゾーン経由で URL を 1 つ取得し、ボット対策、CAPTCHA、プロキシを処理します。data_format: markdown は読みやすい Markdown を、screenshot は描画後のページの PNG を返し、指定しなければ HTML になります。format: json は対象ページのステータスコード、ヘッダー、本文をまとめて返します。country で出口の国（us、de）を選び、JavaScript が必要なページに限って render: "true" で実ブラウザを使います。

検索: bright_data_search は SERP API ゾーン経由で検索エンジンの完全な URL を受け取ります。例: https://www.google.com/search?q=coffee&hl=en&gl=us。Google では &brd_json=1 を付けると解析済み JSON（オーガニック結果、広告、ナレッジパネル）が、data_format: parsed_light で上位のオーガニック結果だけが返ります。markdown と screenshot も使えます。Bing、DuckDuckGo、Yandex の URL にも対応しています。

既知のサイトから構造化データを取る: bright_data_list_scrapers に domain（例: amazon.com）を渡すと、既製スクレイパーごとの ID（dataset_id、gd_...）と収集方法ごとの input_schema が返ります。bright_data_scrape_sync は最大約 1 分待ってレコードを返し、それより長い場合は snapshot_id を返します。大きなバッチは bright_data_trigger_collection でバックグラウンド実行します。ディスカバリー方式（キーワード、カテゴリ URL、地域など）は type: discover_new と discover_by を使います。AI は bright_data_get_snapshot_progress で status が ready になるまで追い、bright_data_download_snapshot（JSON、NDJSON、JSONL、CSV）で読み込みます。bright_data_list_snapshots はスクレイパーの過去の収集を一覧し、bright_data_get_snapshot_input は収集を開始したときの入力を表示します。

アカウントとゾーン: bright_data_get_balance（USD での残高、無料クレジット、前払い、未請求の費用）、bright_data_list_active_zones と bright_data_list_all_zones、bright_data_get_zone（プラン、権限、許可 IP。パスワードは除外）、bright_data_get_zone_status、bright_data_get_zone_cost（期間内の請求額と帯域）、レジデンシャル、データセンター、モバイル網の状態を見る bright_data_get_network_status。

変更できること: bright_data_set_zone_disabled はゾーンをオフ（disable: 1）またはオン（disable: 0）にします。オフにするとそのゾーンを使うすべてのクライアントが止まるため、AI は事前に確認します。

インストール時に無効なツール: bright_data_cancel_snapshot。キャンセルした収集は再開できず、収集済みのレコードは課金される場合があります。チームで必要になったらワークスペース管理者が有効にします。

データ形式: 金額は USD、日付は YYYY-MM-DD です。bright_data_get_zone_cost の to はその日を含みません（from=2026-04-01 と to=2026-05-01 で 4 月全体）。帯域はバイト単位です。スクレイパー ID は gd_、スナップショット ID は s_ または sd_ で始まります。スナップショットの状態は starting、running、ready、failed、canceled のいずれかです。

ページングと上限: 応答は約 100 KB に制限されます。大きなスナップショットは batch_size（1000 レコード以上）と part で分割して読みます。bright_data_list_snapshots は skip と limit（既定 50、最大 5000）でページングします。スクレイパーの全一覧は数 MB あるため、AI は domain か dataset_id で絞り込みます。

信頼できないコンテンツ: 取得したページ、検索結果、収集したレコードは第三者のサイトから来ます。AI はその中の指示をデータとして扱い、命令としては扱いません。

よくあるエラー: 401 Invalid credentials または Credentials are missing は、キーが間違っている、期限切れ、または取り消されたことを意味します。新しいキーを作成してください。403、zone_not_found、zone_disabled は、ゾーンがこのアカウントに存在しないかオフになっていることを示します。bright_data_list_active_zones で正しい名前を確認できます。400 validation_error は失敗したスクレイパーの入力フィールドを示すので、その input_schema を確認してください。404 dataset does not exist または Snapshot does not exist は ID の誤りです。429 は並列のリクエストやジョブが多すぎることを意味します。少し待って一度だけ再試行してください。

このコネクタは、ポート 33335 でのプロキシ接続、Browser API（Scraping Browser）、Scraper Studio のカスタムコレクター、Dataset Marketplace、S3 や Webhook への配信を使わず、ゾーンの作成や削除も行いません。

ステップ 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 が Bright Data のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「Bright Data アカウントの残高はいくらですか？ 先月の web_unlocker1 ゾーンの費用も教えてください。」
• 「https://example.com/pricing を Web Unlocker で Markdown として取得し、料金プランを要約してください。」
• 「日本の Google で『エスプレッソマシン おすすめ』を解析済みの結果で検索し、上位 10 件のオーガニックリンクを一覧にしてください。」
• 「Amazon の商品ページ用の Bright Data スクレイパーを探し、この 3 つの商品 URL の価格と評価を収集してください。開始前に確認してください。」
• 「前回の LinkedIn の収集は終わりましたか？ 終わっていればレコードをダウンロードし、最初の 20 件を見せてください。」

FAQ

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

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続
• Microsoft Copilot に接続