> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-locadex-parallel-t9n-main-ydzk9zxoc20klj1uk5u1gd5b.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Agente Hermes

> Use o Firecrawl como backend padrão de busca na web e extração no Agente Hermes

<Note>
  **Documentação oficial do Hermes:** [Busca na web](https://hermes-agent.nousresearch.com/docs/user-guide/features/web-search) · [Navegador](https://hermes-agent.nousresearch.com/docs/user-guide/features/browser)

  O [Agente Hermes](https://hermes-agent.nousresearch.com/), da Nous Research, usa o Firecrawl como backend padrão para `web_search` e `web_extract`.
</Note>

<h2 id="overview">
  Visão geral
</h2>

O Agente Hermes é um agente de terminal e desktop de código aberto da Nous Research. Ele vem com ferramentas web:

| Ferramenta | O que faz |
| - | - |
| **`web_search`** | Faz uma busca na web e retorna resultados ranqueados |
| **`web_extract`** | Obtém e extrai conteúdo legível de URLs |

O Firecrawl é o provedor **padrão** para busca e extração. Defina `FIRECRAWL_API_KEY`, use uma `FIRECRAWL_API_URL` auto-hospedada ou o Nous Tool Gateway. Se você tiver credenciais para vários provedores, selecione o Firecrawl em `hermes tools` ou `config.yaml`. A automação do navegador pelo modo de nuvem do Firecrawl é opcional.

<h2 id="quick-start">
  Início rápido
</h2>

1. Instale o Agente Hermes em [hermes-agent.nousresearch.com](https://hermes-agent.nousresearch.com/)
2. Adicione sua chave da Firecrawl:

```bash theme={null}
# ~/.hermes/.env
FIRECRAWL_API_KEY=fc-your-key-here
```

Obtenha uma chave em [firecrawl.dev](https://www.firecrawl.dev/app/api-keys).

3. Ou faça a configuração de forma interativa:

```bash theme={null}
hermes tools
```

Escolha **Busca na Web e Extração** → **Firecrawl**.

4. Verifique:

```bash theme={null}
hermes setup
```

<h2 id="capabilities">
  Recursos
</h2>

| Recurso | No Hermes |
| - | - |
| **Busca** | Backend `web_search` padrão |
| **Extração / scraping** | Backend `web_extract` padrão |
| **Navegador** | Provedor opcional do navegador em nuvem da Firecrawl |

<h3 id="use-firecrawl-for-one-capability-only">
  Use o Firecrawl em apenas uma capacidade
</h3>

O Hermes permite escolher os backends de busca e extração de forma independente, para que você possa combinar um backend de busca gratuito com a extração do Firecrawl (ou vice-versa):

```yaml theme={null}
# ~/.hermes/config.yaml
web:
  search_backend: "searxng"
  extract_backend: "firecrawl"
```

Quando essas chaves estão vazias, ambas usam `web.backend`, e o Hermes detecta automaticamente as credenciais disponíveis. As credenciais de outros provedores podem ter prioridade sobre as do Firecrawl durante a detecção automática. Portanto, defina explicitamente `search_backend`, `extract_backend` ou `web.backend` para garantir o uso do Firecrawl.

<h3 id="browser-cloud-mode">
  Modo de navegador na nuvem
</h3>

Para usar o Firecrawl na automação de navegadores:

```bash theme={null}
# ~/.hermes/.env
FIRECRAWL_API_KEY=fc-your-key-here
```

```bash theme={null}
hermes setup tools
# → Automação de navegador → Firecrawl
```

Opcional:

```bash theme={null}
# Firecrawl auto-hospedado (caso contrário, usa a API em nuvem por padrão)
FIRECRAWL_API_URL=http://localhost:3002

# TTL da sessão em segundos (padrão: 300)
FIRECRAWL_BROWSER_TTL=600
```

<h2 id="nous-portal-managed-firecrawl">
  Nous Portal (Firecrawl gerenciado)
</h2>

Com uma assinatura paga do [Nous Portal](https://portal.nousresearch.com/), é possível realizar buscas na web e extrações pelo **Tool Gateway** do Hermes com o Firecrawl gerenciado. Não é necessária uma chave separada do Firecrawl:

```bash theme={null}
hermes setup --portal
```

Instalações existentes podem ativar ferramentas web com `hermes tools`.

<h2 id="self-hosted-firecrawl">
  Firecrawl auto-hospedado
</h2>

```bash theme={null}
# ~/.hermes/.env
FIRECRAWL_API_URL=http://localhost:3002
```

Quando `FIRECRAWL_API_URL` é definida, a chave de API é opcional se a autenticação do servidor Firecrawl estiver desativada (`USE_DB_AUTHENTICATION=false` na instância do Firecrawl).

<h2 id="resources">
  Recursos
</h2>

* [Agente Hermes](https://hermes-agent.nousresearch.com/)
* [Documentação de busca na web do Hermes (padrão do Firecrawl)](https://hermes-agent.nousresearch.com/docs/user-guide/features/web-search#firecrawl-default)
* [Documentação do navegador Hermes (modo de nuvem do Firecrawl)](https://hermes-agent.nousresearch.com/docs/user-guide/features/browser#firecrawl-cloud-mode)
* [Busca do Firecrawl](/pt-BR/features/search)
* [Scraping do Firecrawl](/pt-BR/features/scrape)
* [Guia de início rápido dos modelos da Nous Research](/pt-BR/quickstarts/nous-research) (chamada de ferramentas da API com modelos Hermes)