> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Agent Development Kit (ADK)
> Integre o Firecrawl ao ADK do Google usando o MCP para fluxos de trabalho de agentes avançados
Integre o Firecrawl ao Agent Development Kit (ADK) do Google para criar agentes de IA avançados com recursos de web scraping por meio do Model Context Protocol (MCP).
## Visão geral
O Firecrawl oferece um servidor MCP que se integra perfeitamente ao ADK do Google, permitindo que seus agentes façam scraping, crawling e extraiam dados estruturados de qualquer site com eficiência. A integração é compatível tanto com instâncias do Firecrawl em nuvem quanto auto-hospedadas, com HTTP transmissível (streaming) para desempenho ideal.
## Funcionalidades
* web scraping, rastreamento e descoberta de conteúdo eficientes em qualquer site
* Busca avançada e extração inteligente de conteúdo
* Pesquisa aprofundada
* Implantação flexível (na nuvem ou auto-hospedada)
* Otimizado para a web moderna com suporte a HTTP por streaming
## Pré-requisitos
* Obtenha uma chave de API do Firecrawl em [firecrawl.dev](https://firecrawl.dev)
* Instale o Google SDK
## Configuração
```python Remote MCP Server theme={null}
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='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=StreamableHTTPServerParams(
url=f"https://mcp.firecrawl.dev/{FIRECRAWL_API_KEY}/v2/mcp",
),
)
],
)
```
```python Local MCP Server theme={null}
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='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",
],
env={
"FIRECRAWL_API_KEY": "YOUR-API-KEY",
}
),
timeout=30,
),
)
],
)
```
## Ferramentas disponíveis
| Ferramenta | Nome | Descrição |
| ------------------ | ------------------------------ | ------------------------------------------------------------------------------ |
| Scrape Tool | `firecrawl_scrape` | Extrair conteúdo de uma única URL com opções avançadas |
| Map Tool | `firecrawl_map` | Mapear um site para descobrir todas as URLs indexadas |
| Search Tool | `firecrawl_search` | Pesquisar na web e, opcionalmente, extrair conteúdo dos resultados de pesquisa |
| Crawl Tool | `firecrawl_crawl` | Iniciar um rastreamento assíncrono com opções avançadas |
| Check Crawl Status | `firecrawl_check_crawl_status` | Verificar o status de um trabalho de rastreamento |
| Extract Tool | `firecrawl_extract` | Extrair informações estruturadas de páginas da web usando recursos de LLM |
## Configuração
### Configuração obrigatória
**FIRECRAWL\_API\_KEY**: Sua chave de API do Firecrawl
* Obrigatório ao usar a API em nuvem (padrão)
* Opcional ao usar uma instância auto-hospedada com FIRECRAWL\_API\_URL
### Configuração opcional
**URL da API do Firecrawl (para instâncias auto-hospedadas)**:
* `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
```python theme={null}
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"
# Criar um agente de pesquisa
research_agent = Agent(
model="gemini-2.5-pro",
name="research_agent",
description='Um agente de IA que pesquisa tópicos através de scraping e análise de conteúdo web',
instruction='''Você é um assistente de pesquisa. Quando receber um tópico ou pergunta:
1. Use a ferramenta de busca para encontrar sites relevantes
2. Faça scraping das páginas mais relevantes para obter informações detalhadas
3. Extraia dados estruturados quando necessário
4. Forneça respostas abrangentes e bem fundamentadas''',
tools=[
MCPToolset(
connection_params=StreamableHTTPServerParams(
url=f"https://mcp.firecrawl.dev/{FIRECRAWL_API_KEY}/v2/mcp",
),
)
],
)
# Usar o agente
response = research_agent.run("Quais são os recursos mais recentes do Python 3.13?")
print(response)
```
## 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.
***
## Recursos relacionados
Aprenda a criar sistemas de IA multiagentes poderosos usando o ADK do Google com o Firecrawl para recursos de web scraping.
Saiba mais sobre a integração e os recursos do servidor Model Context Protocol (MCP) do Firecrawl.
Explore a documentação oficial do Google Agent Development Kit para guias completos e referências de API.