Claude Code、Codex CLI、その他のローカルAIエージェントでのBright Data CLIの使い方

この記事では、以下の内容を学びます：

• AIエージェントがエンタープライズグレードのウェブアクセスツールを必要とする理由と、CLIを通じてそれらを公開することが効果的なアプローチである理由。
• Bright Data CLIをローカルにインストールして設定する方法。
• Claude Code、Codex CLI、Gemini CLIなど、シェルアクセスを持つAIエージェントがBright Data CLIを使用できるようにするための手順とベストプラクティス。
• AIソリューションにウェブ機能を提供する際のCLI、MCP、Agent Skillsの主な違い。

それでは始めましょう！

AIエージェントには信頼性の高いウェブアクセスが必要

AIエージェントは、ウェブへのアクセスを必要とする多くの実世界のタスクを実行することが期待されています。静的なトレーニングデータによるLLMの知識制限を克服するためにも、オンラインソースを自由に探索できる能力が必要です。

そのため、主要なLLMプロバイダーのほとんどは組み込みのウェブ検索機能を備えています。しかし、これらのツールは信頼性とスケールに課題を抱えることが多く、CAPTCHA、レート制限、フィンガープリントチェックなどのアンチボットシステムで保護されたサイトへのアクセスに失敗しがちです。

本番ユースケースでは、AIエージェントにはエンタープライズレベルのツールが必要であり、ウェブデータの取得やウェブページとのインタラクションを確実に行えることが求められます。

CLIがAIエージェントにとって自然なインターフェースである理由

AIエージェントにウェブツールを公開する最も効果的な方法の一つがCLIです。その理由は、ほとんどのLLMがシェルの使用について広範囲にトレーニングされており、一般的なCLIワークフローに既に精通しているためです。

LLMは--helpを使ってコマンドを見つけ、複数のコマンドを連結し、出力を解釈し、エラーから回復し、複雑なワークフローを自動化できます。これにより、CLIベースの統合は柔軟で軽量であり、最新のAIと高い互換性を持ちます。

Bright Data CLI：AIエージェント向けエンタープライズグレードのウェブアクセス

Bright Data CLIは、Bright Dataのウェブデータインフラを直接ターミナルに提供します。特に、検索、スクレイピング、ディスカバリー、構造化データの抽出、ブラウザインタラクションの自動化などのコマンドを公開しています。

注記：Bright Data CLIのコードはGitHubで確認できます。

最も人気のあるコマンドには以下が含まれます：

このCLIツールが異なる点は、4億以上のレジデンシャルIPのネットワーク上に構築されたBright Dataのインフラを基盤としていることです。このグローバルインフラは大規模な本番グレードのワークロード向けに設計されており、99.99%のアップタイム、99.95%の成功率を達成し、最も困難なウェブサイトへのアクセスを可能にする統合アンチボット回避機能を備えています。

そのため、Bright Data CLIを使用するAIエージェントは、複雑なウェブサイトを扱う場合でも、大規模にウェブを探索してインタラクションすることができます。

Bright Data CLIを始める方法

以下のセクションでは、マシンにBright Data CLIをセットアップするプロセスを説明します。

または、公式インストール・セットアップガイドを参照するか、Bright Data CLI専用の記事をお読みください。

前提条件

Bright Data CLIをローカルで実行するには、以下が必要です：

• ローカルにインストールされたNode.jsバージョン20以上（最新のLTSバージョンを推奨）。
• Bright Dataアカウント（無料で新規作成可能）。

重要：Bright Data CLIには月5,000リクエストの無料枠が含まれており、Bright Dataのサブスクリプションなしで始めることができます。

ステップ#1：Bright Data CLIのインストール

任意のプラットフォームにBright Data CLIをインストールするには、次のコマンドを実行します：

npm install -g @brightdata/cli

このコマンドは@brightdata/cli npmパッケージをシステム全体にグローバルインストールします。

または、LinuxまたはmacOSの場合、[公式シェルスクリプトを使用してインストール](https://github.com/brightdata/cli?tab=readme-ov-file#macos, linux)することもできます：

curl -fsSL https://cli.brightdata.com/install.sh | sh

インストールが完了すると、brightdataコマンド（または短縮エイリアスのbdata）がグローバルに使用できるようになります。

CLIが正常にインストールされたことを確認するには、--version（または-v）フラグでバージョンを確認します：

brightdata, version

または短縮コマンドを使用します：

bdata, version

次のような出力が表示されるはずです：

0.3.2

完了です！Bright Data CLIがインストールされました。次に、Bright Dataアカウントに接続します。

ステップ#2：Bright Dataアカウントの連携

Bright Data CLIをBright Dataアカウントで認証する時が来ました。次のコマンドを実行します：

bdata login

このコマンドは自動的にデフォルトブラウザを開き、Bright Dataサインインページにリダイレクトします。ブラウザが開かない場合は、ターミナルに表示されたURLをコピーしてブラウザに貼り付けてください。その後、プロンプトに従ってOAuthでBright Dataアカウントを認証します。

注記：マシンにグラフィカルブラウザへのアクセスがない場合は、代わりに次のコマンドを実行します：

bdata login, device

このコマンドは確認URLとワンタイムコードを表示します。ブラウザを持つ任意のデバイスからURLを開き、コードを入力して認証プロセスを完了します。完了すると、マシン上のCLIセッションが認証されます。

サインイン後、次のような確認ページが表示されます：

認証が完了すると、CLIはBright Data Agent APIキーを生成します：

この特別なAPIキーはローカルに保存され、CLIがBright Dataサービスへのリクエストを安全に認証するために使用されます。

サインアウトして保存された認証情報を削除したい場合は、次のコマンドを実行します：

bdata logout

これで、ターミナルから直接ウェブにアクセスする準備が整いました。

ステップ#3：Bright Data CLIセットアップのテスト

Bright Data CLIが正常に動作していることを確認するには、次のコマンドを実行します：

bdata scrape "https://example.com/"

これはCLIのscrapeコマンドを呼び出してhttps://example.com/のコンテンツを取得します。内部では以下の処理が行われます：

1. Bright Data Web Unlocker APIを通じてリクエストを送信。
2. ページを取得。
3. Markdownで抽出されたコンテンツを返す（デフォルトの出力形式）。

注記：MarkdownはLLMの取り込みに適したフォーマットであり、Bright Data CLIがAIワークフロー向けに構築されていることを示しています。

次のような出力が表示されます：

これはターゲットページのLLM最適化されたMarkdown表現に対応しています：

利用可能なすべてのBright Data CLIコマンドとオプションを確認するには、公式ドキュメントを参照してください。

完了！Bright Data CLIのインストール、認証、使用準備が整いました。

ローカルAIエージェントにウェブタスクでBright Data CLIを使用するよう指示する

Bright Data CLIがマシン上で利用可能になったので、お気に入りのAIエージェントにウェブタスクで使用するよう指示できます。

以下のセクションは、シェルアクセスを持つあらゆるAIエージェントソリューションに適用されます。Claude Code、Codex CLI、Gemini CLI、OpenCode、Aider、Pi などのCLIベースのエージェント、Claude DesktopやGooseなどのデスクトップAIアシスタント、OpenClaw、ZeroClaw、および類似のソリューションなどのAIエージェントフレームワークが含まれます。

目標は、これらのAIエージェントがウェブデータの取得、スクレイピング、検索、ブラウザ自動化タスクにBright Data CLIを自律的に使用するために必要なコンテキストを提供することです。

以下の手順に従ってください！

前提条件

始める前に、以下が準備されていることを確認してください：

• Bright Data CLIがローカルにインストールされ設定されていること。
• AIエージェント（例：Claude Code、Claude Desktop、Gemini CLI、Codex、OpenCodeなど）がマシンにセットアップされていること。

注記：以下の章ではClaude Codeを例として使用していますが、シェルアクセスを持つ他のAIエージェントソリューションでも動作します。全体的なアプローチへの変更は必要ありません。

ステップ#1：シェルアクセスの有効化

まず、AIエージェントがシステムシェルにアクセスできる必要があります。AIエージェントが基盤となるターミナル環境とインタラクションしてコマンドを実行できない場合、Bright Data CLIを呼び出すことができません。

最新のAIエージェントソリューションのほとんどは、コマンド実行前に確認を求めるパーミッションシステムと組み合わせた組み込みのシェルアクセスを既に備えています。ただし、一部のエージェントではコマンド実行アクセスが無効になっています。

シェルアクセスが無効になっている場合は、エージェントのドキュメントを参照して、続行する前に有効にしてください。セキュリティ上の理由から、ターミナルコマンドを実行する前に承認を必要とするモードでエージェントを設定することをお勧めします。

ステップ#2：Bright Data CLIに関するコンテキストの提供

AIエージェントはBright Data CLIが何であるかを知らない可能性があり、プロンプトで言及した際にその目的を誤って推測することがあります。幻覚のリスクを軽減するために、ツールに関する初期コンテキストをエージェントに提供します。

次のプロンプトから始めます：

From now on, assume the Bright Data CLI is installed and available through the `bdata` command.

You can use it to:
- Scrape websites.
- Search the web.
- Extract structured data from 40+ supported platforms.
- Control remote browsers for browser automation.
- Perform other web data retrieval tasks.

Whenever a task requires web data or browser automation, consider whether the Bright Data CLI is the most appropriate tool before using other approaches.

これにより、AIエージェントはBright Data CLIが何であり、いつ使用すべきかを理解するために必要な情報を得ることができます。

プロンプトでは長いbrightdataコマンドではなくbdataコマンドのみを使用していることに注意してください。これにより指示がシンプルになり、CLIとのインタラクション時の混乱を避けられます。

AIエージェントでプロンプトを実行すると、次のような出力が表示されます：

素晴らしい！ローカルAIエージェントがBright Data CLIを認識しました。

ステップ#3：AIエージェントにCLIを効果的に使用する方法を指示する

ほとんどのLLMはCLIツールとのインタラクション方法を既に知っています。しかし、AIエージェントにBright Data CLIを適切に活用する方法を明示的に指示することはやはり良い実践です。

そのため、以下のプロンプトを実行します：

When using the Bright Data CLI, do not assume command names, arguments, or options.

Always use `bdata, help` and `<command> --help` (or `-h`) to discover the available commands, understand their syntax, and determine the correct flags before executing them.

これはAIエージェントをBright Data CLIの正しい使用方法に導くのに十分なはずです。

エージェントにCLIドキュメント全体を提供したり、利用可能なすべてのコマンドを手動で説明したりする必要はありません。組み込みの--help（-h）フラグが、エージェントがCLIを発見して使用するために必要なすべての情報を提供します。

ヒント：オプションとして、特定のタスク要件に応じてどのコマンドを使用するかについて追加のガイダンスを提供することを検討してください。

AIエージェントは次のような応答を返すはずです：

プロンプトの指示がなぜ十分なのかを理解するために、ターミナルで次のコマンドを試してみてください：

bdata, help

このコマンドが利用可能なすべてのBright Data CLIコマンドを一覧表示することを確認してください：

次に、特定のコマンドの--help出力を確認します：

bdata search, help

提供される詳細のレベルを確認してください：

出力にはAIエージェントが様々なユースケースに適応できる例も含まれています。

したがって、--help（または-h）でコマンドを呼び出すことで、エージェントはBright Data CLIコマンドを正常に使用するために必要なすべての情報を受け取ります。

素晴らしい！AIエージェントはBright Data CLIを最大限に活用するために必要なコンテキストと指示を持つようになりました。

ステップ#4：ウェブタスクにBright Data CLIを使用する

これで、Bright Data CLIがサポートする多くのウェブ関連タスクをAIエージェントに処理させることができます。

例えば、次のタスクを実行します：

Use the Bright Data CLI to research the best AI startups in Europe. Select 2,3 relevant sources and scrape their content. Based on these sources, identify the top 3 AI startups in Europe. Then, search for each startup's Crunchbase company profile and extract structured information from it. Finally, create a report describing what each company does and include the relevant Crunchbase data.

このタスクにはウェブ検索、ウェブスクレイピング、構造化データ抽出が含まれます。そのため、AIエージェントがBright Data CLIで達成できることの優れた例です。

Claude Codeで実行すると、次のようなワークフローが表示されます：

具体的には、AIエージェントは以下を実行しました：

1. bdata, helpを呼び出してBright Data CLIで利用可能なコマンドを確認。
2. ウェブ検索に適切なコマンドとしてbdata searchを特定。
3. bdata searchを使用してGoogleで「best AI startups Europe 2026」の検索クエリを実行し、JSON形式のSERPを取得。
4. 検索結果を分析して最も関連性の高い記事を特定。
5. ウェブページコンテンツの抽出に適切なコマンドとしてbdata scrapeを特定。
6. bdata scrape, helpを呼び出してコマンドの構文と利用可能なオプションを理解。
7. 選択した記事URLにbdata scrapeを使用してMarkdown形式でコンテンツを取得。
8. Markdownコンテンツを分析し、ソース全体で言及されているトップ3のAIスタートアップを特定。
9. Crunchbaseプロフィールから構造化データを抽出するのに適切なコマンドとしてbdata pipelinesを特定。
10. bdata pipelines, helpを呼び出してコマンドの構文を理解。
11. bdata searchを使用して各スタートアップのCrunchbaseプロフィールページを検索。
12. 各CrunchbaseプロフィールにJSON形式で構造化された企業データを抽出するためにbdata pipelinesを使用。内部ではBright DataのCrunchbaseスクレイパーを活用。
13. 抽出されたすべての情報を最終的なMarkdownレポートにまとめる。

最終的に生成されたレポートは次のようになります：

生成された出力は、元の記事の情報とCrunchbaseから抽出された構造化データの両方を組み合わせています。

完成です！提供されたプロンプトのおかげで、AIエージェントはBright Data CLIを自律的に使用して、ウェブアクセスを必要とする複雑なタスクを実行できるようになりました。

CLI vs MCP vs Agent Skills：AIエージェントに適したアプローチの選択

Bright Data CLIに加えて、エージェントはBright Data Web MCPまたはAgent Skillsを通じて同じ機能にアクセスすることもできます。これにより重要な疑問が生じます：どのアプローチを選択すべきか？

答えはワークフロー、アーキテクチャ、必要なコントロールのレベルによって異なります。CLI、MCP、Agent Skillsはそれぞれ異なる問題を解決し、AIスタックの異なる層で動作します。

以下の表で3つの方法を比較します：

これらのアプローチは相互に排他的ではないことを覚えておいてください。実際、組み合わせて使用することで最大の効果を発揮します。

詳しくは、一部のBright DataスキルがBright Data Web MCPツールまたはBright Data CLIコマンドをいつどのように使用するかについての知識を提供しています。これにより、エージェントは実行機能と適切なワークフローを選択するために必要なコンテキストの両方を得ることができます。

人気のAIソリューションをBright Data CLI、Web MCP、および/またはAgent Skillsと統合する方法については、ブログまたは公式ドキュメントをご覧ください。

まとめ

このブログ記事では、AIエージェントがウェブを探索できることのメリットと、CLIツールが他の統合方法よりも優れている理由を理解しました。具体的には、Bright Data CLIが何であり、ウェブスクレイピング、検索、ディスカバリー、自動化タスクをどのようにサポートするかを確認しました。

マシンにBright Data CLIをインストールし、ウェブアクセスを必要とするタスクにお気に入りのAIエージェントを使用するよう指示する方法を学びました。これにより幅広いユースケースとシナリオが開かれ、Bright DataがAI統合をサポートする多くの方法の一つを表しています。

今すぐ無料アカウントを作成して、無料枠（月5,000リクエスト）を活用してBright Data CLIをお試しください！

FAQ

Bright Data CLIには無料プランがありますか？

はい、Bright Data CLIには無料枠があります。新しいBright Dataアカウントには、サポートされている製品全体で共有される月5,000の無料クレジットが付与されます。これにはWeb Unlocker API、SERP API、Web Scraper API、Scraper Studioも含まれます。始めるためにクレジットカードやコミットメントは必要ありません。

どのAIエージェントがBright Data CLIに接続できますか？

シェルアクセスを持つ任意のAIエージェントがBright Data CLIに接続できます。Claude Code、Codex CLI、Gemini CLI、OpenCodeなどのCLIエージェント、およびターミナルへのアクセスを持つデスクトップエージェントやAIアシスタントが含まれます。

AIエージェントでMCPやAgent SkillsよりもBright Data CLIを使用するメリットは何ですか？

Bright Data CLIは、AIエージェントに使い慣れたシェルコマンドを通じてウェブツールにアクセスする軽量で柔軟な方法を提供します。MCPよりもコンテキストのオーバーヘッドが少なく、LLMの既存のシェル知識を活用します。3つのアプローチは相補的であり、最大の柔軟性のために組み合わせて使用できることを覚えておいてください。