Dê aos seus agentes de voz e chat do ElevenAgents acesso à web em tempo real para fazer scraping, busca e rastreamento com o Firecrawl. Este guia aborda dois caminhos de integração:
- Servidor MCP — conecte o servidor MCP hospedado do Firecrawl para uma configuração sem código.
- Ferramenta de webhook do servidor — aponte uma ferramenta personalizada para a API REST do Firecrawl para ter controle total sobre as requisições.
Opção 1: Firecrawl servidor MCP
- Abra a página de integrações no ElevenLabs e clique em + Add integration.
- Selecione Custom MCP Server na biblioteca de integrações.
- Preencha os seguintes campos:
| Campo | Valor |
|---|
| Name | Firecrawl |
| Description | Busca, scraping, rastreamento e extração de conteúdo de qualquer site. |
| Server type | Streamable HTTP |
| Server URL | https://mcp.firecrawl.dev/YOUR_FIRECRAWL_API_KEY/v2/mcp |
YOUR_FIRECRAWL_API_KEY pela sua chave real. Deixe o menu suspenso Type definido como Value. Trate essa URL como um segredo — ela contém sua chave de API.
Você deve selecionar Streamable HTTP como tipo de servidor. A opção SSE padrão não funciona com o endpoint MCP do Firecrawl.
-
Em Tool Approval Mode, escolha um nível de aprovação:
- No Approval — o agente usa as ferramentas livremente. Adequado para scraping somente leitura.
- Fine-Grained Tool Approval — permite pré-selecionar quais ferramentas podem ser executadas automaticamente e quais exigem aprovação. Ideal para controlar operações de rastreamento mais caras.
- Always Ask (padrão) — o agente solicita permissão antes de cada chamada de ferramenta.
-
Marque I trust this server e clique em Add Server.
O ElevenLabs se conectará ao servidor e listará as ferramentas disponíveis (scrape, search, crawl, map e outras).
- Crie ou abra um agente no painel do ElevenAgents.
- Vá até a aba Tools e, em seguida, selecione a subaba MCP.
- Clique em Add server e selecione a integração Firecrawl no menu suspenso.
Atualize o prompt do sistema
Você é um assistente de pesquisa prestativo. Quando o usuário perguntar sobre um site,
uma empresa ou qualquer tema que exija informações atualizadas, use as
ferramentas do Firecrawl para fazer uma busca na web ou fazer scraping da página relevante e
resuma os resultados.
Teste
Clique em Preview na barra de navegação superior. Você pode testar usando o campo de chat por texto ou iniciando uma chamada de voz. Experimente um prompt como este:
“O que o firecrawl.dev faz? Acesse o site e faça um resumo para mim.”
O agente chamará a ferramenta MCP scrape do Firecrawl, receberá o markdown da página e responderá com um resumo.
Use esta abordagem quando precisar de controle preciso sobre os parâmetros da solicitação (formatos, cabeçalhos, tempos limite etc.) ou quiser chamar um endpoint específico do Firecrawl sem expor o conjunto completo de ferramentas do MCP.
Crie uma ferramenta que faz scraping de uma única URL e retorna o conteúdo em markdown.
- Abra seu agente e vá até a aba Tools.
- Clique em Add tool e selecione Webhook.
- Configure a ferramenta:
| Campo | Valor |
|---|
| Name | scrape_website |
| Description | Faça scraping do conteúdo de uma URL e retorne-o como markdown limpo. |
| Method | POST |
| URL | https://api.firecrawl.dev/v2/scrape |
O campo Method usa GET por padrão — lembre-se de alterá-lo para POST.
- Role até a seção Headers e clique em Add header para configurar a autenticação:
| Header | Value |
|---|
Authorization | Bearer YOUR_FIRECRAWL_API_KEY |
- Adicione um parâmetro no body:
| Parâmetro | Tipo | Descrição | Obrigatório |
|---|
url | string | A URL para fazer scraping | Sim |
- Clique em Add tool.
A API do Firecrawl retorna o conteúdo da página em markdown por padrão. O agente recebe a resposta JSON e pode usar o campo markdown para responder a perguntas.
Crie uma ferramenta que pesquisa na web e retorna resultados com conteúdo extraído.
- Clique em Add tool → Webhook novamente e configure:
| Campo | Valor |
|---|
| Nome | search_web |
| Descrição | Fazer uma busca na web por uma consulta e retornar resultados relevantes com o conteúdo da página. |
| Método | POST |
| URL | https://api.firecrawl.dev/v2/search |
-
Adicione o mesmo cabeçalho
Authorization mencionado acima.
-
Adicione parâmetros do body:
| Parâmetro | Tipo | Descrição | Obrigatório |
|---|
query | string | A consulta de busca | Sim |
limit | number | Número máximo de resultados a retornar (padrão: 5) | Não |
- Clique em Add tool.
Atualize o prompt do sistema
You are a knowledgeable assistant with access to web tools.
- Use `scrape_website` when the user gives you a specific URL to read.
- Use `search_web` when the user asks a general question that requires
finding information online.
Always summarize the information concisely and cite the source URL.
“Pesquise os recursos mais recentes do Next.js e me dê um resumo.”
O agente chamará search_web, receberá resultados do Firecrawl e responderá com um resumo dos resultados encontrados.
- Seleção de modelo — Para chamadas de ferramenta confiáveis, use um modelo mais avançado, como GPT-4o, Claude Sonnet 4.5 ou superior, ou Gemini 2.5 Flash. Modelos menores podem ter dificuldade para extrair os parâmetros corretos.
- Mantenha os prompts específicos — Diga ao agente exatamente quando usar cada ferramenta. Instruções vagas podem fazer com que chamadas de ferramenta sejam ignoradas ou executadas incorretamente.
- Limite o tamanho da resposta — Para agentes de voz, páginas longas extraídas podem sobrecarregar o contexto da LLM. Use
onlyMainContent: true nas opções de scraping (ou instrua o agente a resumir de forma agressiva) para manter as respostas concisas.
- Sons de chamada de ferramenta — Nas configurações da ferramenta de webhook ou MCP, você pode definir um som de chamada de ferramenta para reproduzir áudio ambiente enquanto uma ferramenta é executada. Isso sinaliza ao usuário que o agente está trabalhando.
