Agent Development Kit (ADK)

Intégrez Firecrawl à l’ADK de Google via le Model Context Protocol (MCP) pour des workflows d’agents avancés

Intégrez Firecrawl à l’Agent Development Kit (ADK) de Google pour créer des agents IA puissants dotés de capacités de web scraping via le Model Context Protocol (MCP).

​

Vue d’ensemble

Firecrawl fournit un serveur MCP qui s’intègre de façon transparente à l’ADK de Google, permettant à vos agents d’extraire, de parcourir et d’aspirer efficacement des données structurées depuis n’importe quel site web. L’intégration prend en charge les instances Firecrawl hébergées dans le cloud comme auto‑hébergées, avec HTTP en streaming pour des performances optimales.

​

Fonctionnalités

• Scraping, exploration et découverte de contenu web efficaces sur n’importe quel site
• Recherche avancée et extraction de contenu intelligente
• Recherche approfondie et scraping par lots à grande échelle
• Déploiement flexible (cloud ou auto‑hébergé)
• Optimisé pour les environnements web modernes avec prise en charge du streaming HTTP

​

Prérequis

• Obtenez une clé d’API Firecrawl sur firecrawl.dev
• Installez le SDK Google

​

Configuration

Remote MCP Server

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='Un assistant pratique pour l’extraction de sites web avec Firecrawl',
    instruction='Aidez l’utilisateur à rechercher du contenu sur des sites web',
    tools=[
        MCPToolset(
            connection_params=StreamableHTTPServerParams(
                url=f"https://mcp.firecrawl.dev/{FIRECRAWL_API_KEY}/v2/mcp",
            ),
        )
    ],
)

​

Outils disponibles

Outil	Nom	Description
Outil de scraping	firecrawl_scrape	Extraire le contenu d’une seule URL avec des options avancées
Outil de scraping par lot	firecrawl_batch_scrape	Extraire plusieurs URL efficacement avec limitation de débit intégrée et traitement parallélisé
Vérifier l’état du lot	firecrawl_check_batch_status	Vérifier l’état d’une opération par lot
Outil de cartographie	firecrawl_map	Cartographier un site web pour découvrir toutes les URL indexées du site
Outil de recherche	firecrawl_search	Rechercher sur le web et, en option, extraire le contenu des résultats de recherche
Outil de crawl	firecrawl_crawl	Démarrer un crawl asynchrone avec des options avancées
Vérifier l’état du crawl	firecrawl_check_crawl_status	Vérifier l’état d’une tâche de crawl
Outil d’extraction	firecrawl_extract	Extraire des informations structurées à partir de pages web à l’aide de modèles LLM

​

Configuration

​

Configuration requise

FIRECRAWL_API_KEY: votre clé API Firecrawl

• Requise lors de l’utilisation de l’API cloud (par défaut)
• Facultative lors de l’utilisation d’une instance auto-hébergée avec FIRECRAWL_API_URL

​

Configuration optionnelle

URL de l’API Firecrawl (pour les instances auto-hébergées) :

• FIRECRAWL_API_URL : Point de terminaison de l’API personnalisé
• Exemple : https://firecrawl.your-domain.com
• Si non renseigné, l’API cloud sera utilisée

Configuration des tentatives de nouvelle exécution :

• FIRECRAWL_RETRY_MAX_ATTEMPTS : Nombre maximal de tentatives (par défaut : 3)
• FIRECRAWL_RETRY_INITIAL_DELAY : Délai initial en millisecondes (par défaut : 1000)
• FIRECRAWL_RETRY_MAX_DELAY : Délai maximal en millisecondes (par défaut : 10000)
• FIRECRAWL_RETRY_BACKOFF_FACTOR : Facteur de backoff exponentiel (par défaut : 2)

Suivi de l’utilisation des crédits :

• FIRECRAWL_CREDIT_WARNING_THRESHOLD : Seuil d’avertissement (par défaut : 1000)
• FIRECRAWL_CREDIT_CRITICAL_THRESHOLD : Seuil critique (par défaut : 100)

​

Exemple : Agent de recherche sur le Web

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"

# Créer un agent de recherche
research_agent = Agent(
    model="gemini-2.5-pro",
    name="research_agent",
    description='Un agent IA qui recherche des sujets en scrapant et en analysant du contenu web',
    instruction='''Vous êtes un assistant de recherche. Lorsqu'on vous donne un sujet ou une question :
    1. Utilisez l'outil de recherche pour trouver des sites web pertinents
    2. Scrapez les pages les plus pertinentes pour obtenir des informations détaillées
    3. Extrayez des données structurées si nécessaire
    4. Fournissez des réponses complètes et bien documentées''',
    tools=[
        MCPToolset(
            connection_params=StreamableHTTPServerParams(
                url=f"https://mcp.firecrawl.dev/{FIRECRAWL_API_KEY}/v2/mcp",
            ),
        )
    ],
)

# Utiliser l'agent
response = research_agent.run("Quelles sont les dernières fonctionnalités de Python 3.13 ?")
print(response)

​

Bonnes pratiques

1. Utiliser le bon outil pour la tâche :

   • firecrawl_search lorsque vous devez d’abord trouver les pages pertinentes
   • firecrawl_scrape pour une seule page
   • firecrawl_batch_scrape pour plusieurs URL connues
   • firecrawl_crawl pour découvrir et scraper des sites entiers

2. Surveiller votre consommation : configurez des seuils de crédit pour éviter des dépassements inattendus

3. Gérer les erreurs proprement : configurez les paramètres de retry en fonction de votre cas d’usage

4. Optimiser les performances : utilisez des opérations par lots lorsque vous scrapez plusieurs URL

---

​

Ressources associées

Guide complet pour créer des agents IA avec Google Agent Development Kit (ADK) et Firecrawl

Découvrez comment créer des systèmes d’IA multi-agents performants en utilisant le framework ADK de Google, avec Firecrawl pour le scraping web.

Documentation du serveur MCP

En savoir plus sur l’intégration et les fonctionnalités du serveur Model Context Protocol (MCP) de Firecrawl.

Documentation officielle de Google ADK

Explorez la documentation officielle de Google Agent Development Kit pour des guides complets et des références API.