mcpField
B
browser

browser

github.com/brightdataクラウド・DevOps272133 回インストール2 週間前に更新
リポジトリ

browser について

browser スキルは、既存の Playwright、Puppeteer、Selenium の自動化を Bright Data のクラウドブラウザーで実行する方法や、`bdata browser` で段階的に操作する方法を案内します。自動化ロジックは維持し、接続設定、ゾーン選択、トラブルシューティングを扱います。

主な機能

  1. 01既存のブラウザー自動化への接続
  2. 02Playwright、Puppeteer、Selenium に対応
  3. 03`bdata browser` による段階的な操作
  4. 04種類によるブラウザーゾーンの特定
  5. 05接続エラーのガイダンス

活用シーン

  1. 01既存の自動化をクラウドブラウザーで実行
  2. 02ターミナルからブラウザーを段階的に操作
  3. 03ブラウザー接続の失敗を調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/brightdata/skills --skill browser

インストール後、Claude Code で/browserを入力して読み込まれたか確認します。

同梱ファイルreferences/connect.mdreferences/errors.md

詳細

Bright Data - Browser

ユーザーはすでに自動化を作成しています。このスキルでは、起動行を変更してローカルブラウザーではなくBright Dataのクラウドブラウザーで実行し、必要な認証情報を設定して、接続できることを確認するために一度実行します。自動化のロジックはそのままです。

唯一の質問

クリックするのは誰ですか?あなたのコード、AIモデル、それとも私たちですか?

クリックする人接続先
ユーザーのコード:Playwright、Puppeteer、またはSeleniumここにとどまります。書き換えは不要です。クラウドブラウザーを指定するだけです。
ユーザーのコンピューター操作モデル、自分でクリックするAIここにとどまります。同じ切り替えで、同じエンドポイントです。
エージェント自身がターミナルから手順を追って操作する場合ここにとどまり、bdata browser を操作します。open、snapshot、click <ref>、type <ref>、close をアクションごとに1つずつ実行します。コードを用意する必要はありません。すべてのサブコマンドは bdata browser --help に記載されています。また、brightdata-cli スキルの references/commands.md にはセッションのオプションが記載されています。
私たちscrape。Scraper Studioがクリックを実行するので、ユーザーは維持するドライバーではなく、フィールドを受け取ります。

リクエストでフレームワーク、手法、エージェントには言及されているものの、誰がブラウザーを操作するのかが明示されていない場合に質問します。一度だけ尋ねて、その後は実行します。動作するPlaywrightコードが手元にあり、ローカルブラウザーがブロックされているユーザーに、Scraper Studioの話をする必要はありません。

切り替えの内容

ローカルの起動呼び出しを、WebSocketへのリモート接続呼び出しに変更します。

wss://brd-customer-<CUSTOMER_ID>-zone-<ZONE>:<PASSWORD>@brd.superproxy.io:9222

Seleniumだけは例外です。CDPではなくWebDriverを使用するため、同じ認証情報でポート 9515 の https:// を使用します。セレクター、待機、ナビゲーション、スクリーンショット、ページのロジックはすべてそのままです。

エージェントは3つの値を自分で入力します。無料のAPI読み取りと、ユーザーがすでに持っているキー(BRIGHTDATA_API_KEY、なければCLIに保存されたログイン情報)を使い、ユーザーにプレースホルダーを残すことはありません。キーがどこにもない場合、ユーザーの設定は完了していません。その場合は agent-onboarding に引き継ぎ、チャットでキーを尋ねないでください。references/connect.md に、値の取得方法と設定方法の2通りが記載されています。

ゾーン

文字列を書き込む前に、名前ではなくタイプでBrowser APIゾーンを探します。

bdata zones --json

"type" が "browser_api" のエントリーの name を取得し、接続文字列の <ZONE> に使います。bdata login 後は cli_browser、エージェント登録で作成されたアカウントでは agent_browser_api、MCPサーバーがアカウントを設定した場合は mcp_browser です。ユーザーが手動で作成した場合はどんな名前でもあり得ます。タイプを確認し、表示された名前を使ってください。これは無料の読み取りで、セッションは開始されません。bdata が認識されない場合、CLIがインストールされていないか、npmのグローバルディレクトリがPATHにありません。どちらの修正方法も agent-onboarding スキルの「Install」セクションにあります。

このタイプのエントリーがない場合、修正すべき接続文字列がないということですが、まだアカウントの問題とは限りません。ユーザーの同意を得た後(アカウントが変更されます)、無料の呼び出しを1回実行するのが解決策です。POST https://api.brightdata.com/zone に本文 {"zone":{"name":"cli_browser","type":"browser_api"},"plan":{"type":"browser_api"}} を渡します。bdata browser open でも必要に応じてゾーンを作成できますが、課金対象のセッションが開始されます。また、--zone <name> または BRIGHTDATA_BROWSER_ZONE を指定しない限り、名前は cli_browser になります。そのため、ブラウザーゾーンの名前が異なるアカウントでは、その名前を渡してください。渡さないと2つ目のゾーンが作成されます(エージェント登録キーではゾーンを作成できないため、代わりに失敗します。その場合は --zone agent_browser_api を渡してください)。すでにログイン済みのマシンで bdata login を実行しないでください。保存済みのキーが置き換えられます。作成が kyc_required または business_account_required で拒否された場合、あるいは権限不足で拒否された場合(エージェント登録のキー、またはAdminロールかOpsロールを持たないユーザーはゾーンを作成できません)は、agent-onboarding に引き継いでください。その場合は、ユーザー自身がControl Panelでゾーンを作成します。

境界

スクレイパーの構築は scrape に該当し、ブラウザーを動かすものが何であるかを気にせず、ユーザーがデータを求めている場合も同様です。1ページを Markdown、HTML、またはスクリーンショットとして取得する場合は fetch に該当します。検索クエリから始まるものはすべて search に該当します。このスキルは、すでに存在するドライバー向けです。

サイトへのログイン

Browser API 経由でのパスワード入力は、デフォルトでブロックされています。KYC とコンプライアンス上の例外承認が必要です。承認される前にログインの手順を約束してはいけません。また、ブロックされた状態で再試行してはいけません。詳しい説明は隣のスキルにあります。agent-onboarding を開き、その中の references/auth.md ファイルを読んでください。KYC が必要なケースと不要なケース、および承認手順が記載されています。

次に読むもの

  • 接続行を書く前に references/connect.md を読んでください - 正確な文字列、キーと3つの要素それぞれの取得元、2つの設計(シークレットにエンドポイントを保存する方法と、実行時に参照する方法)とそれぞれを選ぶ基準、Playwright を最初から最後まで編集する手順が記載されています。
  • 接続に失敗したらすぐに references/errors.md を読んでください - 407 の client_100xx コードとそれぞれの意味、Browser API の認証コード、再試行のルールが記載されています。

警告事項 - 次のいずれかに気づいたら停止してください

  • ドライバーのコードがすでに動作しているユーザーに Scraper Studio を勧める
  • エンドポイント行を変更する代わりに、そのユーザーの自動化を書き換える
  • Selenium をポート 9222 に接続する、または Playwright を 9515 に接続する
  • パスワードを含む組み立て済みのエンドポイントを表示、ログ出力、またはコミットする。または、接続エラーを伏せ字にせず表示する
  • ターミナルで bdata zones info <zone> を実行する:ゾーンのパスワードが表示されます
  • エージェントが保存済みのキーを自分で読み取れるのに、ユーザーに入力用の変数を残す、またはキーを尋ねる
  • どのコードが返されたかを確認せずに 407 を再試行する
  • エラーで接続が拒否される前に、ユーザーに KYC を案内する
  • browser_api ゾーンをタイプで検索せず、ゾーン名をハードコードする、または推測する
  • 事前にユーザーへ確認せずにゾーンを作成する

コメント