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

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:

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:

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