// tomba cli
Email Intelligence dal Tuo Terminale
Cerca domini, trova email, verifica indirizzi e arricchisci contatti tutto senza lasciare il tuo terminale. Installazione con un comando. Funziona su macOS, Linux e Windows.
$ tomba verify --target richard@piedpiper.com --json
{
"data": {
"email": {
"email": "richard@piedpiper.com",
"result": "deliverable",
"status": "valid",
"score": 99
}
}
}// 01 · installazione
Un solo binario per macOS, Linux e Windows
Gli script di installazione controllano il checksum SHA-256 della release e configurano il completamento della shell. Le release sono su GitHub.
curl -sSL https://releases.tomba.io/install.sh | shbrew install --cask tomba-io/tap/tombairm https://releases.tomba.io/install.ps1 | iexscoop bucket add tomba https://github.com/tomba-io/scoop-bucket.git
scoop install tombasudo snap install tomba// 02 · comandi
Ogni endpoint dal terminale
Passa l'input con --target; aggiungi --json, --yaml o --csv per un output leggibile dalle macchine e --output per scrivere un file.
tomba searchGli indirizzi email che Tomba ha per un dominio
GET /v1/domain-searchtomba finderL'email di una persona dal nome e dal dominio aziendale
GET /v1/email-findertomba authorL'email dell'autore di un articolo
GET /v1/author-findertomba enrichLa persona dietro un indirizzo email
GET /v1/enrichtomba enrichment personIl profilo di una persona da un'email
GET /v1/people/findtomba enrichment companyIl profilo di un'azienda da un dominio
GET /v1/companies/findtomba enrichment combinedPersona e azienda in una sola richiesta
GET /v1/combined/findtomba verifySe un indirizzo email è recapitabile
GET /v1/email-verifiertomba linkedinL'email di un profilo LinkedIn
GET /v1/linkedintomba sourcesLe pagine pubbliche in cui è stato trovato un indirizzo
GET /v1/email-sourcestomba countIndirizzi di un dominio, per reparto e anzianità
GET /v1/email-counttomba statusSe un dominio è webmail o usa e getta
GET /v1/domain-statustomba formatI formati di indirizzo usati da un dominio
GET /v1/email-formattomba locationIl numero di dipendenti di un'azienda per sede
GET /v1/locationtomba autocompleteAziende e domini da una parte del nome
GET /v1/domain-suggestionstomba phone-finderNumeri di telefono da un'email, un dominio o un profilo LinkedIn
GET /v1/phone-findertomba phone-validatorSe un numero di telefono è valido, i suoi formati e l'operatore
GET /v1/phone-validatortomba revealAziende da una query in linguaggio naturale o da filtri
POST /v1/reveal/searchtomba similarAziende simili a un dominio
GET /v1/similartomba technologyLe tecnologie sul sito web di un dominio
GET /v1/technologytomba lead · leads-list · attributeGestisci lead, liste di lead e attributi personalizzati
/v1/leads, /v1/leads_lists, /v1/attributestomba flag create · listSegnala dati errati ed elenca le tue segnalazioni
POST /v1/flag, GET /v1/flagtomba key list · get · create · deleteGestisci le chiavi API del tuo workspace
/v1/keystomba whoami · usage · logsIl tuo account, l'utilizzo giornaliero e le richieste recenti
GET /v1/me, /v1/usage, /v1/logs
| Comando | Restituisce | Chiama |
|---|---|---|
| tomba search | Gli indirizzi email che Tomba ha per un dominio | GET /v1/domain-search |
| tomba finder | L'email di una persona dal nome e dal dominio aziendale | GET /v1/email-finder |
| tomba author | L'email dell'autore di un articolo | GET /v1/author-finder |
| tomba enrich | La persona dietro un indirizzo email | GET /v1/enrich |
| tomba enrichment person | Il profilo di una persona da un'email | GET /v1/people/find |
| tomba enrichment company | Il profilo di un'azienda da un dominio | GET /v1/companies/find |
| tomba enrichment combined | Persona e azienda in una sola richiesta | GET /v1/combined/find |
| tomba verify | Se un indirizzo email è recapitabile | GET /v1/email-verifier |
| tomba linkedin | L'email di un profilo LinkedIn | GET /v1/linkedin |
| tomba sources | Le pagine pubbliche in cui è stato trovato un indirizzo | GET /v1/email-sources |
| tomba count | Indirizzi di un dominio, per reparto e anzianità | GET /v1/email-count |
| tomba status | Se un dominio è webmail o usa e getta | GET /v1/domain-status |
| tomba format | I formati di indirizzo usati da un dominio | GET /v1/email-format |
| tomba location | Il numero di dipendenti di un'azienda per sede | GET /v1/location |
| tomba autocomplete | Aziende e domini da una parte del nome | GET /v1/domain-suggestions |
| tomba phone-finder | Numeri di telefono da un'email, un dominio o un profilo LinkedIn | GET /v1/phone-finder |
| tomba phone-validator | Se un numero di telefono è valido, i suoi formati e l'operatore | GET /v1/phone-validator |
| tomba reveal | Aziende da una query in linguaggio naturale o da filtri | POST /v1/reveal/search |
| tomba similar | Aziende simili a un dominio | GET /v1/similar |
| tomba technology | Le tecnologie sul sito web di un dominio | GET /v1/technology |
| tomba lead · leads-list · attribute | Gestisci lead, liste di lead e attributi personalizzati | /v1/leads, /v1/leads_lists, /v1/attributes |
| tomba flag create · list | Segnala dati errati ed elenca le tue segnalazioni | POST /v1/flag, GET /v1/flag |
| tomba key list · get · create · delete | Gestisci le chiavi API del tuo workspace | /v1/keys |
| tomba whoami · usage · logs | Il tuo account, l'utilizzo giornaliero e le richieste recenti | GET /v1/me, /v1/usage, /v1/logs |
// 03 · in blocco
Elabora un CSV dal tuo computer
tomba bulk invia una richiesta API per riga e scrive i risultati in un nuovo CSV man mano che le righe vengono completate. Ogni riga è fatturata e soggetta ai limiti di frequenza come una singola richiesta; per i job lato server, usa la Bulk API.
# One API request per row, from your machine
tomba bulk --file leads.csv --type verify --column "Email Address"
tomba bulk --file prospects.csv --type finder --domain-col company_domain --first-col first --last-col last
tomba bulk --file domains.csv --type search --domain-col domain --output domain-search.csv- tomba bulk
- Viene eseguito sul tuo computer, una richiesta per riga, ognuna fatturata come una singola chiamata
- POST /v1/bulk/{type}
- Viene eseguito sui server di Tomba come un unico job, fatturato al primo download
// 04 · accesso
Accesso dal browser o una chiave API
tomba login usa il device flow di OAuth 2.0, quindi funziona anche via SSH; per gli script, accedi con una chiave. Le credenziali vengono salvate in ~/.tomba.json.
tomba logintomba login --api-key
tomba whoamitomba verify --target richard@piedpiper.com --key "$TOMBA_API_KEY" --secret "$TOMBA_SECRET_KEY"--json, --yaml o --csv per un output leggibile dalle macchine. Invialo in pipe a jq per filtrare, reindirizzalo su file o usalo in script shell, cron job e pipeline CI/CD.