Um assistente que arruma cliente pra você sozinho

01Pra que serve

Achar empresas da sua região e do seu ramo pra oferecer o seu serviço. A busca é de graça (usa o OpenStreetMap, um mapa aberto).
Estudar o site de cada empresa e escrever um e-mail que cita uma coisa real que ele encontrou lá, pra não parecer spam.
Ler as respostas e continuar a conversa até marcar a reunião.
Acompanhar tudo num painel no navegador: empresas, contatos, e-mails na fila, conversas e quanto do seu plano já foi usado.
Por padrão, nenhum e-mail sai sem você aprovar.

02O que você precisa

Plano Claude Pro ou Max, com o Claude Code (o programa do Claude que roda no terminal) instalado e logado
Python 3.11 ou mais novo
Git, pra baixar o projeto
Uma caixa de e-mail num domínio separado do seu principal (Gmail/Google Workspace é o recomendado, cerca de US$ 7/mês)
Um site seu, de onde ele aprende o que você vende

03Passo a passo

Abra o terminal e entre na sua conta do Claude. No Windows use o Claude (a opção com Codex/ChatGPT só funciona em Mac e Linux).
```
claude login
```
Baixe o Harvey, entre na pasta dele e abra o Claude Code ali dentro.
```
git clone https://github.com/ethanplusai/harvey.git
cd harvey
claude
```
Peça a instalação. O Claude Code vira um assistente de configuração: vê o que falta, instala e pergunta o que precisa (seu site, seu e-mail, que tipo de cliente você quer).
```
set up Harvey for me
```
Ele vai sugerir 23 sinais pra decidir se uma empresa vale a pena. Nenhum é coletado até você confirmar. Pra ligar só os 21 que não custam nada:
```
harvey signals --confirm free
```
Abra o painel no navegador. Na aba Outbox você aprova (tecla A) ou recusa (tecla R) cada e-mail antes de sair.
```
http://localhost:5555
```
Pra ele buscar empresas e trabalhar sozinho, rode os dois comandos. Ele confere tudo a cada 15 minutos.
```
harvey discover
harvey run
```

04Pedidos prontos pra colar no Claude Code, dentro da pasta do Harvey

Configurar do jeito certoNa primeira vez, junto com o "set up Harvey for me"

Me ajude a configurar o Harvey. Eu vendo [O QUE VOCÊ VENDE, ex.: criação de sites] e meu site é [SEU SITE].
Antes de cada passo, me explique em português, em uma frase, o que vai fazer.
Use o Claude como provedor e deixe a aprovação de e-mail ligada: nenhum e-mail sai sem eu aprovar.

Escolher quem ele vai procurarPra dizer a cidade e o ramo das empresas

Edite o harvey.yaml, na parte icp, pra eu achar clientes assim:
Ramo (industries): [RAMOS, ex.: clínicas odontológicas, academias, restaurantes]
Região (geography): [CIDADES, ex.: Campinas, SP]
Me mostre o que mudou no arquivo e depois rode harvey discover.

E-mail em portuguêsAntes de aprovar os primeiros e-mails

Os e-mails do Harvey vão pra empresas brasileiras. Ajuste pra que sejam escritos em português do Brasil, curtos (até 5 linhas), num tom simpático e direto, citando uma coisa real do site da empresa e terminando com uma pergunta simples sobre marcar uma conversa de 15 minutos.
Todo e-mail precisa ter um jeito fácil de a pessoa pedir pra não receber mais e o meu endereço no rodapé: [SEU ENDEREÇO].

Não estourar o seu planoSe você também usa o Claude pra outras coisas

Configure o Harvey pra usar no máximo [NÚMERO, ex.: 50] por cento do meu limite diário do Claude (max_daily_claude_percent).
Depois me diga onde, no painel, eu vejo quanto ele já usou hoje.

05Antes de usar

Use um domínio de e-mail separado do principal e comece devagar: o próprio projeto pede de 2 a 4 semanas de aquecimento e configurar SPF, DKIM e DMARC (umas proteções do e-mail que o assistente ajuda a ligar). Senão seus e-mails caem no spam e o domínio fica queimado.
E-mail frio tem regra: precisa de um jeito de a pessoa sair da lista, atendido rápido, e do seu endereço no rodapé. Nos EUA a multa chega a US$ 53.088 por e-mail. No Brasil, vale a LGPD.
Ele gasta o limite do seu plano do Claude. Se usar muito, pode faltar pra você no resto do dia.
A busca de empresas é de graça, mas tem uma opção paga (DataForSEO, cerca de US$ 0,37 por 1.000 empresas). E a caixa de e-mail custa à parte.
Dá pra deixar ele mandar tudo sozinho, sem aprovação. Não faça isso no começo: leia os e-mails antes.
Ele só trabalha com o computador ligado. A licença é MIT (livre).

Resumindo: baixa, pede pro Claude Code configurar, diz que tipo de cliente você quer e aprova os e-mails no painel. Ele faz a caça e a conversa até a reunião.

Seguir @alvim_ai Repositório oficial no GitHub

Todos os guias e prompts do Alvim