Agent Development Kit (ADK)

​

Funcionalidades

• web scraping, rastreamento e descoberta de conteúdo eficientes em qualquer site
• Busca avançada e extração inteligente de conteúdo
• Pesquisa autônoma na web com o agente do Firecrawl
• Interação com o navegador, análise de arquivos e monitoramento de alterações
• Implantação flexível (na nuvem ou auto-hospedada)
• Otimizado para a web moderna com suporte a Streamable HTTP

• Obtenha uma chave de API do Firecrawl em firecrawl.dev
• Instale o Google ADK com suporte a MCP: pip install "google-adk[mcp]"

​

Configuração

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='Um assistente útil para fazer scraping de sites com o Firecrawl',
    instruction='Ajude o usuário a buscar conteúdo de sites',
    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='Um assistente útil para fazer scraping de sites com o Firecrawl',
    instruction='Ajude o usuário a buscar conteúdo de sites',
    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,
            ),
        )
    ],
)

​

Ferramentas disponíveis

​

Autenticação

• Opcional com a API em nuvem (padrão): sem uma chave, o scraping e a busca funcionam no modo sem chave, dentro dos limites gratuitos; as demais ferramentas e limites mais altos exigem uma chave
• Opcional ao usar uma instância auto-hospedada com FIRECRAWL_API_URL

​

Configuração opcional

• FIRECRAWL_API_URL: Endpoint de API personalizado
• Exemplo: https://firecrawl.your-domain.com
• Se não for informada, a API em nuvem será utilizada

​

Exemplo: Agente de pesquisa na web

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"]

# Criar um agente de pesquisa
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}"},
            ),
        )
    ],
)

# Executar o agente e imprimir suas respostas
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())

​

Boas práticas

1. Use a ferramenta certa para a tarefa:
   • firecrawl_search quando você precisar encontrar primeiro as páginas relevantes
   • firecrawl_scrape para páginas individuais
   • firecrawl_crawl para descobrir e extrair sites inteiros
   • chamadas repetidas de firecrawl_scrape quando você já tiver uma pequena lista de URLs conhecidas
2. Monitore seu uso: Use seu painel do Firecrawl e as respostas da API para acompanhar o uso de créditos.
3. Lide com erros de forma adequada: Exiba erros de MCP/API ao usuário e tente novamente apenas quando o fluxo de trabalho do seu agente puder fazer isso com segurança.
4. Otimize o desempenho: Use firecrawl_map antes do scraping quando o agente precisar descobrir URLs relevantes.