Bright Data

公式

発見、抽出、そしてウェブとの対話を実現する—パブリックインターネット全体での自動アクセスを支える単一のインターフェース。

Bright Data MCPで何ができますか?

  • ウェブ検索 — アシスタントに Bing または Google で検索を実行させ、リンク、タイトル、説明を含む構造化された結果を取得できます。
  • ページスクレイピング — 任意の URL を、ボット検出と CAPTCHA 対応を組み込んだうえで、整形済みの Markdown、テキスト、HTML、または ld_json として取得できます。
  • プラットフォームの構造化データ — Amazon、LinkedIn、TikTok、npm などのサイト向けに事前構築されたスクレイパーを見つけて実行し、HTML を解析する代わりに整形済みの JSON を取得できます。
  • ブラウザー自動化 — リモートブラウザーセッションでページを移動、クリック、入力、スクロール、スクリーンショット撮影できるため、操作が必要なサイトやログインが必要なサイトにも対応できます。
  • LLM の回答収集 — ChatGPT または Perplexity にプロンプトを送信して回答を取得し、それぞれがブランドをどのように説明するかを比較できます。
  • 一括収集 — 1 回の呼び出しで最大 5 件の検索、または最大 5 件の URL のスクレイピングを実行し、並行してデータを収集できます。

ドキュメント

Bright Data Logo

Bright Data MCP

Model Context Protocol を介して、AI エージェントや LLM にウェブ検索、ページのスクレイピング、構造化データの抽出、ブラウザーの自動操作を提供します。

AI エージェント、コーディングエージェント、チャットアシスタント、その他あらゆる MCP 対応クライアントで利用できます。

npm version npm downloads License

クイックスタート • 料金 • ユースケース • ツール • エージェントスキル • ドキュメント • サポート

無料枠:月5,000リクエスト。 クレジットカードは不要です。毎月更新されます。


概要

Bright Data MCP サーバーは、AI エージェントに公開ウェブデータへのリアルタイムアクセスを提供します。以下を網羅する30個のツールを利用できます。

  • ウェブ検索 — Bing と Google の検索結果を構造化データとして取得
  • ページのスクレイピング — あらゆる URL を Markdown または HTML として取得。ボット検出、CAPTCHA の解決、プロキシのローテーションは、すべてのリクエストで自動的に処理されます
  • 構造化データ(Web Scraper API) — Amazon、LinkedIn、Instagram、TikTok、YouTube、X、Reddit、Facebook、Crunchbase、Zillow、npm、PyPI など、1,200以上の事前構築済みスクレイパーからクリーンな JSON を取得。HTML の解析は不要です。6つのツールでスクレイパーを検索して実行できます
  • ブラウザーの自動操作 — リモートブラウザーセッションでページの移動、クリック、入力、スクリーンショットの撮影、ページの読み取りが可能
  • LLM 応答の収集 — ChatGPT と Perplexity にプロンプトを送信し、回答を構造化データとして取得

すべてのリクエストは Bright Data のブロック解除インフラストラクチャを経由するため、通常の HTTP クライアントをブロックするページ(ボット検出、CAPTCHA、レート制限、地域制限)も通常どおり取得できます。プロキシの設定も、ヘッドレスブラウザーの保守も、リトライ処理の実装も不要です。

導入方法は2つあります。ホスト型リモートサーバー(URLを1つ指定するだけで、インストール不要)または npx @brightdata/mcp を使ったローカルインスタンスです。


クイックスタート

ホスト型サーバー — インストール不要。 この URL を MCP クライアントに追加します。

https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE

API トークンは Bright Data アカウント設定 から取得できます。新規アカウントには月5,000件の無料リクエストが付与されます。

任意の URL パラメーター:

パラメーター説明例
groups=<ids>使用するツールグループを指定(デフォルト:すべてのツール)...&groups=scrapers,browser
tools=<names>使用するツールを指定...&tools=search_engine,scrape_as_markdown
Claude Desktop
  1. 次の場所を開きます:Settings → Connectors → Add custom connector
  2. 名前:Bright Data
  3. URL:https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
  4. 「Add」をクリックします

または、ローカルで実行します。

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>"
      }
    }
  }
}
Claude Code
claude mcp add --transport http brightdata "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
Cursor

~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "brightdata": {
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
VS Code

.vscode/mcp.json に追加します。

{
  "servers": {
    "brightdata": {
      "type": "http",
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Windsurf

~/.codeium/windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "brightdata": {
      "serverUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Gemini CLI

~/.gemini/settings.json に追加します。

{
  "mcpServers": {
    "brightdata": {
      "httpUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Zed

Zed の設定に追加します。

{
  "context_servers": {
    "brightdata": {
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Warp

Settings > MCP Servers > Add MCP Server を開き、次を追加します。

{
  "brightdata": {
    "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
  }
}
その他のクライアント(ローカル npx)

ローカル MCP サーバーに対応する任意のクライアントで利用できます。

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>"
      }
    }
  }
}

料金と無料枠

すべてのアカウントに、毎月更新される無料枠が含まれます。利用開始にクレジットカードや契約は不要です。

月5,000件の無料リクエストが毎月1日に更新されます。未使用分は翌月に繰り越されません。チームアカウントでは、無料枠はアカウント内の全ユーザーで共有されます。

無料で利用できる内容:

  • あらゆるウェブページを取得し、Markdown として抽出
  • 人気ドメイン向けの60以上の事前構築済みスクレイパーを利用
  • ウェブ検索(Bing、Google)
  • ウェブのブロック解除(ボット検出の回避、CAPTCHA の解決、プロキシのローテーション)
  • ブラウザーの自動操作
  • 地域ターゲティング

無料枠を超えた分は従量課金で、契約は不要です。

検索、スクレイピング、抽出ブラウザーのナビゲーション
従量課金1,000件あたり $1.501 GBあたり $8
  • 無料リクエストを使い切ると、リクエストは停止します。資金を入金していない限り、予期しない請求は発生しません
  • クレジットカードの追加は本人確認のためだけに行われます。無料枠を使い切り、かつ資金を入金している場合を除き、請求は発生しません
  • コントロールパネル で利用上限を設定すれば、従量課金の利用額が予算を超えることはありません

料金、ボリュームプラン、エンタープライズ向けプランの詳細 →


ユースケース

リアルタイム調査

学習データではなく、最新のウェブデータを使って質問に回答します。検索してから、情報源を読み込みます。

タスクツール
最新情報をウェブで検索search_engine, search_engine_batch
特定のページを読みやすい Markdown として取得scrape_as_markdown, scrape_batch

プロンプト例:「Tesla の現在の株価は?」「今日のニューヨークの天気予報を教えて」「過去6か月間の EU AI 規制に関する、最も多く引用された情報源を探して」。

Eコマースの分析

価格、在庫状況、評価、レビュー数、販売者、画像などの商品データを構造化 JSON として取得します。

タスクツール
Amazon、Walmart、eBay、Best Buy、Etsy、Home Depot、Zara などの店舗から商品、レビュー、検索結果を取得search_scrapers → get_scraper_details → run_scraper
複数小売店の価格を比較Google Shopping スクレイパーを使った同じ手順

プロンプト例:「このノートパソコンの価格を Amazon、Walmart、Best Buy で比較して」「ASIN B0D2Q9397Y の評価とレビュー数を教えて」「この商品は在庫がありますか?」

市場と競合の分析

資金調達、従業員数、採用状況、顧客レビュー、料金ページなどの最新データから、競合のプロフィールを作成します。

タスクツール
企業の資金調達、規模、従業員、求人情報(Crunchbase、ZoomInfo、LinkedIn)search_scrapers → run_scraper
顧客の評価(Google Maps、Facebook、アプリストアのレビュー)search_scrapers → run_scraper
競合の料金ページscrape_as_markdown, scrape_batch
市場の発見search_engine_batch

プロンプト例:「競合としての Notion を分析して。料金、資金調達、採用の重点分野、顧客からの不満を調べて」。

信頼性の高いウェブアクセスを備えた AI エージェント

保護されたサイトでブロックされる組み込みの取得・検索ツールを置き換えます。すべてのリクエストがブロック解除インフラストラクチャを経由するため、ボット検出、CAPTCHA、地域制限によってエージェントが失敗することはありません。

タスクツール
組み込みウェブ検索の代替としてそのまま利用search_engine
組み込み URL 取得の代替としてそのまま利用scrape_as_markdown
並列データ収集(一度に5件)search_engine_batch, scrape_batch
インタラクティブなサイト(ログイン画面、無限スクロール、動的コンテンツ)scraping_browser_*(14個のツール)

コーディングエージェント

パッケージレジストリのデータを必要に応じて取得できます。スクレイピングも、古いキャッシュも不要です。

タスクツール
npm と PyPI のパッケージバージョン、README、メタデータnpmjs または pypi スクレイパーを指定して run_scraper を使用(search_scrapers で検索)
GitHub リポジトリからファイルを読み込むGitHub リポジトリスクレイパーを指定して run_scraper を使用

プロンプト例:「npm の express の最新バージョンは?」「langchain-brightdata PyPI パッケージの README を取得して」。

GEO とブランドの可視性

主要な LLM にプロンプトを送信し、回答を構造化データとして取得します。AI アシスタントが自社ブランドをどう説明し、どの情報源を引用し、何を推奨するかを測定できます。これは生成エンジン最適化のためのフィードバックループです。

タスクツール
引用と推奨を含む ChatGPT の回答chatgpt_ai_insights
情報源を含む Perplexity の回答perplexity_ai_insights

プロンプト例:「ChatGPT と Perplexity に『最適なプロキシプロバイダーは?』と質問し、それぞれが当社をどう評価するか比較して」。

ソーシャルメディアのモニタリング

主要なすべてのプラットフォームから、プロフィール、投稿、コメント、エンゲージメント指標などの構造化データを取得します。各プラットフォームにはデータの種類ごとにスクレイパーがあります(LinkedIn のプロフィール、Instagram のリール、TikTok のコメントなど)。search_scrapers で検索し、run_scraper で実行できます。

プラットフォームスクレイパーの例
LinkedIn個人プロフィール、企業プロフィール、求人情報、投稿、人物検索
Instagramプロフィール、投稿、リール、コメント
TikTokプロフィール、投稿、ショップ、コメント
Facebookプロフィール、投稿、マーケットプレイスの出品、企業レビュー、イベント
YouTube動画、チャンネル、コメント
X (Twitter)投稿、プロフィール別の投稿
Reddit投稿、コメント

プロンプト例:「この TikTok プロフィールの最新10件の投稿を取得して、エンゲージメントを要約して」。

コンテンツ作成と学術調査

複数のページから、公開時期と関連性で絞り込んだ情報源を一度に収集します。

タスクツール
1回の呼び出しで複数の情報源を収集scrape_batch(最大5つの URL)
ニュースと金融データニュース検索には search_engine、Yahoo Finance スクレイパーには run_scraper

比較

機能Bright Data MCP一般的なウェブ MCP サーバー
ツールの合計数302~10
プラットフォーム固有の構造化 JSON 抽出ツールEコマース、ソーシャル、ビジネス、金融、旅行、アプリストアを網羅する1,200以上の事前構築済みスクレイパーを6つのツールで利用まれ。汎用スクレイピングのみ
ブロック解除(ボット検出の回避、CAPTCHA の解決、プロキシのローテーション)すべてのリクエストに組み込み済み通常はなし。保護されたサイトではブロックされる
検索エンジンBing、Google通常は1つ
ブラウザーの自動操作14個のツール、リモートブラウザー、ローカル設定不要限定的、またはなし
LLM 応答の収集(ChatGPT、Perplexity)対応提供なし
パッケージレジストリのデータ(npm、PyPI)対応提供なし
バッチ処理1回の呼び出しで検索10件またはスクレイピング10件通常は1リクエストのみ
地域ターゲティング対応限定的、またはなし
無料枠月5,000件、ブラウザーの自動操作を含む、クレジットカード不要サービスによって異なる。キー不要のアクセスはレート制限されることが多い

ツールの選択:グループ

必要なツールだけを読み込めるよう、ツールはグループに整理されています。ツールが少ないほど、エージェントが処理するコンテキストも少なくなります。

  • GROUPS も TOOLS も指定しない場合、30個すべてのツールが有効になります。どちらかを設定すると、指定したツールだけがサーバーで有効になります
  • GROUPS でツールのバンドルを有効にできます。カンマ区切りで指定します:GROUPS="scrapers,browser"(ローカル)または &groups=scrapers,browser(ホスト型 URL)
  • TOOLS で個別のツールを追加できます:TOOLS="scrape_batch,session_stats"。これだけを指定した場合、一覧にあるツールのみが有効になります
  • どのグループにも search_engine、scrape_as_markdown、ask_brightdata_assistant が含まれます
  • グループ ID custom は予約済みです。個別のツールを選ぶ場合は TOOLS を使用してください
グループ ID内容ツール数
scrapersあらかじめ構築された Web Scraper API スクレイパー(Amazon、LinkedIn、TikTok、npm など)を検索して実行6
browserリモートブラウザーの自動化14
geoChatGPT と Perplexity の回答収集2
advanced_scrapingバッチツール、セッション統計3

以前のグループ ID(ecommerce、social、business、finance、research、app_stores、travel、code)も引き続き使用でき、scrapers ツールが有効になります。social と business では、さらに search_dataset と list_dataset_fields も追加されます。以前の web_data_* 名を TOOLS で指定すると、scrapers ツールも有効になります。

設定例

ブラウザー自動化とバッチツールを備えたローカルサーバー:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>",
        "GROUPS": "browser,advanced_scraping"
      }
    }
  }
}

コーディングエージェントのセットアップ(Claude Code / Cursor / Windsurf)— あらかじめ構築されたスクレイパーを通じた npm、PyPI、GitHub のデータ:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>",
        "GROUPS": "scrapers"
      }
    }
  }
}

ツールリファレンス(30 ツール)

使用するツールの選び方

  • URL がわかっていて、コンテンツが必要: scrape_as_markdown。複数の URL(最大 5 件):scrape_batch
  • 情報を探したい: search_engine。複数のクエリ(最大 5 件):search_engine_batch
  • 既知のプラットフォーム(Amazon、LinkedIn、TikTok、npm、PyPI など)の構造化データ: search_scrapers → get_scraper_details → run_scraper — クリーンな JSON を返します。同じページをスクレイピングするより高速で信頼性があります
  • 生の HTML: format: 'html' と scrape_as_markdown
  • ページでの操作(クリック、入力、スクロール、ログイン)が必要: scraping_browser_* ツール
  • プロンプトに対する ChatGPT / Perplexity の回答: chatgpt_ai_insights / perplexity_ai_insights
  • Bright Data 自体(製品、ゾーン、エラー、セットアップ)についての質問: ask_brightdata_assistant

スクレイパーの実行に関する注意事項:

  • 構造化 JSON を返します。課金は返されたレコードごとです
  • error フィールドを含むレコードには、入力が失敗した理由(例:URL の種類が正しくない)が記載されています
  • 結果が大きくなる場合があります。discover_by_* メソッドでは limit_per_input を低く設定し、フレームワークが対応している場合は一括収集をサブエージェントで実行してください。レコードがメインのコンテキストウィンドウにあふれるのを防げます
  • 実行に失敗した場合、同じ URL でフォールバックとして scrape_as_markdown を使用できます
検索とスクレイピング — 5 ツール
ツール説明グループ
search_engineBing(デフォルト)または Google を検索します。JSON(リンク、タイトル、説明)を返し、1 ページあたり 10 件の結果を取得します。パラメーター:country、page(0 から)、time_range(hour、day、week、month、year、any。Bing が対応するのは day、week、year のみ)デフォルト / すべてのグループ
search_engine_batch1 回の呼び出しで最大 5 件の検索クエリを実行デフォルト / advanced_scraping
scrape_as_markdown任意の URL。コンテンツを Markdown(デフォルト)、テキスト、HTML、または ld_json で返しますデフォルト / すべてのグループ
scrape_batch1 回の呼び出しで最大 5 件の URL を処理します。コンテンツを Markdown(デフォルト)、テキスト、HTML、または ld_json で返しますデフォルト / advanced_scraping
session_stats現在のセッションでのツール使用回数デフォルト / advanced_scraping
Web Scraper API — 6 ツール

Bright Data の 1,200 種類以上のあらかじめ構築されたスクレイパーを検索して実行します。スクレイパーの一覧は docs.brightdata.com/scrapers.json から読み込まれ、毎日更新されます。ホスト型サーバーとローカルサーバーの両方で利用できます。ツールまたはグループが選択されていない場合はデフォルトで有効です。それ以外の場合は scrapers グループを追加してください(ホスト型 URL では &groups=scrapers、ローカルでは GROUPS=scrapers)。

一般的な流れ:search_scrapers → get_scraper_details → run_scraper。課金はレコードごとです。discover_by_* メソッドでは、入力ごとに最大 limit_per_input 件のレコードを収集します(デフォルトは 10 件)。

ツール説明グループ
search_scrapersサイトまたはデータの種類(例:「amazon reviews」、「linkedin.com」)でスクレイパーを検索します。データセット ID、名前、ドメイン、収集方法を返しますデフォルト / scrapers
get_scraper_details1 つのスクレイパーメソッドについて、説明、入力フィールド、入力例、主な出力フィールドを表示しますデフォルト / scrapers
run_scraperスクレイパーメソッドを実行します。最大 45 秒待機し、まだ実行中の場合は後で確認するための snapshot_id を返しますデフォルト / scrapers
get_scraper_progress実行の状態:starting、running、ready、failed、canceledデフォルト / scrapers
get_scraper_results完了した実行のレコードデフォルト / scrapers
refresh_scrapers毎日の更新を待たずに、スクレイパーの一覧を今すぐ再読み込みしますデフォルト / scrapers
ブラウザー自動化 — 14 ツール

リモートブラウザーセッション。一般的な手順:移動 → スナップショット → ref で操作 → 抽出またはスクリーンショット。

ツール説明
scraping_browser_navigateブラウザーセッションを開始または再利用し、URL に移動します
scraping_browser_go_back前のページに戻ります
scraping_browser_go_forward次のページに進みます
scraping_browser_snapshot操作可能な要素を ref 付きで一覧表示する、ページの ARIA スナップショット。ref による操作の前に必要です
scraping_browser_click_ref最新のスナップショットにある ref で要素をクリックします
scraping_browser_type_refref で要素に入力します。必要に応じて Enter キーを押して送信できます
scraping_browser_fill_form1 回の呼び出しで、ref を使って複数のフォームフィールドに入力します
scraping_browser_screenshot現在のページのスクリーンショット。任意の full_page
scraping_browser_get_textページ本文のテキストコンテンツ
scraping_browser_get_html現在のページの HTML
scraping_browser_scrollページの一番下までスクロールします
scraping_browser_scroll_to_ref要素が表示される位置までスクロールします
scraping_browser_wait_for_ref要素が表示されるまで待機します。タイムアウトは任意で指定できます
scraping_browser_network_requestsページ読み込み後のネットワークリクエスト:メソッド、URL、ステータス

ref は最新のスナップショットから取得します。クリックやページ移動の後にページが変化した場合は、次の ref による操作の前に新しいスナップショットを取得してください。静的なページでは、scrape_as_markdown のほうがブラウザーセッションより高速で低コストです。

GEO と LLM の可視性 — 2 ツール
ツール入力戻り値
chatgpt_ai_insightsプロンプトChatGPT の回答(Markdown)
perplexity_ai_insightsプロンプトPerplexity の回答(Markdown)

Generative Engine Optimization(LLM が自社ブランドをどのように説明するかの追跡)や、LLM-as-a-judge のワークフローに使用します。

データセット検索 — 2 ツール

保存済みの LinkedIn データセットを条件で絞り込んで検索します。スクレイパーを実行せずに、一致するレコードをまとめて返します。

ツール説明グループ
list_dataset_fieldsデータセットの絞り込み可能なフィールド(名前、種類、説明)。search_dataset の前に呼び出してくださいデフォルト / social、business
search_dataset条件に一致するレコードを、1 回の呼び出しで最大 10 件返します。続きの取得にはカーソルを使用しますデフォルト / social、business
Bright Data アシスタント — 1 ツール
ツール説明グループ
ask_brightdata_assistantBright Data のサポートアシスタント Sophie に、製品、API、ゾーン、エラー、アカウント設定について質問します。同じスレッドで追加質問するには、返された dialog_id を渡しますデフォルト / すべてのグループ

ドキュメントの完全なツールリファレンス →


エージェントスキル

エージェントがこの MCP サーバーを正しく使う方法を学べる、すぐに使えるスキルです。スキルの全コレクションは github.com/brightdata/skills にあります。MCP オーケストレーション、競合情報、価格比較、ブランドの評判調査、SEO 監査、スクレイパー構築、RAG パイプラインなどを扱う 21 個のスキルが含まれています。

特に効果の高いスキルを 3 つ紹介します。

スキル機能
bright-data-mcpBright Data MCP をすべての Web データ操作のデフォルトにし、ボット検出で失敗する WebFetch、WebSearch などの組み込み Web ツールを置き換えます
competitive-intelライブ Web データから、競合のスナップショット、価格比較、レビュー分析、採用動向、コンテンツ / SEO 分析、市場全体のマップを作成します
price-comparisonAmazon、Walmart、eBay、Best Buy、Google Shopping で商品を照合し、在庫のある最安値の商品を提示します

21 個すべてのスキルを見る →


設定

基本設定(ローカル)

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "your-token-here"
      }
    }
  }
}

詳細設定

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "your-token-here",
        "RATE_LIMIT": "100/1h",
        "SERP_ZONE": "custom_serp",
        "BROWSER_ZONE": "custom_browser"
      }
    }
  }
}

環境変数

変数説明デフォルト例
API_TOKENBright Data API トークン(必須)-your-token-here
RATE_LIMITカスタムレート制限無制限100/1h、50/30m
SERP_ZONE検索ツールで使用するカスタム SERP API ゾーン名mcp_serpmy_serp_zone
BROWSER_ZONEカスタム Browser ゾーン名mcp_browsermy_browser_zone
CONTENT_GATEデータツールが返すページコンテンツに MCP 設定の変更を促す指示のような内容が含まれている場合、サーバーは返す前に MCP elicitation を通じてユーザーに確認します。無効にするには off に設定しますonoff
CONTENT_GATE_TIMEOUTコンテンツを保留するまでにユーザーの回答を待つ秒数12060、300
BROWSER_FILTERED_SNAPSHOTscraping_browser_snapshot にはボタン、リンク、入力欄のみが常に表示されます。トークンを節約し、ページ上のテキストがクリック可能な要素を装うのを防ぎます(機密性の高いタスク向け)。必要に応じて、scraping_browser_get_text でページのテキストを読み取れますoffon
BASE_TIMEOUT基本ツール(検索とスクレイピング)のリクエストタイムアウト(秒)制限なし60、120
BASE_MAX_RETRIES一時的なエラーが発生した場合に基本ツールが再試行する最大回数(0~3)01、3
GROUPSカンマ区切りのツールグループ ID。サーバーで使用できるグループを制限しますすべてのツールscrapers,browser
TOOLSカンマ区切りの個別ツール名。サーバーで使用できるツールを制限しますすべてのツールscrape_batch,session_stats

コンテンツゲート

scrape_as_markdown、search_engine およびそれらのバッチ版は、Web ページに記載されている内容をそのまま返します。そのコンテンツに、MCP 設定の変更を促す指示(サーバーの登録、npx -y パッケージの実行、MCP 設定ファイルの編集など)に見えるテキストが含まれている場合、サーバーは処理を一時停止し、MCP クライアントを通じて確認を求めます。承認するとコンテンツは変更されずに返され、拒否するとアシスタントへの簡単な説明とともに保留されます。そのようなテキストを含まないページは、確認なしで従来どおりそのまま返されます。バッチ呼び出しでは、該当する項目のみが保留されます。

MCP 設定を扱うページ(ドキュメントや README など)では、通常この確認が表示されます。MCP elicitation に対応していないクライアントでは、該当するコンテンツが保留されます。リスクを許容する場合は CONTENT_GATE=off を設定してください。サーバーが回答を待っている間は進行状況が報告されます。進行状況の報告中にツールのタイムアウトを延長しないクライアントでは、待機時間がクライアント側の上限に制限されます。サーバー側で設定するには CONTENT_GATE_TIMEOUT を使用します。ブラウザーツールは対象外です。


ドキュメント

リソースリンク
API ドキュメントdocs.brightdata.com/ai/mcp-server/overview
ツールの完全なリファレンスdocs.brightdata.com/ai/mcp-server/tools
エージェントスキルgithub.com/brightdata/skills
使用例examples
変更履歴CHANGELOG.md

トラブルシューティング

よくある問題と解決策

「spawn npx ENOENT」エラー

Node.js をインストールするか、node のフルパスを使用してください。

"command": "/usr/local/bin/node"  // macOS/Linux
"command": "C:\\Program Files\\nodejs\\node.exe"  // Windows

複雑なサイトでタイムアウトする

クライアント設定でタイムアウトを 180s に延長してください。

認証の問題

API トークンが有効で、必要な権限を持っていることを確認してください。トークンはアカウント設定で管理できます。

run_scraper がエラーを返す、またはデータを返さない

error フィールドを含むレコードには、失敗した入力が記載されています。入力を get_scraper_details の sample_input と比較し(例:Amazon の商品 URL には /dp/ が含まれ、Walmart の URL には /ip/ が含まれます)、ページに公開アクセスできることを確認してください。フォールバックとして、scrape_as_markdown は同じ URL で動作します。

リモートサーバーへの接続に失敗する

インターネット接続とファイアウォールの設定を確認してください。


貢献

Bright Data のコーディング規約に従ってください。


サポート

チャネルリンク
GitHub の課題github.com/brightdata-com/brightdata-mcp/issues
ドキュメントdocs.brightdata.com/ai/mcp-server/overview
メールsupport@brightdata.com

ライセンス

MIT © Bright Data Ltd.