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

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

<div id="overview">
  ## Visão geral
</div>

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.

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

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

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

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

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

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.

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

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

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

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

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

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

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

* [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)