Kit de desarrollo de agentes (ADK)

Integra Firecrawl con el Kit de desarrollo de agentes (ADK) de Google para crear agentes de IA potentes con capacidades de web scraping mediante el Model Context Protocol (MCP).

Descripción general

Firecrawl ofrece un servidor MCP que se integra sin fricciones con el ADK de Google, permitiendo que tus agentes realicen scraping, crawling y extracción de datos estructurados de cualquier sitio web de manera eficiente. La integración es compatible tanto con instancias de Firecrawl en la nube como autogestionadas, con HTTP en streaming para un rendimiento óptimo.

Funcionalidades

web scraping, rastreo y descubrimiento de contenido eficientes en cualquier sitio
Búsqueda avanzada y extracción inteligente de contenido
Investigación profunda
Despliegue flexible (en la nube o autogestionado)
Optimizado para entornos web modernos con soporte HTTP por streaming

Requisitos previos

Obtén una clave de API para Firecrawl en firecrawl.dev
Instala el Google SDK

Configuración

import os

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 = os.environ["FIRECRAWL_API_KEY"]

root_agent = Agent(
    model="gemini-2.5-pro",
    name="firecrawl_agent",
    description='Un asistente útil para extraer contenido de sitios web con Firecrawl',
    instruction='Ayuda al usuario a buscar contenido en sitios web',
    tools=[
        MCPToolset(
            connection_params=StreamableHTTPServerParams(
                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-2.5-pro',
    name='firecrawl_agent',
    description='Un asistente útil para extraer contenido de sitios web con Firecrawl',
    instruction='Ayuda al usuario a buscar contenido en sitios web',
    tools=[
        MCPToolset(
            connection_params=StdioConnectionParams(
                server_params = StdioServerParameters(
                    command='npx',
                    args=[
                        "-y",
                        "firecrawl-mcp@3.23.7",
                    ],
                    env={
                        "FIRECRAWL_API_KEY": os.environ["FIRECRAWL_API_KEY"],
                    }
                ),
                timeout=30,
            ),
        )
    ],
)

Configura FIRECRAWL_API_KEY en el entorno desde el que se inicia ADK. No incluyas su valor en los prompts del agente, el control de código fuente ni la URL del MCP. El paquete MCP local requiere Node.js 22 o una versión posterior.

Herramientas disponibles

Herramienta	Nombre	Descripción
Herramienta de scraping	`firecrawl_scrape`	Extrae contenido de una única URL con opciones avanzadas
Herramienta de mapeo	`firecrawl_map`	Genera el mapa de un sitio para descubrir todas las URL indexadas
Herramienta de búsqueda	`firecrawl_search`	Busca en la web y, opcionalmente, extrae contenido de los resultados
Herramienta de rastreo	`firecrawl_crawl`	Inicia un rastreo asíncrono con opciones avanzadas
Consultar estado del rastreo	`firecrawl_check_crawl_status`	Consulta el estado de un trabajo de rastreo

Configuración

Configuración requerida

FIRECRAWL_API_KEY: Tu clave de API de Firecrawl

Obligatorio al usar la API en la nube (por defecto)
Opcional al usar una instancia autogestionada con FIRECRAWL_API_URL

Configuración opcional

URL de la API de Firecrawl (para instancias autogestionadas):

FIRECRAWL_API_URL: Endpoint de API personalizado
Ejemplo: https://firecrawl.your-domain.com
Si no se especifica, se usará la API en la nube

Ejemplo: agente de investigación 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"

# Crear un agente de investigación
research_agent = Agent(
    model="gemini-2.5-pro",
    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=StreamableHTTPServerParams(
                url="https://mcp.firecrawl.dev/v2/mcp",
                headers={"Authorization": f"Bearer {FIRECRAWL_API_KEY}"},
            ),
        )
    ],
)

# Usar el agente
response = research_agent.run("What are the latest features in Python 3.13?")
print(response)

Mejores prácticas

Usa la herramienta adecuada para cada tarea:
- firecrawl_search cuando primero necesites encontrar páginas relevantes
- firecrawl_scrape para páginas individuales
- firecrawl_crawl para descubrir y extraer sitios completos
- llamadas repetidas a firecrawl_scrape cuando ya tengas una lista corta de URL conocidas
Supervisa tu uso: Usa tu panel de Firecrawl y las respuestas de la API para hacer seguimiento del consumo de créditos.
Gestiona los errores de forma adecuada: Muestra al usuario los errores de MCP/API y reintenta solo cuando tu flujo de trabajo del agente pueda hacerlo de forma segura.
Optimiza el rendimiento: Usa firecrawl_map antes de hacer scraping cuando el agente necesite descubrir URL relevantes.

Guía completa para crear agentes de IA con Google Agent Development Kit (ADK) y Firecrawl

Aprende a crear potentes sistemas de IA multiagente usando el kit ADK de Google junto con Firecrawl para scraping web.

Documentación del servidor MCP

Obtén más información sobre la integración y las capacidades del servidor Model Context Protocol (MCP) de Firecrawl.

Documentación oficial de Google ADK

Explora la documentación oficial de Google Agent Development Kit para guías completas y referencias de API.

Primeros pasos

Endpoints principales

Más

Inicios rápidos

Guías para desarrolladores

Webhooks

Casos de uso

Otros

Contribuciones

Kit de desarrollo de agentes (ADK)

Descripción general

Funcionalidades

Requisitos previos

Configuración

Herramientas disponibles

Configuración

Configuración requerida

Configuración opcional

Ejemplo: agente de investigación web

Mejores prácticas

Guía completa para crear agentes de IA con Google Agent Development Kit (ADK) y Firecrawl

Documentación del servidor MCP

Documentación oficial de Google ADK

​Descripción general

​Funcionalidades

​Requisitos previos

​Configuración

​Herramientas disponibles

​Configuración

​Configuración requerida

​Configuración opcional

​Ejemplo: agente de investigación web

​Mejores prácticas

​Recursos relacionados

Guía completa para crear agentes de IA con Google Agent Development Kit (ADK) y Firecrawl

Documentación del servidor MCP

Documentación oficial de Google ADK

Descripción general

Funcionalidades

Requisitos previos

Configuración

Herramientas disponibles

Configuración

Configuración requerida

Configuración opcional

Ejemplo: agente de investigación web

Mejores prácticas

Recursos relacionados