Cold Email Verifier

Indovina le permutazioni di email aziendali da un CSV di lead e verifica la consegnabilità

di Varnan-Tech · Varnan-Tech/opendirectory

Richiede configurazione ★ 8.0/10

Cold Email Verifier — Indovina le permutazioni di email aziendali da un CSV di lead e verifica la consegnabilità

Cosa fa

Una skill Python che legge un CSV di lead (Nome, Cognome, Nome Azienda), risolve il dominio di ogni azienda tramite l'API Clearbit autocomplete, genera tre permutazioni email comuni e verifica la consegnabilità tramite l'API ValidEmail.co o un backend Reacher self-hosted. Si attiva quando l'utente chiede di verificare email fredde, indovinare indirizzi email da nomi/aziende o arricchire una lista di lead. La verifica richiede una chiave API ValidEmail.co o un server Reacher self-hosted con porta 25 in uscita.

Rapporto di test

Clonato il repository, confermato che tutti i file referenziati nel corpo esistono (SKILL.md, scripts/email_verifier.py, requirements.txt, .env.example tutti HTTP 200; requests+pandas installati localmente). Eseguito email_verifier.py in modalità --test su un CSV volutamente disordinato di 2 righe: ha normalizzato correttamente il dominio https://www.acme.com/about in acme.com e rimosso il trattino da Marie-Claire, ma ha forzato un Cognome vuoto nella stringa "nan", emettendo permutazioni spazzatura john.nan@stripe.com e johnnan@stripe.com. La baseline (generata a mano) avrebbe prodotto solo john@stripe.com, quindi lo script vince sulla normalizzazione URL/punteggiatura ma ha un vero bug sui campi vuoti. Verdetto: setup, perché la verifica effettiva (il cuore della skill) richiede una chiave API ValidEmail.co o un server Reacher self-hosted con porta 25, nessuno dei quali eseguibile qui; è stato misurato solo il motore di indovinamento. Nessun problema di sicurezza: chiavi lette da env, gli endpoint sono i documentati Clearbit/ValidEmail/localhost, nessun curl|sh o esfiltrazione.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

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

Comandi e prompt di esempio

/cold-email-verifierIndovina le permutazioni di email aziendali da un CSV di lead e verifica la consegnabilità

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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

Rapporto completo →