Cold Email Verifier

Devine les permutations d'e-mails d'entreprise à partir d'un CSV de prospects et vérifie la délivrabilité

par Varnan-Tech · Varnan-Tech/opendirectory

Fonctionne avec configuration ★ 8.0/10

Cold Email Verifier — Devine les permutations d'e-mails d'entreprise à partir d'un CSV de prospects et vérifie la délivrabilité

Ce que fait

Une compétence Python qui lit un CSV de prospects (First Name, Last Name, Company Name), résout le domaine de chaque entreprise via l'API d'autocomplétion Clearbit, génère trois permutations d'e-mails courantes et vérifie la délivrabilité via l'API ValidEmail.co ou un backend Reacher auto-hébergé. Se déclenche lorsque l'utilisateur demande de vérifier des e-mails de prospection, de deviner des adresses e-mail à partir de noms/entreprises, ou d'enrichir une liste de prospects. La vérification nécessite une clé API ValidEmail.co ou un serveur Reacher auto-hébergé avec le port sortant 25.

Rapport de test

Cloned le dépôt, confirmé que tous les fichiers référencés dans le corps existent (SKILL.md, scripts/email_verifier.py, requirements.txt, .env.example tous HTTP 200 ; requests+pandas installés localement). Exécuté email_verifier.py en mode --test sur un CSV délibérément désordonné de 2 lignes : il a correctement normalisé le domaine https://www.acme.com/about en acme.com et supprimé le trait d'union de Marie-Claire, mais a converti un nom de famille vide en la chaîne "nan", émettant des permutations indésirables john.nan@stripe.com et johnnan@stripe.com. La référence (générée manuellement) aurait produit uniquement john@stripe.com, donc le script l'emporte sur la normalisation URL/ponctuation mais présente un véritable bug de champ vide. Verdict : configuration requise car la vérification réelle (le cœur de la compétence) nécessite une clé API ValidEmail.co ou un serveur Reacher auto-hébergé avec le port 25, aucun des deux n'étant exécutable ici ; seul le moteur de devinette a été mesuré. Aucune faille de sécurité : clés lues depuis env, les points de terminaison sont les Clearbit/ValidEmail/localhost documentés, pas de curl|sh ni d'exfiltration.

Testé le: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

git clone --depth 1 https://github.com/Varnan-Tech/opendirectory.git /tmp/cold-email-verifier-src
mkdir -p ~/.claude/skills
cp -R /tmp/cold-email-verifier-src/skills/cold-email-verifier ~/.claude/skills/cold-email-verifier
# Python deps: pip install -r ~/.claude/skills/cold-email-verifier/requirements.txt   (requests, pandas)
# Verification needs EITHER a ValidEmail.co API key: export VALIDEMAIL_API_KEY="..."  (--mode validemail)
#   OR a self-hosted Reacher backend with outbound port 25 open (--mode reacher-http --reacher-url http://IP:8080/v0/check_email)
# Permutation generation alone runs offline with no key: python scripts/email_verifier.py --input leads.csv --output out.csv --mode validemail --test
# Plugin-marketplace alternative: /plugin marketplace add Varnan-Tech/opendirectory ; /plugin install opendirectory-gtm-skills@opendirectory-marketplace

Commandes et exemples de prompts

/cold-email-verifierDevine les permutations d'e-mails d'entreprise à partir d'un CSV de prospects et vérifie la délivrabilité

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

Verify the emails in this lead CSV
Guess email addresses for these contacts
Enrich this lead list with verified emails

Rapport complet →