> ## 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.

# ElevenAgents

> Dê aos agentes de voz e chat do ElevenLabs acesso à web em tempo real com o Firecrawl

Dê aos seus agentes de voz e chat do [ElevenAgents](https://elevenlabs.io/agents) acesso à web em tempo real para fazer scraping, busca e rastreamento com o Firecrawl. Este guia aborda dois caminhos de integração:

1. **Servidor MCP** — conecte o servidor MCP hospedado do Firecrawl para uma configuração sem código.
2. **Ferramenta de webhook do servidor** — aponte uma ferramenta personalizada para a API REST do Firecrawl para ter controle total sobre as requisições.

<div id="prerequisites">
  ## Pré-requisitos
</div>

* Uma conta no [ElevenLabs](https://elevenlabs.io) com acesso ao ElevenAgents
* Uma chave de API do Firecrawl no seu [painel em firecrawl.dev](https://firecrawl.dev)

<div id="option-1-firecrawl-mcp-server">
  ## Opção 1: Firecrawl servidor MCP
</div>

A forma mais rápida de dar acesso à web a um agente. O ElevenAgents oferece suporte a servidores MCP remotos, e o Firecrawl disponibiliza um endpoint MCP hospedado.

<div id="add-the-mcp-server">
  ### Adicione o servidor MCP
</div>

1. Abra a [página de integrações](https://elevenlabs.io/app/agents/integrations) no ElevenLabs e clique em **+ Add integration**.
2. Selecione **Custom MCP Server** na biblioteca de integrações.
3. 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`              |

Substitua `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.

<Note>
  Você deve selecionar **Streamable HTTP** como tipo de servidor. A opção SSE padrão não funciona com o endpoint MCP do Firecrawl.
</Note>

4. 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.

5. 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).

<div id="attach-it-to-an-agent">
  ### Anexe a um agente
</div>

1. Crie ou abra um agente no [painel do ElevenAgents](https://elevenlabs.io/app/agents/agents).
2. Vá até a aba **Tools** e, em seguida, selecione a subaba **MCP**.
3. Clique em **Add server** e selecione a integração **Firecrawl** no menu suspenso.

<div id="update-the-system-prompt">
  ### Atualize o prompt do sistema
</div>

Na aba **Agent**, adicione instruções ao **prompt do sistema** para que o agente saiba quando usar o Firecrawl. Por exemplo:

```text theme={null}
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.

***

<div id="option-2-server-webhook-tool">
  ## Opção 2: Ferramenta de Webhook do Servidor
</div>

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.

<div id="scrape-tool">
  ### Ferramenta de scraping
</div>

Crie uma ferramenta que faz scraping de uma única URL e retorna o conteúdo em markdown.

1. Abra seu agente e vá até a aba **Tools**.
2. Clique em **Add tool** e selecione **Webhook**.
3. 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`                                 |

<Note>
  O campo **Method** usa GET por padrão — lembre-se de alterá-lo para **POST**.
</Note>

4. Role até a seção **Headers** e clique em **Add header** para configurar a autenticação:

| Header          | Value                           |
| --------------- | ------------------------------- |
| `Authorization` | `Bearer YOUR_FIRECRAWL_API_KEY` |

Como alternativa, se você tiver conexões de autenticação do workspace configuradas, poderá usar o menu suspenso **Authentication**.

5. Adicione um **parâmetro no body**:

| Parâmetro | Tipo   | Descrição                 | Obrigatório |
| --------- | ------ | ------------------------- | ----------- |
| `url`     | string | A URL para fazer scraping | Sim         |

6. 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.

<div id="search-tool">
  ### Ferramenta de busca
</div>

Crie uma ferramenta que pesquisa na web e retorna resultados com conteúdo extraído.

1. 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`                                                              |

2. Adicione o mesmo cabeçalho `Authorization` mencionado acima.

3. 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         |

4. Clique em **Add tool**.

<div id="update-the-system-prompt">
  ### Atualize o prompt do sistema
</div>

Na guia **Agent**, atualize o **System prompt**:

```text theme={null}
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.
```

<div id="test-it">
  ### Experimente
</div>

Clique em **Preview** e tente perguntar:

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

***

<div id="tips">
  ## Dicas
</div>

* **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.

<div id="resources">
  ## Recursos
</div>

* [Documentação do ElevenAgents](https://elevenlabs.io/docs/eleven-agents/overview)
* [Visão geral das ferramentas do ElevenAgents](https://elevenlabs.io/docs/eleven-agents/customization/tools)
* [Integração MCP do ElevenAgents](https://elevenlabs.io/docs/eleven-agents/customization/tools/mcp)
* [Referência da API do Firecrawl](https://docs.firecrawl.dev/api-reference/v2-introduction)
* [Servidor MCP do Firecrawl](https://docs.firecrawl.dev/mcp-server)