browser について
browser スキルは、既存の Playwright、Puppeteer、Selenium の自動化を Bright Data のクラウドブラウザーで実行する方法や、`bdata browser` で段階的に操作する方法を案内します。自動化ロジックは維持し、接続設定、ゾーン選択、トラブルシューティングを扱います。
主な機能
- 01既存のブラウザー自動化への接続
- 02Playwright、Puppeteer、Selenium に対応
- 03`bdata browser` による段階的な操作
- 04種類によるブラウザーゾーンの特定
- 05接続エラーのガイダンス
活用シーン
- 01既存の自動化をクラウドブラウザーで実行
- 02ターミナルからブラウザーを段階的に操作
- 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ゾーンをタイプで検索せず、ゾーン名をハードコードする、または推測する- 事前にユーザーへ確認せずにゾーンを作成する