Skip to main content
Firecrawl Docs

ElevenAgents

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

ElevenAgents の音声エージェントとチャットエージェントに、Firecrawl を使って Web へのリアルタイムアクセスを提供します。このガイドでは、2 つのインテグレーション識別子方法を紹介します。

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

前提条件#

オプション 1: Firecrawl MCP Server#

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

MCP サーバーを追加する#

  1. ElevenLabs で Integrations page を開き、+ Add integration をクリックします。
  2. インテグレーション識別子ライブラリから Custom MCP Server を選択します。
  3. 次のフィールドを入力します。
フィールド値
NameFirecrawl
DescriptionFirecrawl で Web コンテンツを検索、スクレイピング、解析します。
Server typeStreamable HTTP
Server URLhttps://mcp.firecrawl.dev/v2/mcp

キー不要の MCP では、共有制限のもとで Search、Scrape、Parse のみを利用できます。より広範なツールセットを使用するには、サインイン または API キーを追加 してください。API キーは URL には含めず、環境変数またはシークレットストアに保管してください。

Note

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

  1. Tool Approval Mode で、承認レベルを選択します。

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

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

ElevenLabs がキー不要のサーバーに接続し、Search、Scrape、Parse を一覧表示します。

エージェントに紐付ける#

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

システムプロンプトを更新する#

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

試してみる#

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

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

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

オプション 2: サーバー webhook ツール#

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

スクレイピングツール#

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

  1. エージェントを開き、Tools タブに移動します。
  2. Add tool をクリックし、Webhook を選択します。
  3. ツールを設定します。
フィールド値
Namescrape_website
DescriptionURL からコンテンツをスクレイピングし、整形された Markdown として返します。
MethodPOST
URLhttps://api.firecrawl.dev/v2/scrape
Note

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

  1. Headers セクションまでスクロールし、認証用に Add header をクリックします。
ヘッダー値
AuthorizationBearer YOUR_FIRECRAWL_API_KEY

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

  1. body parameter を追加します。
パラメータ型説明必須
urlstringスクレイピング対象の URLはい
  1. Add tool をクリックします。

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

検索ツール#

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

  1. もう一度 Add tool → Webhook をクリックし、次のように設定します。
フィールド値
名前search_web
説明クエリに対してウェブを検索し、ページコンテンツを含む関連結果を返します。
メソッドPOST
URLhttps://api.firecrawl.dev/v2/search

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

  2. body parameters を追加します。

パラメータ型説明必須
querystring検索クエリはい
limitnumber返す結果の最大数 (デフォルトは 5)いいえ
  1. Add tool をクリックします。

システムプロンプトを更新する#

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

試してみる#

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

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

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

ヒント#

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

参考資料#

MastraFirecrawl と AI SDK で作る AI リサーチアシスタント