// tomba cli
Inteligencia de email desde tu terminal
Busca dominios, encuentra emails, verifica direcciones y enriquece contactos, todo sin salir de tu terminal. Instalacion en un solo comando. Compatible con macOS, Linux y Windows.
$ tomba verify --target richard@piedpiper.com --json
{
"data": {
"email": {
"email": "richard@piedpiper.com",
"result": "deliverable",
"status": "valid",
"score": 99
}
}
}// 01 · instalación
Un único binario para macOS, Linux y Windows
Los scripts de instalación comprueban el checksum SHA-256 de la versión y configuran el autocompletado del shell. Las versiones están en 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 · comandos
Todos los endpoints desde la terminal
Pasa la entrada con --target; añade --json, --yaml o --csv para una salida legible por máquina y --output para escribir un archivo.
tomba searchLas direcciones de email que Tomba tiene para un dominio
GET /v1/domain-searchtomba finderEl email de una persona a partir de su nombre y el dominio de su empresa
GET /v1/email-findertomba authorEl email del autor de un artículo
GET /v1/author-findertomba enrichLa persona detrás de una dirección de email
GET /v1/enrichtomba enrichment personUn perfil de persona a partir de un email
GET /v1/people/findtomba enrichment companyUn perfil de empresa a partir de un dominio
GET /v1/companies/findtomba enrichment combinedPersona y empresa en una sola solicitud
GET /v1/combined/findtomba verifySi una dirección de email es entregable
GET /v1/email-verifiertomba linkedinEl email de un perfil de LinkedIn
GET /v1/linkedintomba sourcesLas páginas públicas donde se encontró una dirección
GET /v1/email-sourcestomba countDirecciones de un dominio, por departamento y nivel jerárquico
GET /v1/email-counttomba statusSi un dominio es de webmail o desechable
GET /v1/domain-statustomba formatLos patrones de dirección que usa un dominio
GET /v1/email-formattomba locationEl número de empleados de una empresa por ubicación
GET /v1/locationtomba autocompleteEmpresas y dominios a partir de parte de un nombre
GET /v1/domain-suggestionstomba phone-finderNúmeros de teléfono a partir de un email, un dominio o un perfil de LinkedIn
GET /v1/phone-findertomba phone-validatorSi un número de teléfono es válido, sus formatos y su operador
GET /v1/phone-validatortomba revealEmpresas a partir de una consulta en lenguaje natural o de filtros
POST /v1/reveal/searchtomba similarEmpresas similares a un dominio
GET /v1/similartomba technologyLas tecnologías del sitio web de un dominio
GET /v1/technologytomba lead · leads-list · attributeGestiona leads, listas de leads y atributos personalizados
/v1/leads, /v1/leads_lists, /v1/attributestomba flag create · listReporta datos incorrectos y lista tus reportes
POST /v1/flag, GET /v1/flagtomba key list · get · create · deleteGestiona las claves API de tu espacio de trabajo
/v1/keystomba whoami · usage · logsTu cuenta, el uso diario y las solicitudes recientes
GET /v1/me, /v1/usage, /v1/logs
| Comando | Devuelve | Llama a |
|---|---|---|
| tomba search | Las direcciones de email que Tomba tiene para un dominio | GET /v1/domain-search |
| tomba finder | El email de una persona a partir de su nombre y el dominio de su empresa | GET /v1/email-finder |
| tomba author | El email del autor de un artículo | GET /v1/author-finder |
| tomba enrich | La persona detrás de una dirección de email | GET /v1/enrich |
| tomba enrichment person | Un perfil de persona a partir de un email | GET /v1/people/find |
| tomba enrichment company | Un perfil de empresa a partir de un dominio | GET /v1/companies/find |
| tomba enrichment combined | Persona y empresa en una sola solicitud | GET /v1/combined/find |
| tomba verify | Si una dirección de email es entregable | GET /v1/email-verifier |
| tomba linkedin | El email de un perfil de LinkedIn | GET /v1/linkedin |
| tomba sources | Las páginas públicas donde se encontró una dirección | GET /v1/email-sources |
| tomba count | Direcciones de un dominio, por departamento y nivel jerárquico | GET /v1/email-count |
| tomba status | Si un dominio es de webmail o desechable | GET /v1/domain-status |
| tomba format | Los patrones de dirección que usa un dominio | GET /v1/email-format |
| tomba location | El número de empleados de una empresa por ubicación | GET /v1/location |
| tomba autocomplete | Empresas y dominios a partir de parte de un nombre | GET /v1/domain-suggestions |
| tomba phone-finder | Números de teléfono a partir de un email, un dominio o un perfil de LinkedIn | GET /v1/phone-finder |
| tomba phone-validator | Si un número de teléfono es válido, sus formatos y su operador | GET /v1/phone-validator |
| tomba reveal | Empresas a partir de una consulta en lenguaje natural o de filtros | POST /v1/reveal/search |
| tomba similar | Empresas similares a un dominio | GET /v1/similar |
| tomba technology | Las tecnologías del sitio web de un dominio | GET /v1/technology |
| tomba lead · leads-list · attribute | Gestiona leads, listas de leads y atributos personalizados | /v1/leads, /v1/leads_lists, /v1/attributes |
| tomba flag create · list | Reporta datos incorrectos y lista tus reportes | POST /v1/flag, GET /v1/flag |
| tomba key list · get · create · delete | Gestiona las claves API de tu espacio de trabajo | /v1/keys |
| tomba whoami · usage · logs | Tu cuenta, el uso diario y las solicitudes recientes | GET /v1/me, /v1/usage, /v1/logs |
// 03 · masivo
Procesa un CSV desde tu equipo
tomba bulk envía una solicitud a la API por fila y escribe los resultados en un nuevo CSV a medida que se completan las filas. Cada fila se factura y se limita como una solicitud individual; para trabajos en el servidor, 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
- Se ejecuta en tu equipo, una solicitud por fila, cada una facturada como una llamada individual
- POST /v1/bulk/{type}
- Se ejecuta en los servidores de Tomba como un solo trabajo, facturado en la primera descarga
// 04 · iniciar sesión
Inicio de sesión en el navegador o una clave API
tomba login usa el flujo de dispositivo de OAuth 2.0, así que funciona por SSH; para scripts, inicia sesión con una clave. Las credenciales se guardan en ~/.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 para obtener una salida legible por máquinas. Envíala a jq para filtrar, redirígela a archivos o úsala en scripts de shell, tareas cron y pipelines de CI/CD.