Sobre el proyecto

# Tomba Email Finder CLI Tomba es una utilidad de línea de comandos que te ayuda a buscar y verificar direcciones de correo electrónico, enriquecer datos de contacto y descubrir números de teléfono. Proporciona una amplia gama de funciones para profesionales de ventas, marketing y reclutamiento. ## Características principales - **Búsqueda de correo electrónico**: Localiza instantáneamente direcciones de correo de cualquier sitio web o nombre de empresa. - **Verificación de correo electrónico**: Confirma la autenticidad y entregabilidad de una dirección de correo. - **Enriquecimiento**: Enriquece direcciones de correo con datos adicionales. - **Buscador de LinkedIn**: Descubre direcciones de correo a partir de URLs de LinkedIn. - **Buscador de autores**: Encuentra direcciones de correo de autores de artículos. - **Buscador de teléfonos**: Busca números de teléfono a partir de un correo, dominio o URL de LinkedIn. - **Validador de teléfonos**: Valida números de teléfono. - **Dominios similares**: Obtén dominios similares a un dominio específico. - **Detección de tecnología**: Descubre tecnologías utilizadas por un dominio. - **Búsqueda de empresas**: Busca empresas usando lenguaje natural o filtros estructurados. - **Información de cuenta**: Imprime la información de la cuenta actual. - **Chat con IA**: Consultas en lenguaje natural impulsadas por OpenAI con herramientas de Tomba. - **Procesamiento por lotes CSV**: Enriquece, verifica, encuentra, autores, LinkedIn, teléfonos y fuentes desde archivos CSV con mapeo automático de columnas. - **Habilidades ClawHub**: Flujos de trabajo reutilizables de varios pasos que encadenan llamadas API en un solo comando. ## Instalación Tomba se puede instalar mediante varios métodos: - **Instalación rápida (Linux/macOS)**: `curl -sSL https://releases.tomba.io/install.sh | sh` - **Instalación rápida (Windows PowerShell)**: `irm https://releases.tomba.io/install.ps1 | iex` - **Snap**: `sudo snap install tomba` - **Go**: `go install github.com/tomba-io/tomba@latest` - **Homebrew**: `brew install tomba-io/tap/tomba` - **Scoop**: `scoop bucket add tomba https://github.com/tomba-io/scoop-bucket.git && scoop install tomba` ## Primeros pasos Después de la instalación, debes iniciar sesión en tu cuenta de Tomba. Hay dos métodos disponibles: - **OAuth (basado en navegador)**: `tomba login` - **Clave API + Secreto**: `tomba login --key ta_xxxx --secret ts_xxxx` ## Comandos principales ### Búsqueda de dominio bash tomba search --target "tomba.io" ### Buscador de correo electrónico bash tomba finder --target "tomba.io" --first "mohamed" --last "ben rebia" tomba finder --target "tomba.io" --full "Mohamed Ben Rebia" ### Enriquecimiento bash tomba enrich --target "b.mohamed@tomba.io" ### Buscador de autores bash tomba author --target "https://clearbit.com/blog/company-name-to-domain-api" ### Buscador de LinkedIn bash tomba linkedin --target "https://www.linkedin.com/in/mohamed-ben-rebia" ### Fuentes de correo electrónico bash tomba sources --target "ab@tomba.io" ### Verificador de correo electrónico bash tomba verify --target "b.mohamed@tomba.io" ### Conteo bash tomba count --target "tomba.io" ### Estado bash tomba status --target "tomba.io" ### Buscador de teléfonos bash tomba phone-finder --email "wade@zapier.com" tomba phone-finder --domain "tomba.io" tomba phone-finder --linkedin "https://www.linkedin.com/in/alex-maccaw-ab592978" ### Validador de teléfonos bash tomba phone-validator --phone "+14155552671" tomba phone-validator --phone "4155552671" --country-code US ### Búsqueda de empresas (Reveal) bash tomba reveal --query "SaaS startups in Europe" tomba reveal --country US,UK --industry Technology ### Dominios similares bash tomba similar --target "tomba.io" ### Detección de tecnología bash tomba technology --target "tomba.io" ### Información de cuenta bash tomba whoami ## Comandos adicionales - **Formato de correo**: `tomba format -t stripe.com` - **Ubicación de empleados**: `tomba location -t stripe.com` - **Sugerencias de dominio**: `tomba autocomplete -t "goo"` - **Enriquecimiento**: `tomba enrichment person -t user@example.com`, `tomba enrichment company -t example.com`, `tomba enrichment combined -t user@example.com` - **Gestión de clientes potenciales**: `tomba lead list`, `tomba lead create --email user@example.com --list-id 1`, `tomba lead get --id 123` - **Claves API**: `tomba key list`, `tomba key create`, `tomba key delete --id 123` - **Atributos**: `tomba attribute list`, `tomba attribute create --name "Company Size" --type "text"` - **Banderas**: `tomba flag list`, `tomba flag create --type email --value bounce@example.com --reason hard_bounce` ## Chat con IA Tomba incluye una interfaz de chat con IA que utiliza llamadas de funciones de OpenAI para encadenar herramientas de la API de Tomba. Puedes hacer preguntas en lenguaje natural y obtener resultados. bash export OPENAI_API_KEY=sk-... tomba chat Ejemplo de sesión: Tú: Encuentra al VP de Ventas en Stripe y obtén su correo flujo de trabajo: domain_search -> email_finder -> email_verifier ## Resultados **Correo encontrado:** d.singleton@stripe.com **Verificado:** entregable (puntuación: 95) Modo por lotes vía chat: bash tomba chat --file contacts.csv --type enrich tomba chat --model gpt-4o-mini ## Procesamiento por lotes CSV Procesa archivos CSV en lotes con trabajadores concurrentes, mapeo automático de columnas y respetando los límites de tasa de API. bash tomba bulk --file contacts.csv --type enrich Los tipos de operación admitidos incluyen: enrich, verify, finder, search, author, linkedin, phone, phone-validator, company, similar y sources. La concurrencia se detecta automáticamente según tu plan (máximo 60 trabajadores). ## Habilidades ClawHub ClawHub es un sistema de habilidades integrado que encadena múltiples llamadas de API de Tomba en flujos de trabajo reutilizables. bash tomba skill list tomba skill run find-email --target stripe.com first_name=David last_name=Singleton tomba skill run company-intel --target tomba.io Las habilidades integradas incluyen: find-email, company-emails, enrich-verify, company-intel, lead-gen, linkedin-intel, domain-check y author-verify. También puedes crear, importar, exportar y eliminar habilidades personalizadas. ## Servidor HTTP Ejecuta un servidor HTTP local que expone todos los endpoints de la API de Tomba como proxy inverso. bash tomba http # inicia en el puerto 3000 tomba http --port 8080 # puerto personalizado El servidor expone 45 rutas que cubren todos los endpoints principales de la API, CRUD de clientes potenciales y gestión de listas de clientes potenciales, atributos, claves y banderas. ## Formatos de salida La mayoría de los comandos admiten formatos de salida JSON y YAML para facilitar la integración con otras herramientas. ## Actualización y versión - **Actualizar**: `tomba update` (también disponible como `tomba upgrade`) - **Versión**: `tomba version` ## Resumen Tomba es una herramienta CLI completa para descubrimiento, verificación y enriquecimiento de correos electrónicos. Está diseñada para profesionales de ventas, marketing y reclutamiento que necesitan encontrar y validar información de contacto rápidamente. Con soporte para procesamiento por lotes, chat con IA y flujos de trabajo reutilizables, se puede integrar en varios pipelines de automatización.