Harvey : l'agent Claude Code gratuit qui trouve tes clients et leur écrit à ta place, Quentin IA Marketing

Trouver des clients, c'est trois métiers à la fois : repérer les bonnes entreprises, comprendre ce qui les freine, puis leur écrire un message qui donne envie de répondre. La plupart des gens en font un seul, quand il leur reste du temps. Harvey fait les trois en boucle sur ton ordinateur. C'est un agent commercial open source qui tourne sur ton abonnement Claude, sans clé API ni facture au token.

Il trouve des entreprises qui correspondent à ton client idéal, lit leur site pour en tirer un fait précis, leur écrit un email à froid qui le cite, lit les réponses et pousse la conversation jusqu'au rendez-vous. Par défaut, aucun email ne part sans ton accord. Voici comment l'installer, les réglages qui comptent, et les règles à respecter pour ne pas finir en spam.

Claude AI Lab

Le Claude AI Lab, c'est ma communauté Skool où je partage mes systèmes Claude et les modules plus avancés. L'accès est à $67/mois.

Rejoindre le Lab →

✅Ce qu'il te faut

Un abonnement Claude Pro ou Max, avec Claude Code connecté (claude login). Harvey passe par lui pour réfléchir et écrire. Un forfait ChatGPT avec Codex marche aussi, en option.

Python 3.11 ou plus récent. Vérifie avec python3 --version. Sur Mac, la version livrée est la 3.9 : installe la 3.13 avec brew install python@3.13.

Une boîte mail sur un domaine secondaire. Gmail ou Google Workspace de préférence, Microsoft 365 marche aussi. Jamais ton domaine principal.

Un site qui décrit ton offre. Harvey le lit pour apprendre ce que tu vends et à qui.

2 800+

étoiles sur GitHub, licence MIT

clé API, ton abonnement Claude suffit

15 min

entre deux cycles de travail

Ce que fait Harvey

🔗 github.com/ethanplusai/harvey

🔁Un cycle toutes les 15 minutes

Il se réveille et vérifie son budget. Harvey lit ton quota d'abonnement et se bride pour te laisser de la marge : 80 % maximum par défaut, réglage max_daily_claude_percent.

Il choisit la tâche la plus utile, sans appeler de modèle. Dans l'ordre : traiter les réponses reçues, envoyer les campagnes prêtes, écrire les campagnes manquantes, chercher de nouveaux prospects, analyser.

Il agit, note tout, puis se rendort. La boucle tourne tant que ton ordinateur est allumé. Des heures calmes (22 h à 7 h par défaut, à l'heure de New York) mettent en pause la recherche et l'écriture : règle usage.quiet_hours sur ton fuseau.

🔎

Scout

Note et personnalise les entreprises trouvées. Le code fait la recherche, le modèle n'intervient que là où il faut du jugement.

✍️

Writer

Écrit des séquences de 3 emails : moins de 75 mots pour les deux premiers, moins de 40 pour le dernier.

📤

Sender

Programme chaque email, respecte le plafond quotidien et arrête la séquence dès que quelqu'un de l'entreprise répond.

💬

Handler

Lit les réponses, en déduit l'intention, prépare la suite et repère les adresses qui rebondissent.

📊

Analyst

Tourne quand il n'y a rien d'autre à faire : ce qui marche, ce qui ne marche pas.

Son terrain

Harvey est le plus fort sur les petites entreprises locales (5 à 50 personnes) et les start-ups, là où les bases de contacts payantes sont les plus pauvres. Aucun outil de prospection à payer : ni Apollo, ni Clay, ni ZoomInfo.

Installer Harvey

💻 Terminal, puis Claude Code

🤖La voie simple : Claude Code s'en charge

Clone le dépôt et ouvre Claude Code dedans avec les trois commandes ci-dessous.

Colle le message qui suit. Le dépôt contient un fichier CLAUDE.md qui transforme Claude Code en assistant d'installation : il regarde où tu en es, installe ce qui manque, te pose une question à la fois et entraîne Harvey sur ton offre.

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

Installe Harvey pour moi. Ce que je vends : [TON OFFRE EN UNE PHRASE]. Mon site : [URL DE TON SITE]. Mon client idéal : [SECTEUR, TAILLE D'ENTREPRISE, VILLE OU PAYS, POSTE DE LA PERSONNE À CONTACTER]. Mon fuseau horaire : [TON FUSEAU]. Je veux que chaque email attende ma validation avant de partir. Pose-moi une question à la fois et dis-moi ce que tu fais à chaque étape.

🛠️Ou à la main

Installe avec python3.13, pas python3. Sur Mac, python3 pointe vers la 3.9 et Harvey ne démarre pas.

Remplis le fichier .env. Chaque variable y est expliquée. La seule obligatoire est ta boîte d'envoi : harvey gmail auth connecte Gmail une fois pour toutes.

Entraîne Harvey sur ton site. Il en tire ton offre, tes bénéfices, tes prix et tes concurrents, dans des fichiers que tu peux relire et corriger.

Valide les signaux, lance la recherche, ouvre le tableau de bord, démarre la boucle. Les signaux sont détaillés juste après.

python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .
cp .env.example .env && $EDITOR .env
harvey train https://ton-site.com
harvey signals --confirm free
harvey discover
harvey dashboard
harvey run

Le tableau de bord

harvey dashboard affiche un lien privé vers 127.0.0.1:5555. Il n'écoute que sur ta machine et demande un jeton, parce qu'il peut valider des emails et lancer Harvey.

Lui dire qui chercher

🎯 onglet Signals

📡29 signaux, aucun sans ton accord

Harvey sait relever 29 signaux sur une entreprise, et n'en collecte aucun tant que tu ne l'as pas validé. harvey signals --confirm free active d'un coup les 26 gratuits. Les payants s'activent un par un.

Des signaux d'achat concrets. L'entreprise paie déjà de la pub Google ou Meta, elle n'a pas de réservation en ligne, son blog est abandonné, elle recrute pour un poste précis, elle n'a pas de site, ou son agence actuelle signe le pied de page.

Il lit leur site gratuitement. Trois requêtes par entreprise, sans navigateur ni appel au modèle : c'est là qu'il trouve le fait précis qui rendra l'email personnel.

Il trouve qui décide. Le dirigeant ou le fondateur, à partir des pages équipe et à propos, deux personnes maximum par entreprise. Chaque adresse est vérifiée, et seules les adresses livrables reçoivent un email.

🧮Une cohorte, c'est une requête

Coche ce qu'un bon prospect doit avoir et ce qui l'exclut. Par exemple : travaille avec une agence marketing, paie de la pub Google, n'a pas de réservation en ligne. Le tableau de bord compte les entreprises qui correspondent, en direct.

Chaque email sait pourquoi il est envoyé. Le signal qui a fait entrer l'entreprise dans la cohorte sert d'accroche au message.

Pour commencer gratuitement

La source par défaut, OpenStreetMap, est gratuite et sans compte. Elle couvre mal les métiers sans boutique (couvreurs, plombiers). Pour plus de volume, les sources payantes démarrent autour de 0,37 USD les 1 000 entreprises, et harvey discover --estimate affiche le coût avant de dépenser quoi que ce soit.

Les emails : écriture, validation, réponses

✉️ onglets Outbox et Conversations

✍️Comment il écrit

Des emails courts qui citent un fait observé. Une liste noire bannit les tics de l'IA (« j'espère que vous allez bien », « je me permets de revenir vers vous »), et jamais de pitch dans un premier email : le premier contact sert à ouvrir la conversation.

Son savoir-faire commercial tient dans des fichiers texte. Le dossier skills/ contient ses méthodes : cadres d'emails, objections, qualification. Tu modifies un fichier, le cycle suivant en tient compte, sans redémarrage.

🛑Rien ne part sans toi

Chaque email attend ta validation, par défaut. Dans l'Outbox, un email occupe l'écran avec tout ce que Harvey savait en l'écrivant. A pour valider, E pour modifier, R pour refuser.

Un contrôle sans IA avant chaque envoi. Il bloque les variables non remplies, les phrases bannies, les emails trop longs, les liens en trop et les adresses non livrables.

Le pilote automatique existe, mais pas tout de suite. Valide un ou deux lots à la main, lis ce qu'il écrit, puis active-le dans Settings, Sending. Même là, un email qui contient un lien vers un domaine qui n'est pas le tien reste bloqué pour toi.

Le bouton d'arrêt. harvey sending pause coupe tous les envois en cours.

💬Quand quelqu'un répond

Il comprend l'intention et prépare la réponse. Intéressé, objection, pas maintenant : sa réponse passe par la même validation que le reste. Une demande de contrat, ou une réponse à laquelle il n'a pas de réponse sûre, te revient directement.

Il pousse vers le rendez-vous. Choisis comment avec booking_method : ton lien d'agenda (booking_url), deux ou trois créneaux précis proposés dans l'email, ou il demande sa préférence au prospect.

Un « stop » est définitif. Toute demande de désinscription retire la personne pour de bon, et ses messages suivants ne reçoivent plus de réponse automatique.

Ne pas griller ton domaine

🔥 harvey warmup

📬Délivrabilité : ce qui décide de tout

Un domaine d'envoi dédié. Achète une variante de ton domaine, par exemple getmonentreprise.com pour monentreprise.com. Si un domaine d'envoi finit en spam, ton domaine principal reste intact.

SPF, DKIM et DMARC configurés. Sans les trois, Gmail te classe en indésirable. harvey warmup les vérifie, avec l'âge du domaine et les listes noires, et répond READY ou NOT READY.

2 à 4 semaines de préchauffage avant le vrai volume, avec un service de préchauffage qui continue ensuite. Harvey se connecte à TrulyInbox pour suivre la progression.

Monte doucement. 10 à 20 emails par jour et par boîte au départ, puis environ 5 de plus par jour. Le plafond par défaut de 50 par jour est une limite, pas un objectif.

Surveille les rebonds. Au-dessus de 3 %, arrête et nettoie ta liste. Harvey coupe lui-même les envois au-delà du seuil que tu fixes.

⚖️Les règles à respecter

Tu restes l'expéditeur. Chaque email à froid porte une ligne de désinscription et ton adresse postale (compliance.postal_address, à renseigner avant la première campagne).

En Europe et au Royaume-Uni, la pertinence est ta justification. L'email doit concerner directement le métier de la personne, tu dois savoir d'où vient la donnée, et se désinscrire doit être immédiat. Certains pays, comme l'Allemagne, demandent un consentement préalable même entre entreprises.

Une liste « ne jamais contacter ». Concurrents, clients actuels : ajoute-les sous compliance.do_not_contact. Le contrôle s'applique même à un email que tu as déjà validé.

Si on lui demande s'il est une IA, il dit oui. Ne le configure jamais autrement. LinkedIn est désactivé par défaut : l'automatiser enfreint ses conditions d'utilisation.

Ce n'est pas un avis juridique

Si tu envoies en volume ou dans un secteur réglementé, fais valider ta démarche par un juriste. Et relis les conditions d'utilisation de ton abonnement Claude avant de faire tourner un agent toute la journée.

Ta première semaine

📅 le plan jour par jour

🗓️Le plan

Jour 1 : le domaine. Achète ton domaine d'envoi, crée la boîte, configure SPF, DKIM et DMARC, lance le préchauffage. C'est l'étape la plus longue, donc la première.

Jour 2 : l'installation. Claude Code installe Harvey, harvey train apprend ton offre. Relis les fichiers produits et corrige ce qui sonne faux.

Jour 3 : la cible. Valide les signaux gratuits, lance harvey discover sur la source gratuite, construis une première cohorte de 20 à 30 entreprises.

Jours 4 à 7 : les brouillons. Laisse Harvey écrire, valide ou refuse chaque email, et réécris skills/email_frameworks.md avec tes propres formulations, jusqu'à pouvoir signer chaque email tel quel.

Quand harvey warmup répond READY : les premiers envois, toujours en validation manuelle, 10 à 20 par jour.

Utile même sans envoyer

harvey export sort un CSV de tous les prospects livrables trouvés, prêt pour ton outil d'envoi habituel. Pendant le préchauffage, Harvey te construit déjà ta liste.

Le vrai levier

Un agent commercial ne remplace pas une offre claire. Quand les emails de Harvey sonnent creux, la cause est souvent en amont : un site qui décrit mal ce que tu vends, ou un client idéal trop large. Commence par là : une offre en une phrase, un client précis, un signal d'achat qui le trahit. Harvey fait le reste en boucle, et tu gardes la partie qui compte vraiment : valider, puis parler aux gens qui répondent.