Agents IA · 8 min · 2026-11-06 · Par Équipe MaitriseLIA
Harvey, l’agent de prospection par email : des garde-fous à copier, zéro contact trouvé en France
Harvey est un agent open source de prospection par email qui tourne sur votre abonnement Claude ou ChatGPT, et il soigne la sécurité comme peu d’outils du genre : accord humain par défaut, contrôle automatique avant envoi, messages suspects retenus. Nous l’avons testé le 6 novembre sur des courtiers en assurance de Marseille et Lyon, sans boîte mail branchée : 35 entreprises trouvées, aucun dirigeant identifié, aucune adresse. Ce qu’il faut copier, et ce qui casse en France.
TL;DR
- Ce que c’est : Harvey, un agent open source (licence MIT) qui cherche des entreprises, trouve qui contacter, rédige des séquences de cold email et traite les réponses, sur votre abonnement Claude ou ChatGPT. 4 432 étoiles le 5 novembre.
- Son point fort : la prudence. Chaque email attend votre accord par défaut, un contrôle sans modèle bloque les envois défectueux, et les messages qui reprennent des instructions plantées sont retenus.
- Ce qui casse en France : sur des courtiers en assurance de Marseille et Lyon, 35 entreprises trouvées, 0 dirigeant identifié, 0 adresse, donc un export vide.
- Pourquoi : sa source de données, son extraction des noms et sa désinscription sont pensées pour l’anglais et les petites entreprises américaines.
- Notre verdict : marque-page. Des garde-fous à étudier, un outil inutilisable tel quel hors des États-Unis.
« Le cold email n’est pas mort, le cold email paresseux l’est » : c’est la promesse de Harvey. Il se présente comme un commercial patient qui cherche peu d’entreprises, les étudie, écrit court et demande la permission avant d’envoyer. Sur le papier, c’est l’un des agents commerciaux open source les plus soignés que nous ayons lus.
Restait à voir ce qu’il trouve sur un marché français. Notre équipe l’a testé le 6 novembre 2026, en mode export seul, sans boîte mail connectée et avec l’envoi en pause : rien ne pouvait partir.
Ce qu’est Harvey
| Repère | Valeur |
|---|---|
| Dépôt | ethanplusai/harvey, licence MIT, en Python |
| Création | 12 mars 2026 |
| Popularité au 5 novembre | 4 432 étoiles, 937 forks |
| Activité | 309 commits de l’auteur, une vingtaine de contributeurs extérieurs, dernier envoi le 2 novembre, 45 tickets ou propositions ouverts |
| Interface | ligne de commande, tableau de bord, option Docker |
Harvey se passe de clé d’API. Il pilote la ligne de commande de votre abonnement, claude pour Claude Code ou codex pour une offre ChatGPT, avec les outils du modèle désactivés et dans un mode isolé : sans CLAUDE.md, hooks, skills, plugins ni MCP (il faut une version qui accepte l’option --safe-mode). Il se rationne pour vous laisser de la marge (réglage max_daily_claude_percent à 80 par défaut).
Comment il travaille
Toutes les 15 minutes, un « battement de cœur » choisit une tâche dans un ordre fixe : traiter les réponses, envoyer les campagnes, les rédiger, prospecter, sinon attendre. Une réponse de prospect passe toujours avant un nouvel envoi.
La prospection suit quatre étapes :
- Découvrir : OpenStreetMap par défaut, gratuit, ou des sources payantes comme DataForSEO Business Listings (environ 0,372 dollar les 1 000 résultats), Serper ou Scavio.
- Profiler : trois requêtes HTTP par entreprise, sans appel au modèle (page d’accueil, robots.txt, plan du site), plus les pages équipe et recrutement.
- Enrichir : trouver le dirigeant ou le décideur nommé sur le site même de l’entreprise, deux personnes au plus.
- Vérifier : déduire le modèle d’adresse de l’entreprise, tester un seul candidat et le classer vérifié, risqué, deviné ou invalide. Seules les adresses délivrables reçoivent un email.
Le rédacteur écrit des séquences de trois emails (moins de 75 mots pour les deux premiers, moins de 40 pour le troisième), avec une liste stricte d’expressions « qui sentent l’IA » interdites.
Ce qu’il faut copier : les garde-fous
À lire même si vous ne prospectez jamais par email.
- L’accord humain par défaut : chaque email sortant attend dans une file d’envoi, où vous l’approuvez (touche A) ou le rejetez (touche R).
- Un contrôle avant envoi sans modèle : des règles fixes rejettent une balise de fusion non remplacée, une expression interdite, une longueur excessive, trop de liens, du HTML, une adresse non délivrable ou un destinataire qui ne correspond pas à la base.
- Un pilote automatique sur demande : il faut taper « autopilot ». Même alors, Harvey retient tout email qui pointe vers un domaine qui n’est pas le vôtre ou qui cite ses propres instructions, sa parade contre des consignes plantées dans un site ou une réponse (l’injection de prompt par email décrite dans notre avis sur AgentMail).
- Des freins : harvey sending pause coupe les envois, un taux de rebond trop élevé les arrête, la montée en charge est progressive et la plage d’envoi suit le fuseau du destinataire.
- La franchise : si on lui demande s’il est une IA, Harvey répond la vérité.
- Des sources interdites : automatisation LinkedIn désactivée par défaut (conditions d’utilisation), aucune lecture de ycombinator.com, Crunchbase, PitchBook ou LinkedIn.
Côté délivrabilité, le README conseille un domaine d’envoi dédié, SPF, DKIM et DMARC, deux à quatre semaines de préchauffe, puis 10 à 20 emails par jour et par boîte ; les 50 envois quotidiens réglés par défaut sont un plafond. Une réserve : le service de préchauffe payant qu’il recommande (TrulyInbox) l’est par un lien d’affiliation.
Notre test : des courtiers en assurance à Marseille et Lyon
Installation et apprentissage du produit
Harvey demande Python 3.13 et a accepté la 3.12 (le README annonce 3.11 et plus) ; environnement virtuel et installation en 8 secondes.
L’apprentissage du produit (harvey train) sur olead.fr, une place de marché française qui vend des leads d’assurance à des courtiers (éditée par la même société que ce blog), a échoué : notre session Claude en ligne de commande était déconnectée, et Harvey n’a affiché qu’un message vide, « Claude exited with code 1: ». La vraie cause, une session OAuth expirée, n’apparaissait que dans la sortie JSON de la ligne de commande. Son robot devine des chemins anglais (/about, /pricing, /features) et a récupéré 15 fois la même coquille d’application. Harvey n’a aucun réglage de langue : consignes en anglais, pages demandées en en-US, désinscription par défaut en anglais.
La recherche d’entreprises : 0, puis 35
Sans modification, la recherche renvoie 0 résultat : OpenStreetMap n’a pas de catégorie « insurance broker », explique le message. Une correction d’une ligne (la balise office=insurance) donne 40 résultats, soit 35 entreprises après dédoublonnage.
| Étape | Résultat |
|---|---|
| Entreprises trouvées | 35 |
| Avec un site web | 19 (54 %) |
| Pertinentes pour une cible de courtiers (notre estimation d’après noms et enseignes) | environ 18 : une douzaine de courtiers ou réseaux de courtage, 6 agences d’agents généraux |
| Agences salariées de grandes mutuelles, du bruit pour cette cible | 17 |
| Résultats « Lyon » situés en réalité à Vienne (Isère) | 9 sur 16 |
| Dirigeants identifiés | 0 |
| Adresses email trouvées | 0 |
Les résultats de Vienne viennent de la requête, qui prend les 20 premières entrées du rayon et non les plus proches. Un miroir public d’OpenStreetMap a aussi échoué (erreur 502) : il a fallu relancer Lyon.
L’enrichissement : 170 requêtes, personne
Sur les 19 sites, Harvey a envoyé 170 requêtes HTTP, dont 57 en erreur 404. Il essaie /about, /team, /our-team ou /contact-us, jamais /mentions-legales, /qui-sommes-nous, /notre-equipe ou /a-propos. Sans décideur nommé ni adresse, la vérification n’a jamais tourné et l’export est sorti vide (0 ligne). Son registre classe 8 entreprises en « formulaire de contact seulement », 11 en « aucune personne nommée », et 16 n’ont pas de site.
La contre-épreuve
Les informations existaient pourtant : sur 10 des 19 sites, les pages françaises contenaient « gérant », « agent général », « courtier » ou « directeur de la publication ». Même nourri de ces pages, l’extracteur n’a trouvé personne. Sur des cas aux noms fictifs, il a extrait 0 nom français sur 10, contre 2 témoins anglais sur 2. Le code explique l’écart :
- Les noms ne sont reconnus qu’en ASCII avec une majuscule initiale : un prénom accentué ou un nom de famille en capitales est rejeté.
- « Gérant », « Président » et « Fondateur » ne comptent pas comme titres de dirigeant.
- Parmi les liens de menu français, seul /contact est suivi.
- Une adresse nominative publiée sur le site, ou une adresse sur un autre domaine, est écartée : seules les génériques (info@, contact@) du domaine du site sont gardées.
Ce qui casse aussi côté conformité
- La désinscription : le validateur a refusé 4 formulations françaises sur 5. Seule « Pas intéressé ? Reply STOP. » est passée, car il ne reconnaît que des mots anglais, hébreux et espagnols.
- Les réponses : en français, seul un « STOP » isolé est détecté par une règle fixe (1 formulation sur 10 dans notre test). « Non merci », « Désinscrivez-moi » ou « Merci de ne plus me contacter » reposent sur le seul jugement du modèle.
- Le fuseau : la France manque à la table pays-fuseau, qui retombe sur America/New_York ; il faut régler Europe/Paris vous-même.
- Les expressions interdites sont listées en anglais seulement, et le champ postal_address est pensé pour le droit américain.
- Sans clé de vérification payante (Reoon, ZeroBounce, Hunter), Harvey interroge directement le serveur de messagerie du destinataire sur le port 25, depuis votre adresse IP, avec verify@example.com comme expéditeur. À savoir pour la réputation de votre IP ; faute d’adresse candidate, ce n’est pas arrivé chez nous.
La rédaction n’a pas pu être testée : aucun prospect trouvé, et une session en ligne de commande déconnectée.
Le README cite le CAN-SPAM américain et l’intérêt légitime (RGPD, PECR britannique), avec une vérification optionnelle par destinataire via un service tiers, Precleared. En France, la CNIL admet la prospection par email entre professionnels sans consentement préalable si le message a un rapport avec l’activité professionnelle de la personne, qu’elle en est informée et qu’elle peut s’y opposer simplement (page de la CNIL). Une désinscription comprise seulement en anglais fragilise ce dernier point.
Ce qu’il faudrait pour des courtiers français
- Une source française à la place d’OpenStreetMap : le registre de l’ORIAS, ou l’API publique des entreprises filtrée sur le code NAF 66.22Z (activités des agents et courtiers d’assurances).
- Un fork de l’extracteur de personnes : accents, capitales, titres et chemins français, pages de mentions légales, adresse précise de l’agence conservée.
- Une clé de vérification d’email, pour ne pas sonder les serveurs depuis votre IP.
- La désinscription et la détection des réponses en français, et le fuseau Europe/Paris.
- Des règles de rédaction françaises : vouvoiement, identification claire de l’expéditeur.
Comptez plusieurs jours de travail sur un fork. La leçon dépasse Harvey : la qualité d’un agent tient aussi à sa chaîne de données et à la langue pour laquelle il a été écrit. Testez-le sur votre marché avant de vous fier au README.
Pour qui
- Une petite entreprise américaine qui prospecte des entreprises locales : c’est sa cible, et ses garde-fous limitent les dégâts d’un agent qui écrit à votre place.
- Quiconque construit un agent qui envoie des messages : son contrôle avant envoi et sa logique de mise en attente sont de bons modèles.
- En France, pas tel quel. Et comme le demande le README lui-même, vérifiez les conditions et les limites d’usage de votre offre Claude ou ChatGPT.
Notre verdict : marque-page
Harvey est l’un des agents de prospection open source les mieux pensés que nous ayons examinés. Son accord humain par défaut, son contrôle déterministe avant envoi et ses messages suspects retenus même en pilote automatique méritent d’être repris dans tout agent qui écrit au nom de quelqu’un. Mais il reste calibré pour les petites entreprises américaines : sur 35 entreprises d’assurance françaises, il n’a trouvé personne à qui écrire. Gardez-le en marque-page, lisez le code de ses garde-fous, et ne le branchez sur une vraie boîte qu’après l’avoir fait tourner en export seul sur votre propre cible.
Sources
À propos de l'auteur
Équipe MaitriseLIA
Experts en formation Claude Code, Anthropic API et outils d'IA professionnels. Nos contenus sont rédigés par des spécialistes qui utilisent Claude Code et les MCPs au quotidien pour automatiser leurs business.