Agent Development Kit（ADK）

Model Context Protocol（MCP）経由で Firecrawl を Google の Agent Development Kit（ADK）と統合し、ウェブスクレイピング機能を備えた強力な AI エージェントを構築します。

概要

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

機能

あらゆるウェブサイトに対する効率的なスクレイピング、クロール、コンテンツ発見
高度な検索機能と賢いコンテンツ抽出
深掘り調査
柔軟なデプロイ (クラウドまたはセルフホスト)
Streamable HTTPを活用するモダンなウェブ環境向けに最適化

前提条件

firecrawl.dev で Firecrawl の API キーを取得する
Google ADK をインストールする

セットアップ

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

FIRECRAWL_API_KEY = "YOUR-API-KEY"

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

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-2.5-pro',
    name='firecrawl_agent',
    description='Firecrawl でウェブサイトをスクレイピングするのに役立つアシスタント',
    instruction='ユーザーのウェブサイトコンテンツの検索を支援する',
    tools=[
        MCPToolset(
            connection_params=StdioConnectionParams(
                server_params = StdioServerParameters(
                    command='npx',
                    args=[
                        "-y",
                        "firecrawl-mcp",
                    ],
                    env={
                        "FIRECRAWL_API_KEY": "YOUR-API-KEY",
                    }
                ),
                timeout=30,
            ),
        )
    ],
)

利用可能なツール

ツール	名称	説明
スクレイプツール	`firecrawl_scrape`	高度なオプションで単一のURLからコンテンツをスクレイピングします
マップツール	`firecrawl_map`	サイト内のインデックス済みURLを網羅的に把握するためにサイト構造をマッピングします
検索ツール	`firecrawl_search`	ウェブを検索し、必要に応じて検索結果からコンテンツを抽出します
クローラーツール	`firecrawl_crawl`	高度なオプションで非同期クローリングを開始します
クローラーステータスの確認	`firecrawl_check_crawl_status`	クローリングジョブのステータスを確認します
抽出ツール	`firecrawl_extract`	LLMを用いてウェブページから構造化された情報を抽出します

構成

必須設定

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

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

FIRECRAWL_API_KEY = "YOUR-API-KEY"

# リサーチエージェントを作成
research_agent = Agent(
    model="gemini-2.5-pro",
    name="research_agent",
    description='Webコンテンツをスクレイピング・分析してトピックを調査するAIエージェント',
    instruction='''あなたはリサーチアシスタントです。トピックや質問が与えられた場合:
    1. 検索ツールを使用して関連するWebサイトを検索
    2. 最も関連性の高いページをスクレイピングして詳細情報を取得
    3. 必要に応じて構造化データを抽出
    4. 包括的で出典が明確な回答を提供''',
    tools=[
        MCPToolset(
            connection_params=StreamableHTTPServerParams(
                url=f"https://mcp.firecrawl.dev/{FIRECRAWL_API_KEY}/v2/mcp",
            ),
        )
    ],
)

# エージェントを使用
response = research_agent.run("Python 3.13の最新機能は何ですか?")
print(response)

ベストプラクティス

用途に合ったツールを使う:
- まず関連ページを見つける必要がある場合は 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 の公式ドキュメントをご覧ください。

​概要

​機能

​前提条件

​セットアップ

​利用可能なツール

​構成

​必須設定

​任意の構成

​例：Web Research Agent

​ベストプラクティス

​関連リソース