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 MCP
Model Context Protocol を介して、AI エージェントや LLM にウェブ検索、ページのスクレイピング、構造化データの抽出、ブラウザーの自動操作を提供します。
AI エージェント、コーディングエージェント、チャットアシスタント、その他あらゆる MCP 対応クライアントで利用できます。
クイックスタート • 料金 • ユースケース • ツール • エージェントスキル • ドキュメント • サポート
無料枠:月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
- 次の場所を開きます:Settings → Connectors → Add custom connector
- 名前:
Bright Data - URL:
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN - 「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.50 | 1 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 で実行できます。
| プラットフォーム | スクレイパーの例 |
|---|---|
| 個人プロフィール、企業プロフィール、求人情報、投稿、人物検索 | |
| プロフィール、投稿、リール、コメント | |
| TikTok | プロフィール、投稿、ショップ、コメント |
| プロフィール、投稿、マーケットプレイスの出品、企業レビュー、イベント | |
| YouTube | 動画、チャンネル、コメント |
| X (Twitter) | 投稿、プロフィール別の投稿 |
| 投稿、コメント |
プロンプト例:「この TikTok プロフィールの最新10件の投稿を取得して、エンゲージメントを要約して」。
コンテンツ作成と学術調査
複数のページから、公開時期と関連性で絞り込んだ情報源を一度に収集します。
| タスク | ツール |
|---|---|
| 1回の呼び出しで複数の情報源を収集 | scrape_batch(最大5つの URL) |
| ニュースと金融データ | ニュース検索には search_engine、Yahoo Finance スクレイパーには run_scraper |
比較
| 機能 | Bright Data MCP | 一般的なウェブ MCP サーバー |
|---|---|---|
| ツールの合計数 | 30 | 2~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 |
geo | ChatGPT と 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_engine | Bing(デフォルト)または Google を検索します。JSON(リンク、タイトル、説明)を返し、1 ページあたり 10 件の結果を取得します。パラメーター:country、page(0 から)、time_range(hour、day、week、month、year、any。Bing が対応するのは day、week、year のみ) | デフォルト / すべてのグループ |
search_engine_batch | 1 回の呼び出しで最大 5 件の検索クエリを実行 | デフォルト / advanced_scraping |
scrape_as_markdown | 任意の URL。コンテンツを Markdown(デフォルト)、テキスト、HTML、または ld_json で返します | デフォルト / すべてのグループ |
scrape_batch | 1 回の呼び出しで最大 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_details | 1 つのスクレイパーメソッドについて、説明、入力フィールド、入力例、主な出力フィールドを表示します | デフォルト / 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_ref | ref で要素に入力します。必要に応じて Enter キーを押して送信できます |
scraping_browser_fill_form | 1 回の呼び出しで、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_assistant | Bright Data のサポートアシスタント Sophie に、製品、API、ゾーン、エラー、アカウント設定について質問します。同じスレッドで追加質問するには、返された dialog_id を渡します | デフォルト / すべてのグループ |
エージェントスキル
エージェントがこの MCP サーバーを正しく使う方法を学べる、すぐに使えるスキルです。スキルの全コレクションは github.com/brightdata/skills にあります。MCP オーケストレーション、競合情報、価格比較、ブランドの評判調査、SEO 監査、スクレイパー構築、RAG パイプラインなどを扱う 21 個のスキルが含まれています。
特に効果の高いスキルを 3 つ紹介します。
| スキル | 機能 |
|---|---|
| bright-data-mcp | Bright Data MCP をすべての Web データ操作のデフォルトにし、ボット検出で失敗する WebFetch、WebSearch などの組み込み Web ツールを置き換えます |
| competitive-intel | ライブ Web データから、競合のスナップショット、価格比較、レビュー分析、採用動向、コンテンツ / SEO 分析、市場全体のマップを作成します |
| price-comparison | Amazon、Walmart、eBay、Best Buy、Google Shopping で商品を照合し、在庫のある最安値の商品を提示します |
設定
基本設定(ローカル)
{
"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_TOKEN | Bright Data API トークン(必須) | - | your-token-here |
RATE_LIMIT | カスタムレート制限 | 無制限 | 100/1h、50/30m |
SERP_ZONE | 検索ツールで使用するカスタム SERP API ゾーン名 | mcp_serp | my_serp_zone |
BROWSER_ZONE | カスタム Browser ゾーン名 | mcp_browser | my_browser_zone |
CONTENT_GATE | データツールが返すページコンテンツに MCP 設定の変更を促す指示のような内容が含まれている場合、サーバーは返す前に MCP elicitation を通じてユーザーに確認します。無効にするには off に設定します | on | off |
CONTENT_GATE_TIMEOUT | コンテンツを保留するまでにユーザーの回答を待つ秒数 | 120 | 60、300 |
BROWSER_FILTERED_SNAPSHOT | scraping_browser_snapshot にはボタン、リンク、入力欄のみが常に表示されます。トークンを節約し、ページ上のテキストがクリック可能な要素を装うのを防ぎます(機密性の高いタスク向け)。必要に応じて、scraping_browser_get_text でページのテキストを読み取れます | off | on |
BASE_TIMEOUT | 基本ツール(検索とスクレイピング)のリクエストタイムアウト(秒) | 制限なし | 60、120 |
BASE_MAX_RETRIES | 一時的なエラーが発生した場合に基本ツールが再試行する最大回数(0~3) | 0 | 1、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.