Agent Development Kit（ADK）

Model Context Protocol (MCP) 経由で Google の Agent Development Kit (ADK) を Firecrawl に接続すると、エージェントがウェブの検索、スクレイピング、クロール、マップを行い、クリーンなコンテキストを取得できるようになります。

概要

Firecrawl は MCP サーバーを提供しており、Google の ADK とシームレスに統合して、エージェントがあらゆるウェブサイトから効率的にスクレイピング、クロール、構造化データの抽出を行えるようにします。この統合は、パフォーマンス最適化のためにストリーミング対応の HTTP を備えた、クラウド版およびセルフホスト版の Firecrawl インスタンスの両方をサポートします。

機能

あらゆるウェブサイトに対する効率的なスクレイピング、クロール、コンテンツ発見
高度な検索機能と賢いコンテンツ抽出
Firecrawl エージェントによる自律的なウェブ調査
ブラウザー操作、ファイル解析、変更監視
柔軟なデプロイ (クラウドまたはセルフホスト)
Streamable HTTPを活用するモダンなウェブ環境向けに最適化

前提条件

firecrawl.dev で Firecrawl の API キーを取得する
MCP 対応の Google ADK をインストールする: pip install "google-adk[mcp]"

セットアップ

import os

from google.adk.agents.llm_agent import Agent
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams
from google.adk.tools.mcp_tool.mcp_toolset import MCPToolset

FIRECRAWL_API_KEY = os.environ["FIRECRAWL_API_KEY"]

root_agent = Agent(
    model="gemini-3.8-flash",
    name="firecrawl_agent",
    description='Firecrawl で Web サイトをスクレイピングするのに役立つアシスタント',
    instruction='ユーザーの Web サイトコンテンツの検索を支援する',
    tools=[
        MCPToolset(
            connection_params=StreamableHTTPConnectionParams(
                url="https://mcp.firecrawl.dev/v2/mcp",
                headers={"Authorization": f"Bearer {FIRECRAWL_API_KEY}"},
            ),
        )
    ],
)

import os

from google.adk.agents.llm_agent import Agent
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
from google.adk.tools.mcp_tool.mcp_toolset import MCPToolset
from mcp import StdioServerParameters

root_agent = Agent(
    model='gemini-3.8-flash',
    name='firecrawl_agent',
    description='Firecrawl で Web サイトをスクレイピングするのに役立つアシスタント',
    instruction='ユーザーの Web サイトコンテンツの検索を支援する',
    tools=[
        MCPToolset(
            connection_params=StdioConnectionParams(
                server_params = StdioServerParameters(
                    command='npx',
                    args=[
                        "-y",
                        "firecrawl-mcp@3.33.2",
                    ],
                    env={
                        "FIRECRAWL_API_KEY": os.environ["FIRECRAWL_API_KEY"],
                    }
                ),
                timeout=30,
            ),
        )
    ],
)

ADK を起動する環境で FIRECRAWL_API_KEY を設定します。その値をエージェントのプロンプト、ソース管理、MCP URL に含めないでください。ローカル MCP パッケージには Node.js 22 以降が必要です。

利用可能なツール

ツール	名称	説明
スクレイピングツール	`firecrawl_scrape`	単一のURLからコンテンツをスクレイピングするか、JSON形式で構造化データを抽出します
マップツール	`firecrawl_map`	Web サイト内のインデックス済みURLを網羅的に把握するためにサイト構造をマッピングします
検索ツール	`firecrawl_search`	ウェブを検索し、必要に応じて検索結果からコンテンツを抽出します
クロールツール	`firecrawl_crawl`	サイトまたは特定のセクションをクロールし、そのページを返します
クロールステータスの確認	`firecrawl_check_crawl_status`	クロールジョブのステータスを確認します
解析ツール	`firecrawl_parse`	PDF、ドキュメント、スプレッドシート、HTML ファイルからコンテンツを抽出します
エージェントツール	`firecrawl_agent`, `firecrawl_agent_status`	複数のソースを横断して自律的に調査を実行し、job のステータスを確認します
Interact ツール	`firecrawl_interact`, `firecrawl_interact_stop`	ライブページ上でクリック、フォーム入力、ページ遷移を行い、完了後にセッションを解放します
モニターツール	`firecrawl_monitor_*`	webhook またはメールで通知する定期チェックを作成・実行します

全一覧は MCP ツールを参照してください。

構成

認証

FIRECRAWL_API_KEY: Firecrawl の API キー

クラウド API (デフォルト) では任意：キーがなくても、スクレイピングと検索は無料枠の範囲内でキーなしで実行できます。その他のツールを使う場合や上限を引き上げる場合はキーが必要です
FIRECRAWL_API_URL を指定したセルフホスト環境を使用する場合は任意

任意の構成

Firecrawl API URL (セルフホスト環境向け) :

FIRECRAWL_API_URL: カスタム API エンドポイント
例: https://firecrawl.your-domain.com
指定がない場合はクラウド API を使用します

例：Web Research Agent

import asyncio
import os

from google.adk.agents.llm_agent import Agent
from google.adk.runners import InMemoryRunner
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams
from google.adk.tools.mcp_tool.mcp_toolset import MCPToolset

FIRECRAWL_API_KEY = os.environ["FIRECRAWL_API_KEY"]

# リサーチエージェントを作成
research_agent = Agent(
    model="gemini-3.8-flash",
    name="research_agent",
    description='An AI agent that researches topics by scraping and analyzing web content',
    instruction='''You are a research assistant. When given a topic or question:
    1. Use the search tool to find relevant websites
    2. Scrape the most relevant pages for detailed information
    3. Extract structured data when needed
    4. Provide comprehensive, well-sourced answers''',
    tools=[
        MCPToolset(
            connection_params=StreamableHTTPConnectionParams(
                url="https://mcp.firecrawl.dev/v2/mcp",
                headers={"Authorization": f"Bearer {FIRECRAWL_API_KEY}"},
            ),
        )
    ],
)

# エージェントを実行し、応答を出力
async def main():
    runner = InMemoryRunner(agent=research_agent)
    await runner.run_debug("What are the latest features in Python 3.13?")
    await runner.close()

asyncio.run(main())

ベストプラクティス

用途に合ったツールを使う:
- まず関連ページを見つける必要がある場合は firecrawl_search
- 単一ページには firecrawl_scrape
- サイト全体の探索とスクレイピングには firecrawl_crawl
- 既知のURLの短いリストがある場合は firecrawl_scrape を繰り返し呼び出す
利用状況を監視する: Firecrawl ダッシュボードと API レスポンスを使って、クレジット使用量を追跡する
エラーを適切に処理する: MCP/API エラーをユーザーに表示し、エージェントのワークフローで安全に行える場合にのみリトライする
パフォーマンスを最適化する: エージェントが関連URLを見つける必要がある場合は、スクレイピングの前に firecrawl_map を使用する

Google Agent Development Kit（ADK）と Firecrawl を用いた AI エージェント構築の完全ガイド

Google の ADK フレームワークと Firecrawl を組み合わせ、Web スクレイピング機能を備えた強力なマルチエージェント AI システムの構築方法を学べます。

MCP サーバードキュメント

Firecrawl の Model Context Protocol (MCP) サーバーとの統合および機能について詳しく学べます。

Google ADK 公式ドキュメント

包括的なガイドと API リファレンスは、Google Agent Development Kit の公式ドキュメントをご覧ください。

はじめに

主要エンドポイント

その他

クイックスタート

開発者ガイド

webhook

ユースケース

その他

貢献

Agent Development Kit（ADK）

概要

機能

前提条件

セットアップ

利用可能なツール

構成

認証

任意の構成

例：Web Research Agent

ベストプラクティス

Google Agent Development Kit（ADK）と Firecrawl を用いた AI エージェント構築の完全ガイド

MCP サーバードキュメント

Google ADK 公式ドキュメント

​概要

​機能

​前提条件

​セットアップ

​利用可能なツール

​構成

​認証

​任意の構成

​例：Web Research Agent

​ベストプラクティス

​関連リソース

Google Agent Development Kit（ADK）と Firecrawl を用いた AI エージェント構築の完全ガイド

MCP サーバー ドキュメント

Google ADK 公式ドキュメント

概要

機能

前提条件

セットアップ

利用可能なツール

構成

認証

任意の構成

例：Web Research Agent

ベストプラクティス

関連リソース

MCP サーバードキュメント