> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# ElevenAgents

> Firecrawl を使って、ElevenLabs の音声エージェントとチャットエージェントに Web へのリアルタイムアクセスを提供

[ElevenAgents](https://elevenlabs.io/agents) の音声エージェントとチャットエージェントに、Firecrawl を使って Web をリアルタイムでスクレイピング、検索、クロールできる機能を追加します。このガイドでは、2 つの統合方法を紹介します。

1. **MCP サーバー** — コード不要でセットアップできる、ホスト版 Firecrawl MCP サーバー に接続します。
2. **サーバー webhook ツール** — リクエストを完全に制御できるよう、カスタムツールから Firecrawl の REST API を呼び出します。

<div id="prerequisites">
  ## 前提条件
</div>

* ElevenAgents にアクセスできる [ElevenLabs](https://elevenlabs.io) のアカウント
* [firecrawl.dev ダッシュボード](https://firecrawl.dev) で取得した Firecrawl API キー

<div id="option-1-firecrawl-mcp-server">
  ## オプション 1: Firecrawl MCP Server
</div>

エージェントにWebアクセスを持たせる最も手早い方法です。ElevenAgents はリモート MCP サーバーに対応しており、Firecrawl はホスト型の MCP エンドポイントを提供しています。

<div id="add-the-mcp-server">
  ### MCP サーバーを追加する
</div>

1. ElevenLabs で [Integrations page](https://elevenlabs.io/app/agents/integrations) を開き、**+ Add integration** をクリックします。
2. 統合ライブラリから **Custom MCP Server** を選択します。
3. 次のフィールドを入力します。

| フィールド           | 値                                                         |
| --------------- | --------------------------------------------------------- |
| **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 キーが含まれているため、機密情報として扱ってください。

<Note>
  サーバータイプには必ず **Streamable HTTP** を選択してください。デフォルトの SSE オプションは Firecrawl MCP エンドポイントでは動作しません。
</Note>

4. **Tool Approval Mode** で、承認レベルを選択します。
   * **No Approval** — エージェントはツールを自由に使用します。読み取り専用のスクレイピングに適しています。
   * **Fine-Grained Tool Approval** — 自動実行できるツールと承認が必要なツールを事前に選べます。コストの高いクロール オペレーションを制御するのに適しています。
   * **Always Ask** (default) — ツールを呼び出すたびに、エージェントが許可を求めます。

5. **I trust this server** をチェックして、**Add Server** をクリックします。

ElevenLabs がサーバーに接続し、利用可能なツール (scrape、search、crawl、map など) を一覧表示します。

<div id="attach-it-to-an-agent">
  ### エージェントに紐付ける
</div>

1. [ElevenAgentsダッシュボード](https://elevenlabs.io/app/agents/agents)でエージェントを作成するか、既存のエージェントを開きます。
2. **Tools** タブを開き、**MCP** サブタブを選択します。
3. **Add server** をクリックし、ドロップダウンから **Firecrawl** 連携を選択します。

<div id="update-the-system-prompt">
  ### システムプロンプトを更新する
</div>

**Agent** タブで、エージェントが Firecrawl をいつ使うべきか判断できるよう、**System prompt** に指示を追加します。たとえば次のようにします。

```text theme={null}
あなたは優秀なリサーチアシスタントです。ユーザーが Web サイトや企業、または最新情報が必要なトピックについて質問した場合は、Firecrawl ツールを使用して Web を検索するか関連ページをスクレイピングし、結果を要約してください。
```

<div id="test-it">
  ### 試してみる
</div>

上部のナビゲーションバーにある **Preview** をクリックします。テキストチャットの入力欄を使うか、音声通話を開始してテストできます。次のようなプロンプトを試してください。

> 「firecrawl.dev はどんなことをするサイトですか？サイトにアクセスして要約してください。」

エージェントは Firecrawl MCP の `scrape` ツールを呼び出し、ページのマークダウンを受け取って要約を返します。

***

<div id="option-2-server-webhook-tool">
  ## オプション 2: サーバー webhook ツール
</div>

リクエストパラメータ (フォーマット、ヘッダー、タイムアウトなど) を細かく制御する必要がある場合や、MCP ツールセット全体を公開せずに特定の Firecrawl エンドポイントを呼び出したい場合は、この方法を使います。

<div id="scrape-tool">
  ### スクレイピングツール
</div>

単一の URL をスクレイピングし、そのコンテンツを Markdown として返すツールを作成します。

1. エージェントを開き、**Tools** タブに移動します。
2. **Add tool** をクリックし、**Webhook** を選択します。
3. ツールを設定します。

| フィールド           | 値                                            |
| --------------- | -------------------------------------------- |
| **Name**        | scrape\_website                              |
| **Description** | URL からコンテンツをスクレイピングし、整形された Markdown として返します。 |
| **Method**      | POST                                         |
| **URL**         | `https://api.firecrawl.dev/v2/scrape`        |

<Note>
  **Method** フィールドのデフォルト値は GET なので、必ず **POST** に変更してください。
</Note>

4. **Headers** セクションまでスクロールし、認証用に **Add header** をクリックします。

| ヘッダー            | 値                               |
| --------------- | ------------------------------- |
| `Authorization` | `Bearer YOUR_FIRECRAWL_API_KEY` |

または、ワークスペースの認証接続が設定されている場合は、代わりに **Authentication** ドロップダウンを使用できます。

5. **body parameter** を追加します。

| パラメータ | 型      | 説明             | 必須 |
| ----- | ------ | -------------- | -- |
| `url` | string | スクレイピング対象の URL | はい |

6. **Add tool** をクリックします。

Firecrawl API はデフォルトでページのコンテンツを Markdown として返します。エージェントは JSON レスポンスを受け取り、`markdown` フィールドを使って質問に回答できます。

<div id="search-tool">
  ### 検索ツール
</div>

ウェブを検索し、スクレイピングしたコンテンツを含む結果を返すツールを作成します。

1. もう一度 **Add tool** → **Webhook** をクリックし、次のように設定します。

| フィールド    | 値                                     |
| -------- | ------------------------------------- |
| **名前**   | search\_web                           |
| **説明**   | クエリに対してウェブを検索し、ページコンテンツを含む関連結果を返します。  |
| **メソッド** | POST                                  |
| **URL**  | `https://api.firecrawl.dev/v2/search` |

2. 上記と同じ `Authorization` ヘッダーを追加します。

3. **body parameters** を追加します。

| パラメータ   | 型      | 説明                  | 必須  |
| ------- | ------ | ------------------- | --- |
| `query` | string | 検索クエリ               | はい  |
| `limit` | number | 返す結果の最大数 (デフォルトは 5) | いいえ |

4. **Add tool** をクリックします。

<div id="update-the-system-prompt">
  ### システムプロンプトを更新する
</div>

**Agent** タブで、**System prompt** を更新します。

```text theme={null}
あなたはWebツールにアクセスできる知識豊富なアシスタントです。

- ユーザーが特定のURLを指定して読み取りを求めた場合は `scrape_website` を使用してください。
- ユーザーがオンラインでの情報検索を必要とする一般的な質問をした場合は `search_web` を使用してください。

常に情報を簡潔にまとめ、参照元のURLを明記してください。
```

<div id="test-it">
  ### 試してみる
</div>

**Preview** をクリックして、次のように質問してみてください。

> 「Next.js の最新機能を検索して、要約してください。」

エージェントは `search_web` を呼び出し、Firecrawl から結果を受け取り、その内容を要約して返します。

***

<div id="tips">
  ## ヒント
</div>

* **モデルの選択** — 信頼性の高いツール呼び出しを行うには、GPT-4o、Claude Sonnet 4.5 以降、Gemini 2.5 Flash などの高性能なモデルを使用してください。小規模なモデルでは、正しいパラメータを抽出するのが難しい場合があります。
* **プロンプトは具体的に保つ** — 各ツールをいつ使うかをエージェントに明確に伝えてください。あいまいな指示は、ツール呼び出しの漏れや誤りにつながります。
* **レスポンスのサイズを制限する** — 音声エージェントでは、スクレイピングしたページが長いと LLM のコンテキストを圧迫することがあります。レスポンスを簡潔に保つため、スクレイピングのオプションで `onlyMainContent: true` を使用するか (またはエージェントに積極的に要約するよう指示してください) 。
* **ツール呼び出し音** — webhook または MCP のツール設定では、ツールの実行中に環境音を再生する **Tool call sound** を設定できます。これにより、エージェントが処理中であることをユーザーに知らせられます。

<div id="resources">
  ## 参考資料
</div>

* [ElevenAgents ドキュメント](https://elevenlabs.io/docs/eleven-agents/overview)
* [ElevenAgents ツール概要](https://elevenlabs.io/docs/eleven-agents/customization/tools)
* [ElevenAgents MCP 統合](https://elevenlabs.io/docs/eleven-agents/customization/tools/mcp)
* [Firecrawl API リファレンス](https://docs.firecrawl.dev/api-reference/v2-introduction)
* [Firecrawl MCP サーバー](https://docs.firecrawl.dev/mcp-server)