brightdata-mcp について
AIアプリが実行時にデータ取得ツールを選ぶ Bright Data MCP の設定と利用指針を扱うスキルです。ホスト型の Remote とセルフホスト型の Local、認証、ツールの絞り込み、適切なスクレイパーやページ取得ツールへの振り分けを説明します。
主な機能
- 01Remote と Local の設定
- 02認証とツールフィルターの説明
- 03指定サイトをスクレイパーに振り分け
- 04Markdown 形式でページを取得
- 05MCP、CLI、SDK の違いを説明
活用シーン
- 01MCP クライアントを Bright Data に接続
- 02ツール一覧の差異を調査
- 03適切な取得ツールをエージェントに案内
MCP 対応
Bright Data はホスト型の Remote エンドポイント、または stdio で動作するセルフホスト型の @brightdata/mcp パッケージを通じて、MCP クライアントにデータ取得ツールを提供します。本スキルは設定、認証、ツール選択、振り分け方法を説明します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ brightdata/ skills --skill brightdata-mcpインストール後、Claude Code で/brightdata-mcpを入力して読み込まれたか確認します。
同梱ファイルreferences/choosing-tools.mdreferences/setup.md
詳細
Bright Data MCP
MCP は、実行時に取得する情報を判断する AI アプリのインターフェースです。モデルは Bright Data のツール一覧を読み、ターンごとにツールを 1 つ選びます。実行するシェルも、ターン間に編集するコードパスもないため、公開するツール一覧と記述するルーティングルールが、製品として提供するすべてです。
人間やコーディングエージェントがターミナルから作業を実行する場合は、brightdata-cli を使います。同じジョブを独自のコードからスケジュール実行する場合は、brightdata-sdk を使います。MCP は実行時の選択に使います。
実装が分岐した 2 つのバリアント
Bright Data には 2 つのバリアントがあり、ベンダーは Remote(mcp.brightdata.com でホストされるサービス)と Local(セルフホスト可能な @brightdata/mcp パッケージ)と呼んでいます。
| Remote | Local | |
|---|---|---|
| エンドポイント | https://mcp.brightdata.com/mcp(Streamable HTTP)または /sse | stdio 経由の npx @brightdata/mcp |
| 認証 | 自分で管理するクライアントでは URL の ?token=、ほかのユーザーがクライアントを実行する場合は OAuth 2.1(Bearer ヘッダー、ブラウザーでのサインイン) | API_TOKEN 環境変数 |
| ツール設定 | URL クエリパラメーター groups= および tools= | 環境変数 GROUPS および TOOLS |
| デフォルトのツール一覧 | すべてのツールが有効で、31 個あります。groups= または tools= で絞り込めます | すべてのツールが有効で、32 個あります。GROUPS または TOOLS で絞り込めます |
公開されているパッケージは @brightdata/mcp です。Remote は独自のリリース系列を追っています。一方にあるツール名が、もう一方にもあるとは限りません。また、動作する設定をそのまま別のバリアントに引き継がないでください。実際に使用するバリアントで確認してください。
キー
?token= と API_TOKEN のどちらにも、アカウントの API キーを指定します。CLI と同じ方法で確認してください。BRIGHTDATA_API_KEY が設定されていればそれを使い、設定されていなければ、bdata login が書き込む credentials.json 内の api_key を使います(Linux の場合は ~/.config/brightdata-cli/、macOS の場合は ~/Library/Application Support/brightdata-cli/、Windows の場合は %USERPROFILE%\AppData\Roaming\brightdata-cli\)。ログイン後は通常、この環境変数は空で、キーはファイルにのみ保存されています。これはログイン済みのマシンであり、キーがないわけではないため、コードから読み取って、決して表示しないでください。キーが存在するかを確認するには、agent-onboarding スキルから node scripts/check-auth.mjs を実行します(キーは表示されません)。ファイルや環境変数を cat、echo、jq で表示してはいけません。設定や URL に渡すには、設定を書き込むプログラムまたはコマンド内で読み取り、出力されるものには含めないでください(シェルごとの読み取り方法は、そのスキルの references/auth.md に記載されています)。どちらも存在しない場合は、agent-onboarding に引き継いでください。ユーザーにチャットへキーを貼り付けるよう求めてはいけません。
デフォルトのルーティング
エージェントが名前を特定できるサイトのレコードは、事前構築済みのスクレーパーに送ります。search_scrapers で該当するものを探し、get_scraper_details で入力を確認してから、run_scraper を実行します。ページのコンテンツには scrape_as_markdown を使います。ロック解除済みの生 HTML を取得する scrape_as_html は最終手段であり、最初に使うものではありません。これは最も多くのトークンを浪費し、最も質の低いデータを返す誤ったルーティングです。そのため、プロンプトやツールの説明を作成する前に、このルールを読んでください。
参考資料
- references/setup.md — クライアントを初めて接続するとき、エージェントに表示されるツール数が正しくないとき、または Remote と Local のどちらを使うか判断するときに開いてください。両方のインストール方法、認証、ゾーン、
GROUPSおよびTOOLSフィルターについて説明しています。 - references/choosing-tools.md — エージェントのシステムプロンプトやツールのガイダンスを作成する前、または既存のスクレーパーが返せるデータをエージェントが生 HTML からスクレイピングしているときに開いてください。すべてのツール一覧とルーティング表について説明しています。