このチュートリアルでは、以下の内容を学びます:
- AstrBotとは何か、またオープンソースのAIエージェントプラットフォームとして何を提供するか。
- ライブウェブアクセスを追加することで、AstrBotが現実のタスクに対してより効果的になる理由。
- Bright DataがAstrBotにエンタープライズグレードのウェブ検索、スクレイピング、ディスカバリー、ブラウザ自動化ツールを提供する方法。
- Bright Data Web MCPをAstrBotに統合する方法。
- Bright Dataスキルを使ってAstrBotにBright Data製品の専門知識を付与する方法。
- AstrBotとWeb MCPおよびBright Dataスキルを組み合わせた結果。
さっそく始めましょう!
AstrBotとは?

AstrBotは、オープンソースのクロスプラットフォームAIエージェントフレームワークです。Telegram、Slack、Discord、WeChatなどの人気チャットアプリケーションに、LLMを活用したアシスタントを直接組み込むことができます。
エージェントワークフロー、ツール呼び出し、MCP、スキル、ナレッジベースをサポートすることで、従来のチャットボットを超えた機能を提供します。自動化、カスタマーサポート、エンタープライズナレッジ管理、パーソナルAIアシスタント向けのプラグイン拡張も備えています。
AstrBotはGitHubで36.5k以上のスターを獲得しており、1,000以上のコミュニティプラグインと、週間アクティブユーザー200k以上を誇ります。
主な機能
AstrBotがサポートする主な機能:
- マルチプラットフォーム対応:Telegram、Slack、Discord、QQ、WeChat、Lark、DingTalk、その他多数のメッセージングプラットフォームからエージェントとチャットできます。
- ネイティブMCPサポート:Model Context Protocolを通じて外部ツールやサービスを統合できます。
- スキル統合:専門的な機能とワークフローを提供する再利用可能なスキルでエージェントを拡張できます。
- 1,000以上のプラグインエコシステム:コミュニティが管理する豊富なプラグインマーケットプレイスを通じて新機能や統合を追加できます。
- ナレッジベース:PDF、DOCXファイル、Markdownなどのドキュメントを使って質問に答えるAIアシスタントを構築できます。
- マルチプロバイダーLLMサポート:OpenAI、Anthropic、Google Gemini、Ollama、その他多数のOpenAI互換プロバイダーに対応しています。
- エージェントサンドボックス:隔離されたランタイム環境でコードやシェルコマンドを安全に実行できます。
- 強力なWebUI:集中管理インターフェースからモデル、プラグイン、MCPサーバー、ログ、デバッグを設定できます。
- 柔軟なデプロイ:
uv、Docker、デスクトップアプリ、ランチャー、クラウド環境でデプロイできます。 - ワークフロー自動化:タスクのスケジューリング、ツールのオーケストレーション、現実のワークフロー向け自律型AIエージェントの構築が可能です。
詳細は公式ドキュメントをご覧ください。
AstrBotにウェブアクセスが必要な理由
AstrBotは高度な機能を備えた優れたAIフレームワークですが、LLMを活用するすべてのアプリケーションと同様に、以下の根本的な制限を抱えています:
- 古くなった知識:LLMは特定の時点で終わる静的データセットで学習されています。
- ウェブへのアクセスが限定的:単独ではウェブページと確実にインタラクションできません。
AstrBotは組み込みのウェブ検索ツールでこの課題の一部を解決しようとしています。しかし、このツールは大規模な利用や、CAPTCHA、レート制限、フィンガープリンティングなどのアンチボット技術で保護されたウェブサイトへのアクセスには苦労することがあります。
ここでBright Dataの出番です。AstrBotをBright Dataソリューションに接続することで、エージェントはライブウェブ検索、データ抽出、ウェブサイトディスカバリー、ブラウザ自動化、データセット取得のためのエンタープライズグレードのツールにアクセスできるようになります。
Bright Dataが際立っているのは、4億以上のレジデンシャルIPを活用したグローバルなウェブデータインフラにあります。このアーキテクチャは、無制限の同時接続、99.99%のSLA保証アップタイム、99.95%のリクエスト成功率を実現し、本番ワークロードに必要なスケーラビリティと信頼性を提供します。
Bright DataがAstrBotにウェブ検索、スクレイピング、ディスカバリー、インタラクション機能を提供する方法
Bright DataはAstrBotに2つの統合方法で接続できます:
- Bright Data Web MCP:ウェブ検索、スクレイピング、構造化データ抽出、ブラウザ自動化のための70以上のツールを公開するMCPサーバー。
- Bright Dataスキル:AstrBotにBright Data製品、推奨ワークフロー、ベストプラクティスに関する専門知識を提供するエージェントスキルのコレクション。これらのスキルのほとんどはBright Data CLIに依存しています。
注意:この2つのアプローチは補完的です。例えば、特定のBright DataスキルはAstrBotがWeb MCPツールをいつ、どのように効果的に使用するかを理解するのに役立ちます。
Web MCPとBright Dataスキルを組み合わせることで、AstrBotはより高度なAIエージェントに変わります。これらにより、リアルタイムのウェブリサーチ、ブラウザ自動化、構造化データ抽出を実行できるようになります。
Bright Data Web MCP
Bright Data Web MCPは、Bright Data APIを活用した大規模なツールセットをAstrBotに提供します。
Rapidモード(月5,000リクエスト無料の無料ティア)では、AstrBotはウェブリサーチとデータ抽出のための基本ツールを利用できます。以下が含まれます:
| ツール | 説明 |
|---|---|
search_engine(並列検索にはsearch_engine_batch) |
Google、Bing、Yandexなどから構造化された検索結果を取得します。 |
scrape_as_markdown(並列スクレイピングにはscrape_batch) |
アンチボット保護を自動的に処理しながら、ウェブページからクリーンなMarkdownを抽出します。 |
discover |
関連性ランキングとインテントベースのフィルタリングを使ったAI駆動のウェブディスカバリーを実行します。 |
Proモードを有効にすると、AstrBotはLinkedIn、Amazon、Instagram、Walmart、YouTube、Google Maps、Zillow、TikTok、その他40以上のプラットフォームから構造化データを抽出するツールにアクセスできます。また、Bright DataのBrowser APIを活用した複数のブラウザ自動化ツールも利用可能になります。
Bright Dataスキル
Bright Dataスキルは、専門的な知識とワークフローでAstrBotを拡張します。エージェントが適切なBright Dataサービスを選択し、推奨ベストプラクティスに従うのを助けます。
利用可能なスキルの一部を以下に示します:
| スキル | 説明 |
|---|---|
agent-onboarding |
新しいエージェントのBright Dataセットアップをガイドし、MCP、CLI、API、認証ワークフローを推奨します。 |
search |
Googleのライブ検索を実行し、構造化された検索結果を返します。 |
scrape |
自動アンチボット処理でクリーンなウェブページコンテンツを抽出する方法を説明します。 |
scraper-builder |
ウェブサイトを分析して抽出ロジックを生成することで、本番対応のスクレイパーの構築を支援します。 |
scraper-studio |
Bright Data CLIを通じてAI生成のスクレイパーを作成・実行します。 |
brightdata-cli |
スクレイピング、検索、データセット、プロキシ、アカウント管理のためのBright Data CLIの使い方をエージェントに教えます。 |
bright-data-mcp |
70以上のWeb MCPツールのオーケストレーションに関するガイダンスを提供します。 |
brightdata-proxy |
Python、Node.js、Playwright、Puppeteer、Selenium、その他の環境向けのプロキシ統合コードを生成します。 |
seo-audit |
ライブウェブサイトデータと検索シグナルを使ってSEO分析を実行します。 |
competitive-intel |
競合監視、価格分析、レビュートラッキング、市場調査をサポートします。 |
price-comparison |
主要なオンラインリテーラー間で製品の価格と在庫状況を比較します。 |
live-research |
ウェブディスカバリー、抽出、AI要約を組み合わせてリサーチレポートを作成します。 |
brand-listening |
複数のソースにわたるブランドの言及、センチメント、オンラインディスカッションを分析します。 |
rag-pipeline |
ライブウェブデータを使った検索拡張生成(RAG)パイプラインの構築を支援します。 |
bright-data-best-practices |
Bright Data APIとウェブデータワークフローのベストプラクティスを推奨します。 |
AstrBotのセットアップ:ステップバイステップガイド
このセクションでは、AstrBotをセットアップしてTelegramに接続する方法を説明します。
注意:以下の手順は、ライブラリがサポートする他のメッセージングプラットフォームにも簡単に適用できます。
前提条件
以下が必要です:
- ローカルマシンに
uvがインストール済みであること。 - AstrBotがサポートするLLMプロバイダーのいずれかからのAPIキー。ここではOpenAI APIキーを使用します。
- AstrBotに接続するためのボットが用意されたTelegramアカウント。公式ガイドに従ってTelegramボットを作成してボットトークンを取得してください。
ステップ#1:AstrBotのインストールと起動
まず、以下のコマンドを実行してAstrBotをインストールします:
uv tool install astrbot, python 3.12
次に、プロジェクトフォルダに移動してAstrBotのセットアップを初期化します:
astrbot init
現在のディレクトリにAstrBotをインストールするかどうかを確認するプロンプトが表示されます。「Y」を入力して続行します:

セットアップが完了したら、以下のコマンドでAstrBotを起動します:
astrbot run
以下のような出力が表示されるはずです:

AstrBot WebUIがhttp://localhost:6185で利用可能になります。ブラウザでこのURLを開き、ターミナルログに表示された認証情報でログインします:

ログイン後、AstrBot WebUIのダッシュボードにアクセスするための新しいパスワードを設定します。完了です!
ステップ#2:LLM統合の追加
AstrBot WebUIの「ウェルカム」ページで、「AIモデルの設定」セクションの「設定」ボタンをクリックして開始します:

ここではAstrBotをOpenAIに接続します(他のサポートされているLLMプロバイダーでも手順は同様です)。「追加」を選択し、「OpenAI Compatible」オプションを選びます。「openai」設定モーダルが開きます。OpenAI APIキーを対応するフィールドに貼り付けます:

「保存してモデルを取得」をクリックして利用可能なOpenAIモデルを動的に取得します。次に、使用するモデルを選択します。この例ではOpenAI GPT-5.4 Miniを使用します:

最後に「保存」を押して設定を適用し、「ウェルカム」ページに戻ります。AstrBotエージェントはOpenAIのLLMで動作するようになりました。素晴らしい!
ステップ#3:Telegram接続の設定
AstrBot WebUIの「ウェルカム」ページで、「プラットフォームボットの設定」の「設定」ボタンをクリックします。「プラットフォームアダプターの追加」モーダルで「Telegram」を選択し、Telegramボットトークンを対応するフィールドに貼り付けます:

「保存」を押してから、Telegramボット(この例では「AstrBot Agent」という名前)を開きます。以下のテキストを含むメッセージが届くはずです:
Hello, I'm AstrBot!

LLM統合が正しく機能しているか確認するために、以下のようなテストメッセージを送信します:
Hey, how's it going?
以下のような応答が返ってくるはずです:

これはGPT-5.4 MiniによってAstrBot経由で生成されたものです。
セットアップ完了!フレームワークが完全に設定され、Telegramからインタラクションできるようになりました。
AstrBotをBright Data Web MCPに接続する
この章では、AstrBotにBright Data Web MCPをセットアップする方法を学びます。
前提条件
このセクションをスムーズに進めるために、以下を確認してください:
- MCPの仕組みについての基本的な理解。
- Bright Data Web MCPが提供するツールへの習熟。
また、APIキーが設定されたBright Dataアカウントが必要です。Bright Data APIキーの生成については公式ガイドをご覧ください。
ステップ#1:Bright Data Web MCPを理解する
始める前に、AstrBotはリモートMCPサーバーへの接続を推奨していることを念頭に置いてください。そのため、@brightdata/mcpパッケージでローカルのBright Data Web MCPサーバーをセットアップする代わりに、リモートWeb MCPサーバーを統合します。
注意:リモートBright Data Web MCPはエンタープライズスケールのデプロイメント向けに構築されています。他のすべてのBright Dataサービスと同様に、無制限のスケーラビリティと同時接続をサポートしています。
まず、標準のWeb MCP接続URLを理解してください:
https://mcp.brightdata.com/mcp?token=<YOUR_BRIGHT_DATA_API_KEY>&pro=1
<YOUR_BRIGHT_DATA_API_KEY>をBright Data APIキーに置き換えます。tokenパラメータはリクエストを認証し、Bright Dataアカウントに関連付けます。
&pro=1パラメータはオプションです:
&pro=1あり:70以上のツールの完全なカタログと高度な機能にアクセスできます。Bright Dataの標準利用料金が適用されます。&pro=1なし:Rapidモードで利用可能な無料ツールのみ(月最大5,000リクエスト)が使用できます。
公開されるツールをより細かく制御したい場合があります。例えば、特定のツールやツールグループへのアクセスのみを設定したい場合は、Bright DataダッシュボードからカスタムのWeb MCP接続URLを生成できます。
Bright Dataアカウントにサインインして「AI Gateways > MCP」ページに移動します。セットアップウィザードに従ってMCPサーバーを設定し、カスタム接続URLを生成します:

生成された「Streamable HTTP」接続URLをコピーするか、上記のフォーマットを使用して構築してください。次のステップでAstrBotをBright Data Web MCPに接続する際にこのURLを使用します。
ステップ#2:AstrBotにBright Data Web MCP接続を追加する
AstrBotではWebUIから直接MCP接続を設定できます。
新しいMCPサーバーを追加するには、左側の「拡張機能」ドロップダウンを開き、「MCPサーバー」オプションを選択します。「MCP」ページで、右下の「+」ボタンをクリックします:

MCPサーバーに名前を付け(例:「Bright Data Web MCP」)、以下の設定を貼り付けます:
{
"transport": "streamable_http",
"url": "<YOUR_WEB_MCP_CONNECTION_URL>"
}
<YOUR_WEB_MCP_CONNECTION_URL>を先ほど取得したBright Data Web MCP接続URLに置き換えます。

「接続テスト」を押してMCPサーバーが正しく設定されているか確認します。接続が成功すると、AstrBotは確認メッセージと利用可能なツールのリストを表示します:

Proモード(&pro=1)を使用すると、70以上のBright Data Web MCPツールすべてが表示されます。
「保存」をクリックして統合を完了します。./data/mcp_server.json AstrBot設定ファイルには以下が含まれます:
{
"mcpServers": {
"Bright Data Web MCP": {
"active": true,
"transport": "streamable_http",
"url": "<YOUR_WEB_MCP_CONNECTION_URL>"
}
}
}
あるいは、この設定ファイルを手動で編集することで同じ結果を得ることもできます。
保存後、「MCP」ページには新しい「Bright Data Web MCP」エントリが表示され、デフォルトで有効になっているはずです:

素晴らしい!AstrBotはBright Data Web MCPに接続され、ウェブインタラクションツールを呼び出せるようになりました。
このガイドの後半では、Web MCPとBright Dataスキルを組み合わせたAstrBotのセットアップを紹介します。
公式スキルを使ってAstrBotにBright Dataの知識を追加する
以下では、Vercelのskills CLIツールを使ってAstrBotにBright Dataスキルを追加するプロセスをガイドします。
注意:skillsを使用したくない場合は、公式リポジトリからスキルを直接ダウンロードできます。skills/フォルダに移動し、その内容のZIPアーカイブを作成して、AstrBotの「拡張機能 > スキル」ページから手動でアップロードしてください。
前提条件
このセクションを進める前に、以下を確認してください:
- UNIXベースの環境(Linux、macOS、またはWSL)。
- Node.js 22以上がローカルにインストール済みであること。
- Bright Data CLIがローカルにインストールおよび設定済みであること。これはBright Dataスキルを使用するための主要な要件です。クイックセットアップについては「Bright Data CLI:インストールとセットアップ」ガイドを参照してください。詳細については、専用のブログ記事もご覧ください。
- Bright Dataスキルが提供するものについての基本的な理解。詳細については、ブログのBright Dataスキルに関する記事をご覧ください。
Agent Skills標準のskills CLIツールへの慣れも推奨しますが、必須ではありません。
ステップ#1:Bright Dataスキルのインストール
skills CLIツールを使ってAstrBotにBright Dataスキルを追加するには、以下を実行します:
npx skills add brightdata/skills -a astrbot
このコマンドはskills npmパッケージをインストールしてセットアッププロセスを開始します。これにより:
- Agent Skills DirectoryからBright Dataスキルをダウンロードします。
- グローバルまたはローカルプロジェクト内で使用するように設定します。
インストールするスキルを選択するよう求めるプロンプトが表示されます:

利用可能なすべてのスキルをインストールするには、スペースバーで各スキルを選択し、Enterを押して続行します。
次に、インストールスコープを選択します。Web MCP統合はローカルで設定したため、Bright Dataスキルもローカルにインストールする必要があります。「プロジェクト」オプションを選択してEnterを押します:

再度Enterを押してインストールを確認します。完了すると、確認メッセージが表示されます:

Bright DataスキルがAstrBotの./data/skillsディレクトリで利用可能になりました。
ステップ#2:スキルが利用可能であることを確認する
AstrBot WebUIに戻り、「拡張機能 > スキル」ページを開きます:

インストールしたすべてのBright Dataスキルが含まれたリストが表示されます。
注意:スキルが表示されない場合は、ページを更新してみてください。
オプションとして、Bright Data CLIをまだ設定していない場合は、オンボーディングスキルを実行します。Telegramで以下を入力してください:
/agent-onboarding
これにより専用のBright Dataオンボーディングスキルが読み込まれ、他のBright Dataスキルに必要なセットアッププロセスをガイドします。実行するには、AstrBotにシェルコマンドを実行する権限を付与する必要もあります。
完了です!次の章では、AstrBot内でBright Data Web MCPとスキルを一緒に使用する方法を学びます。
AstrBot + Bright Data Web MCPとスキル:完全な例
AstrBotエージェントはウェブとインタラクションするためのエンタープライズ対応ツールと知識を備えました。これにより、ライブウェブデータ、ブラウザ自動化、構造化データ抽出を必要とする幅広い現実のユースケースを処理できるようになります。
例えば、AstrBotをショッピングアシスタントとして使用したいとします。現代のeコマースウェブサイトは高度なアンチボット技術で保護されていることが多く、AIエージェントがインタラクションするのが困難です。詳細については、eコマーススクレイピングのガイドをご覧ください。
Bright Dataを統合することで、AstrBotはウェブ検索、ウェブページとのインタラクション、リクエストを完了するための情報抽出を行いながら、これらの制限を回避できます。
次に、TelegramからAstrBotを使ってZaraウェブサイトで商品を探す場合を想像してみましょう。以下の手順をご覧ください!
ステップ#1:プロンプトを送信する
以下のようなプロンプトから始めます:
Search Google for the Zara men's polo shirts sale page. Visit the page in a browser and return a full-page screenshot.
以下のような応答が返ってくるはずです:

エージェントがタスクをどのように完了したかに注目してください。裏側では:
search_engineツール(Bright DataのSERP APIを利用)を呼び出して「Zara men’s polo shirts sale page」クエリをGoogleで検索しました。- 返されたSERPをJSONで解析して正しいページを特定しました。
scraping_browser_navigateツール(Bright DataのBrowser APIを利用)を使ってクラウドブラウザインスタンスでページを開きました。scraping_browser_screenshotツールでフルページスクリーンショットをキャプチャしました。- スクリーンショットとページURLの両方を返しました。
AstrBot WebUIを開いて「プラットフォーム > プラットフォームログ」に移動すると、エージェントが使用したすべてのWeb MCPツールとBright Dataスキルを確認できます:

スクリーンショットを開いて3番目の商品が気に入り、AstrBotにその情報をすべて取得してほしい場合、以下のようなプロンプトを送信できます:
I like the third product, the Zip Polo Sweatshirt. Get the URL of its product page, then scrape it to extract the main product information. Return the results in a structured text message.
応答は以下のようになるはずです:

裏側では、AstrBotは複数のBright Dataツールを呼び出して商品ページを特定し、その情報を抽出します。ワークフローに応じて、scrape_as_markdownまたはweb_data_zara_products(Bright DataのZara Web Data APIに基づく)などの専門ツールを使用してデータを取得できます。
ステップ#2:出力を分析する
最後のメッセージから返された情報が、公式Zara商品ページで入手可能な情報と一致していることに注目してください:

商品ページはすべての情報を表示するために複数の手動操作が必要な場合があります(例:「商品の寸法」セクションの展開)。それにもかかわらず、AstrBotはBright DataのWeb MCPが公開する専門ツールのおかげで完全な商品詳細を返すことができました。
そこから自然に会話を続けることができます。例えば、AstrBotにその商品が購入する価値があるか尋ねたり、類似の代替品と比較したり、同じ価格帯の他の商品を推薦させたりすることができます。
以上!この簡単な例は、Bright Dataと統合することでAstrBotがいかに強力になるかを示しています。Web MCPとBright Dataスキルがなければ、ライブウェブ検索、ウェブサイトディスカバリー、データ抽出、自動化されたブラウザインタラクションに依存するワークフローを確実に完了することはできないでしょう。
まとめ
このブログ記事では、AstrBotとは何か、そして何を提供するかを学びました。特に、Web MCPとBright Dataスキルを通じてBright Dataを統合することでその機能を拡張する方法を確認しました。
Bright Dataにより、AstrBotはライブウェブリサーチ、スクレイピング、ソースディスカバリーのためのツールを活用できます。これにより、正確で文脈に沿った検証可能な情報に基づいた、より根拠のある応答を生成できるようになります。また、クラウドブラウザインタラクションツールを使用できるため、複雑なウェブワークフローをエージェントに直接委任することができます。
さらに高度なシナリオについては、Bright Dataエコシステムを通じて利用可能なAI対応ウェブデータソリューションの全範囲を探索してください。
今すぐBright Dataに無料登録して、ウェブデータソリューションの探索を始めましょう!