ElevenAgents の音声エージェントとチャットエージェントに、Firecrawl を使って Web をリアルタイムでスクレイピング、検索、クロールできる機能を追加します。このガイドでは、2 つの統合方法を紹介します。
- MCP サーバー — コード不要でセットアップできる、ホスト版 Firecrawl MCP サーバー に接続します。
- サーバー webhook ツール — リクエストを完全に制御できるよう、カスタムツールから Firecrawl の REST API を呼び出します。
オプション 1: Firecrawl MCP Server
エージェントにWebアクセスを持たせる最も手早い方法です。ElevenAgents はリモート MCP サーバーに対応しており、Firecrawl はホスト型の MCP エンドポイントを提供しています。
- ElevenLabs で Integrations page を開き、+ Add integration をクリックします。
- 統合ライブラリから Custom MCP Server を選択します。
- 次のフィールドを入力します。
| フィールド | 値 |
|---|
| Name | Firecrawl |
| Description | あらゆる Web サイトのコンテンツを検索、スクレイピング、クロール、抽出します。 |
| Server type | Streamable HTTP |
| Server URL | https://mcp.firecrawl.dev/YOUR_FIRECRAWL_API_KEY/v2/mcp |
YOUR_FIRECRAWL_API_KEY は実際の API キーに置き換えてください。Type ドロップダウンは Value のままにします。この URL には API キーが含まれているため、機密情報として扱ってください。
サーバータイプには必ず Streamable HTTP を選択してください。デフォルトの SSE オプションは Firecrawl MCP エンドポイントでは動作しません。
-
Tool Approval Mode で、承認レベルを選択します。
- No Approval — エージェントはツールを自由に使用します。読み取り専用のスクレイピングに適しています。
- Fine-Grained Tool Approval — 自動実行できるツールと承認が必要なツールを事前に選べます。コストの高いクロール オペレーションを制御するのに適しています。
- Always Ask (default) — ツールを呼び出すたびに、エージェントが許可を求めます。
-
I trust this server をチェックして、Add Server をクリックします。
ElevenLabs がサーバーに接続し、利用可能なツール (scrape、search、crawl、map など) を一覧表示します。
- ElevenAgentsダッシュボードでエージェントを作成するか、既存のエージェントを開きます。
- Tools タブを開き、MCP サブタブを選択します。
- Add server をクリックし、ドロップダウンから Firecrawl 連携を選択します。
Agent タブで、エージェントが Firecrawl をいつ使うべきか判断できるよう、System prompt に指示を追加します。たとえば次のようにします。
あなたは優秀なリサーチアシスタントです。ユーザーが Web サイトや企業、または最新情報が必要なトピックについて質問した場合は、Firecrawl ツールを使用して Web を検索するか関連ページをスクレイピングし、結果を要約してください。
上部のナビゲーションバーにある Preview をクリックします。テキストチャットの入力欄を使うか、音声通話を開始してテストできます。次のようなプロンプトを試してください。
「firecrawl.dev はどんなことをするサイトですか?サイトにアクセスして要約してください。」
エージェントは Firecrawl MCP の scrape ツールを呼び出し、ページのマークダウンを受け取って要約を返します。
リクエストパラメータ (フォーマット、ヘッダー、タイムアウトなど) を細かく制御する必要がある場合や、MCP ツールセット全体を公開せずに特定の Firecrawl エンドポイントを呼び出したい場合は、この方法を使います。
単一の URL をスクレイピングし、そのコンテンツを Markdown として返すツールを作成します。
- エージェントを開き、Tools タブに移動します。
- Add tool をクリックし、Webhook を選択します。
- ツールを設定します。
| フィールド | 値 |
|---|
| Name | scrape_website |
| Description | URL からコンテンツをスクレイピングし、整形された Markdown として返します。 |
| Method | POST |
| URL | https://api.firecrawl.dev/v2/scrape |
Method フィールドのデフォルト値は GET なので、必ず POST に変更してください。
- Headers セクションまでスクロールし、認証用に Add header をクリックします。
| ヘッダー | 値 |
|---|
Authorization | Bearer YOUR_FIRECRAWL_API_KEY |
または、ワークスペースの認証接続が設定されている場合は、代わりに Authentication ドロップダウンを使用できます。
- body parameter を追加します。
| パラメータ | 型 | 説明 | 必須 |
|---|
url | string | スクレイピング対象の URL | はい |
- Add tool をクリックします。
Firecrawl API はデフォルトでページのコンテンツを Markdown として返します。エージェントは JSON レスポンスを受け取り、markdown フィールドを使って質問に回答できます。
ウェブを検索し、スクレイピングしたコンテンツを含む結果を返すツールを作成します。
- もう一度 Add tool → Webhook をクリックし、次のように設定します。
| フィールド | 値 |
|---|
| 名前 | search_web |
| 説明 | クエリに対してウェブを検索し、ページコンテンツを含む関連結果を返します。 |
| メソッド | POST |
| URL | https://api.firecrawl.dev/v2/search |
-
上記と同じ
Authorization ヘッダーを追加します。
-
body parameters を追加します。
| パラメータ | 型 | 説明 | 必須 |
|---|
query | string | 検索クエリ | はい |
limit | number | 返す結果の最大数 (デフォルトは 5) | いいえ |
- Add tool をクリックします。
Agent タブで、System prompt を更新します。
あなたはWebツールにアクセスできる知識豊富なアシスタントです。
- ユーザーが特定のURLを指定して読み取りを求めた場合は `scrape_website` を使用してください。
- ユーザーがオンラインでの情報検索を必要とする一般的な質問をした場合は `search_web` を使用してください。
常に情報を簡潔にまとめ、参照元のURLを明記してください。
Preview をクリックして、次のように質問してみてください。
「Next.js の最新機能を検索して、要約してください。」
エージェントは search_web を呼び出し、Firecrawl から結果を受け取り、その内容を要約して返します。
- モデルの選択 — 信頼性の高いツール呼び出しを行うには、GPT-4o、Claude Sonnet 4.5 以降、Gemini 2.5 Flash などの高性能なモデルを使用してください。小規模なモデルでは、正しいパラメータを抽出するのが難しい場合があります。
- プロンプトは具体的に保つ — 各ツールをいつ使うかをエージェントに明確に伝えてください。あいまいな指示は、ツール呼び出しの漏れや誤りにつながります。
- レスポンスのサイズを制限する — 音声エージェントでは、スクレイピングしたページが長いと LLM のコンテキストを圧迫することがあります。レスポンスを簡潔に保つため、スクレイピングのオプションで
onlyMainContent: true を使用するか (またはエージェントに積極的に要約するよう指示してください) 。
- ツール呼び出し音 — webhook または MCP のツール設定では、ツールの実行中に環境音を再生する Tool call sound を設定できます。これにより、エージェントが処理中であることをユーザーに知らせられます。