# Harvey: como instalar o agente de IA que prospecta clientes usando o Claude

> Passo a passo pra instalar o Harvey, agente de prospecção de código aberto que roda no seu plano do Claude, e configurar o e-mail pra não cair no spam.

- Autor: Weslley Maioli (Beca), gestor de tráfego pago e desenvolvedor
- Publicado em: 2026-10-21 · Atualizado em: 2026-10-21
- Página: https://becaia.com.br/materiais/harvey-agente-prospeccao-claude/

- Ferramenta: Harvey
- O que faz: Acha empresas, lê o site delas e escreve e-mail de prospecção personalizado
- Preço: Grátis, usa a sua assinatura do Claude Pro ou Max
- Roda em: macOS, Linux e Windows
- Licença: MIT
- Versão conferida: 0.2.1
- Onde baixar: https://github.com/ethanplusai/harvey

## Resumo

O Harvey é um agente de prospecção de código aberto que roda no plano Pro ou Max do Claude, sem chave de API. Ele lê o seu site, procura empresas com um problema que você resolve, escreve três e-mails pra cada uma e só envia o que você aprovar. Pra instalar, basta baixar o projeto e pedir pro Claude Code configurar.

Se você comentou CLIENTES no Reels, esse é o material que eu prometi: como instalar o Harvey, como dizer pra ele que tipo de empresa procurar e como configurar o e-mail pra não cair no spam. Tudo aqui foi conferido no repositório oficial do projeto, na versão 0.2.1.

## O que você precisa antes de instalar

- Um computador com Mac, Linux ou Windows
- Python 3.11 ou mais novo. Confira com `python3 --version`, e se o Mac mostrar 3.9, instale o novo com `brew install python@3.13`
- O Claude Code instalado e logado numa assinatura Pro ou Max, com `claude login`
- Uma caixa de e-mail pra enviar, de preferência Gmail ou Google Workspace num domínio separado do principal (explico o porquê lá embaixo)

## Como instalar o Harvey pelo Claude Code

O jeito mais fácil é deixar o próprio Claude Code instalar. Abra o terminal e rode:

```bash
git clone https://github.com/ethanplusai/harvey.git
cd harvey
claude
```

Com o Claude Code aberto dentro da pasta, peça **configura o Harvey pra mim**. O projeto vem com um arquivo de instruções que transforma o Claude Code num assistente de instalação, que confere o que falta, instala, pergunta o que precisa e treina o Harvey em cima do seu site.

Se preferir fazer na mão, são estes comandos, na ordem:

```bash
# 1. Instalar (no Mac use python3.13, porque o python3 do sistema é o 3.9)
python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .

# 2. Criar o arquivo de configuração e preencher num editor de texto
cp .env.example .env

# 3. Ensinar o seu produto a partir do seu site
harvey train https://seusite.com.br

# 4. Liberar os critérios de busca gratuitos (explicados abaixo)
harvey signals --confirm free

# 5. Procurar empresas na fonte grátis, sem cadastro
harvey discover

# 6. Abrir o painel e ligar o Harvey
harvey dashboard
harvey run
```

## Como dizer pro Harvey que tipo de empresa procurar

Ele não sai procurando nada até você dizer o que conta como um bom cliente. São 23 critérios, e 21 deles são grátis. Os que mais fazem sentido pra quem vende serviço de marketing:

- A empresa anuncia no Google Ads ou no Meta Ads agora, então tem verba
- O site não tem agendamento online, e quem procura fora do horário fica sem resposta
- Tem perfil no Google e telefone, mas não tem site
- Ninguém reivindicou o Perfil da Empresa no Google
- O blog foi abandonado
- O rodapé do site mostra qual agência cuida da conta
- Aparece entre a 11ª e a 30ª posição no Google na busca principal do negócio (esse é pago)

Pra liberar todos os gratuitos de uma vez, rode `harvey signals --confirm free`. Os pagos, como a posição no Google, você libera um por um.

Depois, no painel, você combina os critérios, por exemplo "anuncia no Google Ads e não tem agendamento online". O painel conta na hora quantas empresas batem, e o e-mail que o Harvey escreve já fala desse problema.

## Onde o Harvey encontra as empresas

A fonte padrão é o OpenStreetMap, grátis e sem cadastro. O ponto fraco é que ela tem pouca empresa de serviço sem endereço de loja, como quem atende na casa do cliente. Pra ter mais volume, o projeto lista fontes pagas, como a DataForSEO (US$ 0,37 a cada mil empresas, com US$ 1 de crédito pra testar) e a Serper (2.500 buscas grátis, sem cartão).

Antes de gastar qualquer coisa, rode `harvey discover --estimate`, que ele mostra o custo e para por aí.

## Como aprovar os e-mails antes de sair

Nenhum e-mail sai sem você aprovar, a não ser que você mude isso. Abra o painel com `harvey dashboard`, entre na aba Outbox e vá um por um, com A pra aprovar e R pra recusar. Pra parar tudo na hora, rode `harvey sending pause`.

Cada empresa recebe uma sequência de três e-mails curtos (o primeiro e o segundo com menos de 75 palavras, o terceiro com menos de 40), e o envio pra aquela empresa para assim que alguém responde.

## Como configurar o e-mail pra não cair no spam

Prospecção que cai no spam quase sempre é problema do domínio, não do texto. O caminho que o próprio projeto recomenda:

1. **Use um domínio só pra prospecção.** Se a sua empresa é `clinicaexemplo.com.br`, registre algo como `conhecaclinicaexemplo.com.br` e mande dali. Se der problema, o domínio principal fica limpo.
2. **Configure SPF, DKIM e DMARC nesse domínio.** São três registros no DNS que provam pro Gmail e pro Outlook que o e-mail saiu mesmo de você. Sem os três, o Gmail joga no spam.
3. **Confira com `harvey warmup`.** Ele lê o DNS, a idade do domínio e as listas de bloqueio, e responde READY (pronto) ou NOT READY (ainda não).
4. **Aqueça o domínio por 2 a 4 semanas** antes de mandar volume. Com uma data em `channels.email.warmup.start_date`, o Harvey segura os e-mails frios nesse período e depois sobe o limite aos poucos.
5. **Comece com 10 a 20 e-mails por dia por caixa** e aumente uns 5 por dia. O limite padrão de 50 é teto, não meta.
6. **Acompanhe as devoluções.** Passou de 3%, pare e limpe a lista. O Harvey desliga o envio sozinho quando passa do limite que você configurar.

## O que ajustar pra prospectar no Brasil

O projeto é em inglês e foi pensado pros Estados Unidos, então antes da primeira campanha vale mexer em quatro coisas:

- **Idioma dos e-mails.** As regras de escrita ficam em `skills/email_frameworks.md`, em texto simples. Peça pro Claude Code adaptar esse arquivo pra escrever em português do Brasil.
- **Frase de descadastro.** Todo e-mail frio sai com uma linha pra pessoa pedir pra não receber mais (`compliance.opt_out_line`). Se for traduzir, ela precisa pedir uma resposta que o Harvey reconhece, como STOP, e "Responda NÃO" não está na lista dele.
- **Endereço físico.** Preencha `compliance.postal_address` no `harvey.yaml`, ou no `harvey.local.yaml` se você treinou o Harvey, porque esse vale por cima. Ele fica avisando até você preencher.
- **LGPD.** Mande só pra empresa que tem motivo real pra se interessar no que você vende, saiba de onde veio cada contato e atenda o pedido de descadastro na hora. Isso não é orientação jurídica, e se for disparar em escala vale falar com um advogado.

## Perguntas frequentes

### O Harvey é de graça?

O código é grátis e aberto, com licença MIT. Você paga a assinatura do Claude Pro ou Max, que ele usa no lugar da API, e uma caixa de e-mail (o projeto cita o Google Workspace, uns US$ 7 por mês). As fontes pagas de empresas são opcionais.

### Precisa saber programar pra usar o Harvey?

Pra instalar, não, porque o Claude Code faz a instalação se você pedir. Você vai rodar alguns comandos no terminal e preencher dois arquivos de texto, o `.env` e o `harvey.yaml`.

### O Harvey funciona pra prospectar empresas no Brasil?

O projeto foi feito com exemplos dos Estados Unidos. A busca aceita qualquer cidade, mas a fonte grátis tem pouca empresa de serviço cadastrada e os modelos de e-mail vêm em inglês. Faça um teste pequeno numa cidade só e ajuste o idioma antes de mandar volume.

### Dá pra usar o Harvey com o ChatGPT em vez do Claude?

Dá, pelo Codex com um plano do ChatGPT, no Mac e no Linux. No Windows ele só roda com o Claude.

### O Harvey manda e-mail sozinho?

Só se você deixar. Por padrão cada e-mail espera a sua aprovação, e pra ligar o piloto automático é preciso mudar `channels.email.require_approval` para `false` no `harvey.yaml`.

## Fontes

- [Harvey: repositório oficial no GitHub (README da versão 0.2.1)](https://github.com/ethanplusai/harvey)
- [Google: diretrizes pra quem envia e-mail (SPF, DKIM e DMARC)](https://support.google.com/mail/answer/81126)
- [Lei Geral de Proteção de Dados Pessoais (Lei nº 13.709/2018)](https://www.planalto.gov.br/ccivil_03/_ato2015-2018/2018/lei/l13709.htm)