CLI で即席収集（markdown / html / screenshot）

Bright Data CLI は、SDK を組む前にまず挙動を確かめたい場面や、ターミナル主体で調査を回したい場面に向いています。公式コマンドは scrape、search、browser、zones、budget までそろっているので、PoC の切り分けをコードより先に進めやすいのが利点です。

誰の課題か

• まずはコードを書く前に、対象ページが取れるかをターミナルで確認したい開発者
• HTML ではなく Markdown やスクリーンショットで結果を見たい QA / リサーチ担当
• zone 設定や費用感を、アプリ実装に入る前に把握したいチーム

推奨製品セット

• 初回 brightdata login 時に、CLI は cli_unlocker と cli_browser の zone を自動作成すると Docs にあります。
• brightdata add mcp もあるため、CLI から MCP クライアント設定へ進む導線も用意されています。

最小実装イメージ

ログインして Markdown / HTML / screenshot を取る

brightdata login --api-key "$BRIGHTDATA_API_KEY"
 
brightdata scrape https://example.com
brightdata scrape https://example.com -f html -o example.html
brightdata scrape https://example.com -f screenshot -o example.png

• scrape のデフォルト出力は Markdown です。
• -f には markdown、html、screenshot、json を指定できます。

SERP API を CLI から直接たたく

brightdata search "bright data cli" --engine google --country jp --json --pretty

• search は Google / Bing / Yandex に対応します。
• Google は構造化 JSON、Bing と Yandex は既定で Markdown が返る案内です。

ブラウザ状態を 1 セッションで確認する

brightdata browser open https://example.com --country jp
brightdata browser snapshot --compact
brightdata browser screenshot --full-page -o page.png
brightdata browser close

• browser snapshot --compact は、AI エージェント向けにインタラクティブ要素中心の軽い表現を返します。
• 画面遷移後は ref が振り直されるため、クリックや入力の前に毎回 snapshot を取り直す前提で使います。

運用ポイント

• CLI は PoC 向きですが、定常ジョブまでそのまま CLI に寄せると再試行制御や構造化ログで限界が来ます。本番化時は SDK か API へ寄せる判断が必要です。
• brightdata zones と brightdata budget zones を先に見ておくと、どの zone をどの用途で使うかの整理がしやすくなります。
• brightdata add mcp は brightdata login で保存された API key を使う仕様です。環境変数を直接読まない点は運用手順に残しておくべきです。
• scrape は便利ですが、定形データが必要なら pipelines や Dataset API のほうが後処理は軽くなります。
• ブラウザ確認で「取れる」と分かったあと、同じ処理を Playwright や browser-use に移すのが自然な流れです。

関連リンク

• 認証ガイド
• 基礎 / API グループ
• ロードマップ Lv2
• ハンズオン Step 1: 認証と最初の API 呼び出し
• ハンズオン Step 5: Browser API + Playwright
• UC-DEV-003 MCP Server で AI クライアント接続
• UC-DEV-009 Playwright 統合
• 用語集
• CLI Command Reference
• Bright Data CLI Blog