Harvey: l'agente gratuito di Claude che ti trova clienti

Harvey è un progetto open source (licenza MIT) di ethanplusai. Gli dici cosa vendi e chi è il tuo cliente ideale. Lui cerca le attività che corrispondono, legge il sito di ognuna, trova qualcosa di specifico da dire e scrive una mail che lo nomina, pensata per non sembrare spam.

Poi legge ogni risposta, capisce cosa vuole la persona e porta avanti la conversazione: dal primo contatto alla qualifica, fino a fissare un appuntamento. Gira in loop sulla tua macchina ogni 15 minuti, e un pannello locale ti mostra tutto quello che sta facendo.

La parte che conta: usa il piano Claude Pro o Max che già paghi. Non servono chiavi API e non c'è nessun costo per token.

Se sei in Italia, leggi prima le regole. Qui per le email promozionali automatiche serve il consenso di chi le riceve, anche se è un'azienda: un indirizzo trovato online non basta. Te lo spiego in fondo alla guida, nella parte «Da sapere prima di partire».

Installalo passo 1

Cosa ti serve

Python 3.11 o più recente. macOS ha una versione più vecchia: installa quella nuova con brew install python@3.13.
Un piano Claude Pro o Max attivo, con la CLI di Claude Code loggata (claude login).
Una casella per spedire. Il README consiglia Gmail o Google Workspace su un dominio dedicato solo all'invio.

Due cubetti di feltro davanti a un negozio

Clona il repository: git clone https://github.com/ethanplusai/harvey.git
Entra nella cartella e apri Claude Code: cd harvey, poi claude
Scrivi: set up Harvey for me. Il CLAUDE.md del progetto trasforma Claude Code in un assistente che controlla cosa hai installato, ti chiede quello che manca e addestra Harvey sul tuo prodotto.
Quando è tutto pronto, avvia il pannello con harvey dashboard (si apre su http://localhost:5555) e l'agente con harvey run.

Incolla questo dentro Claude Codefa tutto lui: controlla, chiede e installa

Clone https://github.com/ethanplusai/harvey.git, read its README and CLAUDE.md, and set Harvey up for me. Check my Python version first. Ask me before you create accounts, change any DNS records or send anything.

Installazione a mano passo 2 (alternativa)

Se preferisci fare tutto da solo senza l'assistente:

Installa le dipendenze: python3.13 -m venv .venv && source .venv/bin/activate && pip install -e . (usa python3.13, non il python3 di sistema).
Configura: cp .env.example .env e modifica il file. Ogni variabile è spiegata dentro.
Insegnagli il tuo prodotto dal tuo sito: harvey train https://il-tuo-sito.com
Conferma il profilo del cliente ideale: harvey signals --confirm free. Non raccoglie niente finché non confermi.
Cerca le attività: harvey discover
Guarda il pannello e avvia: harvey dashboard, poi harvey run

Cosa fa a ogni giro

Harvey si sveglia ogni 15 minuti, controlla il suo budget e decide cosa fare. L'ordine è sempre lo stesso: prima gestisce le risposte, poi spedisce le campagne, poi le scrive, poi cerca nuovi contatti, poi aspetta.

Scoperta e lettura sono gratis: la fonte predefinita e OpenStreetMap, e leggere un sito sono poche richieste HTTP senza nessuna chiamata al modello.
Scout valuta ogni attività rispetto al tuo profilo.
Writer scrive una sequenza di tre email: le prime due sotto 75 parole, la terza sotto 40, con una lista di frasi vietate per non sembrare generato.
Handler legge ogni risposta, capisce il senso, aggiorna lo stato della conversazione (primo contatto, interesse, qualifica, presentazione, trattativa, chiusura) e prepara la risposta.
Un controllo prima dell'invio, senza modello, blocca i merge tag vuoti, le frasi vietate, le email troppo lunghe, troppi link e gli indirizzi sbagliati.

Il cubetto arancione accanto a una cassetta delle lettere

Il pannello

harvey dashboard apre una pagina locale su localhost:5555. Si apre su Today: quello che ti aspetta. Le altre sezioni sono Signals, Discover, Companies and Contacts, Outbox, Conversations e Usage.

Outbox è il cuore del controllo: ogni email ti riempie lo schermo, A la approva, R la rifiuta, J e K ti spostano tra le email. Usage ti mostra quanto del tuo piano Claude l'agente ha usato.

Quanto costa

Cosa	Costo
Il modello (scrivere, rispondere)	Il piano Claude Pro o Max che già paghi. Niente chiavi API, niente fattura a token.
Cercare le attività	$0 con OpenStreetMap (la fonte predefinita). Le fonti a pagamento mostrano il prezzo prima di partire.
Leggere i loro siti	$0: poche richieste HTTP, nessuna chiamata al modello.
Spedire	Una casella email e un dominio dedicato. Google Workspace parte da $7/mese (piano annuale).

Se sei in Italia

Google Workspace Business Starter costa 6,80 EUR al mese con contratto annuale, oppure 8,10 EUR al mese con fatturazione mensile, IVA esclusa. Il dominio dedicato per l'invio si compra a parte: i registrar italiani partono da pochi euro l'anno.

Da sapere prima di partire

Ogni email aspetta la tua approvazione. La modalità automatica si accende a mano (channels.email.require_approval: false). Finche non la tocchi, niente parte senza che tu lo veda.
Niente costi API non vuol dire niente limiti. Il tuo piano Claude ha un tetto d'uso. Harvey può limitare quanto ne consuma con l'impostazione max_daily_claude_percent (predefinito: 80%).
Le email a freddo vivono di deliverability. Usa un dominio dedicato solo per l'invio, configura SPF, DKIM e DMARC, riscaldalo per 2-4 settimane e parti piano. Il tetto predefinito e 50 invii al giorno, ed è un massimo, non un obiettivo.
Prenotare un appuntamento in calendario non è ancora automatico. Il README lo indica come funzione in arrivo.
OpenStreetMap è sottile per le attività senza vetrina. Controlla la copertura per la tua nicchia prima di fare affidamento solo su quella fonte.
Le email a freddo hanno regole. Rispetta la legge del posto tuo e di quello del destinatario, inserisci un modo onesto per cancellarsi e leggi la sezione legale del README di Harvey.
Gira col tuo login. Controlla i termini attuali di Anthropic e i limiti del tuo piano per l'uso automatizzato prima di lasciarlo in esecuzione.
L'automazione LinkedIn e spenta di default, perché viola i termini di LinkedIn.

Il cubetto arancione visto dall'alto tra i negozi

In Italia, in più

In Italia la regola è più stretta di quella che il README di Harvey dà per l'Europa in generale. Per le email promozionali automatiche serve il consenso preventivo di chi le riceve, anche quando è un'azienda (articolo 130 del Codice Privacy). Il Garante ha chiarito più volte che un indirizzo pubblicato su un sito o in un elenco non vale come consenso. L'eccezione è chi è già tuo cliente: a lui puoi proporre prodotti simili a quelli che ha comprato, con un modo semplice per dire di no.

Quindi in Italia Harvey va usato con indirizzi che ti hanno dato il consenso, o non va usato per scrivere a freddo. Prima di partire leggi le linee guida del Garante sul marketing e sullo spam e parlane con un consulente privacy: le sanzioni sono alte.

Un agente di Claude che ti trova clienti gratis