Bright Data MCP について
Bright Data MCPは、AIエージェントやLLM向けに公開ウェブの検索、スクレイピング、構造化データ抽出、ブラウザー自動化を提供するMCPサーバーです。Bright Dataのブロック回避インフラを利用でき、ホスト型リモートサーバーまたはローカルで実行できます。
主な機能
- 01Google、Bing、Yandexの検索
- 02MarkdownまたはHTMLでのページ取得
- 03既成スクレイパーによる構造化データ抽出
- 04リモートブラウザーの操作
- 05ChatGPTとPerplexityの回答収集
- 06検索とスクレイピングの一括実行
活用シーン
- 01最新情報の調査と出典確認
- 02EC商品の価格やレビューの比較
- 03競合やソーシャルメディアの分析
- 04npm、PyPI、GitHub情報の収集
MCP 対応
MCPサーバーとして、対応クライアントにウェブ検索、ページ取得、構造化データ抽出、ブラウザー自動化、LLM回答収集のツールを公開します。ホスト型リモートサーバーとローカルのnpx実行に対応します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Bright Data MCP
Model Context Protocol を介して、AI エージェントや LLM 向けに、ウェブ検索、ページスクレイピング、構造化データの抽出、ブラウザーの自動操作を提供します。
AI エージェント、コーディングエージェント、チャットアシスタント、および MCP 対応クライアントで利用できます。
クイックスタート • 料金 • ユースケース • ツール • エージェントスキル • ドキュメント • サポート
無料枠:月間5,000リクエスト。クレジットカードは不要です。毎月更新されます。
概要
Bright Data MCP サーバーを使うと、AI エージェントは公開ウェブデータにリアルタイムでアクセスできます。以下を網羅する32 個のツールを提供します。
- ウェブ検索 — Google、Bing、Yandex の検索結果を構造化データとして取得
- ページスクレイピング — 任意の URL を Markdown または HTML として取得。ボット検知、CAPTCHA の解決、プロキシのローテーションは、すべてのリクエストで自動的に処理されます
- 構造化データ(Web Scraper API) — Amazon、LinkedIn、Instagram、TikTok、YouTube、X、Reddit、Facebook、Crunchbase、Zillow、npm、PyPI など、1,200 種類以上の構築済みスクレイパーから、HTML を解析せずにクリーンな JSON を取得します。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
Bright Data アカウント設定から API トークンを取得してください。新規アカウントには、毎月 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 種類以上の構築済みスクレーパーへのアクセス
- ウェブ検索(Google、Bing、Yandex)
- ウェブのロック解除(ボット検出の回避、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 |
| 並列データ収集(一度に10件) | search_engine_batch、scrape_batch |
| インタラクティブなサイト(ログイン画面、無限スクロール、動的コンテンツ) | scraping_browser_*(14個のツール) |
| スキーマ不要で任意のページから構造化JSONを取得 | extract |
コーディングエージェント
パッケージレジストリのデータを必要に応じて取得できます。スクレイピングも古いキャッシュも不要です。
| タスク | ツール |
|---|---|
| npmおよびPyPIパッケージのバージョン、README、メタデータ | npmjsまたはpypiスクレイパーを使ったrun_scraper(search_scrapersで検索できます) |
| GitHubリポジトリからファイルを読み取る | GitHubリポジトリスクレイパーを使ったrun_scraper |
プロンプトの例:「npmのexpressの最新バージョンを教えてください。」「PyPIパッケージlangchain-brightdataの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(最大10件のURL) |
| ニュースと金融データ | ニュース検索クエリを使ったsearch_engine、Yahoo Financeスクレイパーを使ったrun_scraper |
比較
| 機能 | Bright Data MCP | 一般的な Web MCP サーバー |
|---|---|---|
| ツールの合計数 | 32 | 2–10 |
| プラットフォーム固有の構造化 JSON 抽出ツール | e コマース、ソーシャル、ビジネス、金融、旅行、アプリストアにわたる 1,200 以上の事前構築済みスクレイパーを 6 つのツールで利用可能 | まれ。汎用スクレイピングのみ |
| ブロック回避(ボット検出の回避、CAPTCHA の解決、プロキシのローテーション) | すべてのリクエストに組み込み済み | 通常はなし。保護されたサイトではブロックされます |
| 検索エンジン | Google、Bing、Yandex | 通常は 1 つ |
| ブラウザーの自動化 | 14 個のツール、リモートブラウザー、ローカルでのセットアップ不要 | 限定的、またはなし |
| LLM の応答収集(ChatGPT、Perplexity) | 対応 | 提供なし |
| パッケージレジストリのデータ(npm、PyPI) | 対応 | 提供なし |
| バッチ処理 | 1 回の呼び出しにつき検索 10 件、またはスクレイピング 10 件 | 通常は 1 リクエストのみ |
| 地域ターゲティング | 対応 | 限定的、またはなし |
| 無料枠 | 月 5,000 リクエスト、ブラウザー自動化を含む、クレジットカード不要 | さまざま。キー不要のアクセスは、レート制限される場合が多い |
ツールの選択:グループ
必要なツールだけを読み込めるように、ツールはグループに整理されています。ツールが少ないほど、エージェントが処理するコンテキストも少なくなります。
GROUPSとTOOLSのどちらも指定しない場合、32 個すべてのツールが有効になります。どちらかを設定すると、指定したツールのみが有効になりますGROUPSはツールのバンドルを有効にします。カンマ区切りで指定します:GROUPS="scrapers,browser"(ローカル)または&groups=scrapers,browser(ホストされた URL)TOOLSは個別のツールを追加します:TOOLS="extract,scrape_as_html"。単独で指定すると、リストしたツールのみが有効になります- すべてのグループには、
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 | バッチツール、HTML スクレイピング、AI 抽出、セッション統計 | 5 |
以前のグループ ID(ecommerce、social、business、finance、research、app_stores、travel、code)も引き続き使用でき、scrapers ツールが有効になります。social と business では、search_dataset と list_dataset_fields も追加されます。TOOLS 内の以前の web_data_* 名でも、scrapers ツールが有効になります。
設定例
ブラウザー自動化と AI 抽出を備えたローカルサーバー:
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<your-api-token-here>",
"GROUPS": "browser,advanced_scraping",
"TOOLS": "extract"
}
}
}
}
コーディングエージェントの設定(Claude Code / Cursor / Windsurf)— 事前構築済みのスクレイパーを通じて npm、PyPI、GitHub のデータを取得:
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<your-api-token-here>",
"GROUPS": "scrapers"
}
}
}
}
ツールリファレンス(32 個のツール)
使用するツールの選び方
- URL がわかっていて、コンテンツが必要な場合:
scrape_as_markdown。複数の URL(最大 10 件):scrape_batch - 情報を探す場合:
search_engine。複数のクエリ(最大 10 件):search_engine_batch - 既知のプラットフォーム(Amazon、LinkedIn、TikTok、npm、PyPI など)の構造化データ:
search_scrapers→get_scraper_details→run_scraper— クリーンな JSON を返します。同じページをスクレイピングするより高速で信頼性が高い方法です - スクレイパーが対応していないページから構造化 JSON を取得する場合:
extract - 生の HTML:
scrape_as_html - ページの操作(クリック、入力、スクロール、ログイン)が必要な場合:
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を使用できます
検索とスクレイピング — 7 個のツール
| ツール | 説明 | グループ | |------|-------------|-------| | `search_engine` | Google、Bing、または Yandex で検索します。Google は JSON(URL、タイトル、説明)を返し、Bing と Yandex は Markdown を返します。`cursor` パラメーターでページネーションできます | default / すべてのグループ | | `search_engine_batch` | 1 回の呼び出しで最大 10 件の検索クエリを実行します | default / `advanced_scraping` | | `scrape_as_markdown` | 任意の URL を Markdown に変換します。ボット対策や CAPTCHA に自動で対応します | default / すべてのグループ | | `scrape_batch` | 1 回の呼び出しで最大 10 件の URL を処理し、URL とコンテンツのペアを Markdown 形式の配列で返します | default / `advanced_scraping` | | `scrape_as_html` | 任意の URL を生の HTML として取得します | default / `advanced_scraping` | | `extract` | ページをスクレイピングし、AI を使用して構造化 JSON に変換します。任意でカスタム抽出プロンプトを指定できます | default / `advanced_scraping` | | `session_stats` | 現在のセッションにおけるツールの使用回数 | default / `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、名前、ドメイン、収集方法を返します | default / scrapers |
get_scraper_details | 1 つのスクレイパーメソッドの説明、入力フィールド、入力例、主な出力フィールドを取得します | default / scrapers |
run_scraper | スクレイパーメソッドを実行します。最大 45 秒間待機し、完了しない場合は後で確認するための snapshot_id を返します | default / scrapers |
get_scraper_progress | 実行状況を返します:starting、running、ready、failed、または canceled | default / scrapers |
get_scraper_results | 完了した実行のレコードを返します | default / scrapers |
refresh_scrapers | 毎日の更新を待たずに、スクレイパー一覧を今すぐ再読み込みします | default / scrapers |
ブラウザー自動化 — 14 個のツール
リモートブラウザーセッションです。一般的な手順:移動 → スナップショット取得 → ref で操作 → 抽出またはスクリーンショット取得。
| ツール | 説明 |
|---|---|
scraping_browser_navigate | ブラウザーセッションを開くか再利用して、URL に移動します |
scraping_browser_go_back | 前のページに戻ります |
scraping_browser_go_forward | 次のページに進みます |
scraping_browser_snapshot | ページの ARIA スナップショットを取得し、操作可能な要素を ref 付きで一覧表示します。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 の前に呼び出します | default / social、business |
search_dataset | フィルターに一致するレコードを、1 回あたり最大 10 件返します。続きの検索にはカーソルを使用します | default / social、business |
Bright Data アシスタント — 1 つのツール
| ツール | 説明 | グループ |
|---|---|---|
ask_brightdata_assistant | Bright Data のサポートアシスタントである Sophie に、製品、API、ゾーン、エラー、アカウント設定について質問します。同じスレッドで追加質問するには、返された dialog_id を渡します | default / すべてのグループ |
エージェントスキル
エージェントに、この MCP サーバーを正しく使う方法を教える、すぐに使えるスキルです。全コレクションは github.com/brightdata/skills にあり、MCP オーケストレーション、競合インテリジェンス、価格比較、ブランドの評判調査、SEO 監査、スクレイパーの構築、RAG パイプラインなどを網羅する 21 個のスキルを収録しています。
特に効果の高い 3 つのスキル:
| スキル | 機能 |
|---|---|
| bright-data-mcp | すべてのウェブデータ操作で Bright Data MCP をデフォルトに設定し、ボット検出により失敗する WebFetch、WebSearch、その他の組み込みウェブツールを置き換えます |
| competitive-intel | ライブウェブデータをもとに、競合のスナップショット、価格比較、レビューの分析、採用動向、コンテンツ/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",
"WEB_UNLOCKER_ZONE": "custom",
"BROWSER_ZONE": "custom_browser"
}
}
}
}
環境変数
| 変数 | 説明 | デフォルト | 例 |
|---|---|---|---|
API_TOKEN | Bright Data API トークン(必須) | - | your-token-here |
RATE_LIMIT | カスタムのレート制限 | 無制限 | 100/1h、50/30m |
WEB_UNLOCKER_ZONE | カスタムの Web Unlocker ゾーン名 | mcp_unlocker | my_custom_zone |
BROWSER_ZONE | カスタムの Browser ゾーン名 | mcp_browser | my_browser_zone |
CONTENT_GATE | データツールが返すページのコンテンツに、MCP の設定を変更する指示のような記述が含まれている場合、サーバーは返す前に MCP のエリシテーションを通じてユーザーに確認します。無効にするには 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 | カンマ区切りの個別ツール名。サーバーを指定したツールに制限します | すべてのツール | extract,scrape_as_html |
コンテンツゲート
scrape_as_markdown、search_engine、extract とそのバッチ版は、ウェブページに記載された内容をそのまま返します。その内容に、MCP の設定を変更する指示(サーバーの登録、npx -y パッケージの実行、MCP 設定ファイルの編集など)のようなテキストが含まれている場合、サーバーは処理を一時停止し、MCP クライアントを通じて確認します。承認すると、内容は変更されずに返されます。拒否すると、内容は保留され、アシスタントに短い説明が返されます。そのようなテキストが含まれていないページは、これまでどおり、確認なしでそのまま返されます。バッチ呼び出しでは、該当する項目のみが保留されます。
MCP の設定を扱うページ(ドキュメントや README など)では、通常、確認が求められます。MCP エリシテーションに対応していないクライアントでは、該当する内容が保留されます。リスクを許容する場合は、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/ が含まれます)、ページに公開アクセスできることを確認してください。代替手段として、同じ URL で scrape_as_markdown を使用できます。
リモートサーバーへの接続に失敗する
インターネット接続とファイアウォールの設定を確認してください。
貢献
Bright Data のコーディング規約に従ってください。
サポート
| チャネル | リンク |
|---|---|
| GitHub のイシュー | github.com/brightdata-com/brightdata-mcp/issues |
| ドキュメント | docs.brightdata.com/ai/mcp-server/overview |
| メール | [email protected] |
ライセンス
MIT © Bright Data Ltd.
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。