Sobre o projeto

# Tomba Email Finder CLI Tomba é um utilitário de linha de comando que ajuda a pesquisar e verificar endereços de e-mail, enriquecer dados de contato e descobrir números de telefone. Ele oferece uma ampla gama de recursos para profissionais de vendas, marketing e recrutamento. ## Principais Recursos - **Pesquisa de E-mail**: Localize instantaneamente endereços de e-mail em qualquer site ou nome de empresa. - **Verificação de E-mail**: Confirme a autenticidade e entregabilidade de um endereço de e-mail. - **Enriquecimento**: Enriqueça endereços de e-mail com dados adicionais. - **LinkedIn Finder**: Descubra endereços de e-mail a partir de URLs do LinkedIn. - **Author Finder**: Encontre endereços de e-mail de autores de artigos. - **Phone Finder**: Pesquise números de telefone a partir de um e-mail, domínio ou URL do LinkedIn. - **Validador de Telefone**: Valide números de telefone. - **Domínios Semelhantes**: Recupere domínios semelhantes a um domínio específico. - **Detecção de Tecnologia**: Descubra tecnologias usadas por um domínio. - **Pesquisa de Empresas**: Pesquise empresas usando linguagem natural ou filtros estruturados. - **Informações da Conta**: Imprima informações atuais da conta. - **Chat com IA**: Consultas em linguagem natural alimentadas por OpenAI com ferramentas Tomba. - **Processamento em Lote de CSV**: Enriqueça, verifique, encontre, autores, LinkedIn, telefones e fontes a partir de arquivos CSV com mapeamento automático de colunas. - **Habilidades ClawHub**: Workflows reutilizáveis de várias etapas que encadeiam chamadas de API em um único comando. ## Instalação Tomba pode ser instalado por vários métodos: - **Instalação Rápida (Linux/macOS)**: `curl -sSL https://releases.tomba.io/install.sh | sh` - **Instalação 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` ## Primeiros Passos Após a instalação, você precisa fazer login na sua conta Tomba. Dois métodos estão disponíveis: - **OAuth (baseado em navegador)**: `tomba login` - **Chave de API + Segredo**: `tomba login --key ta_xxxx --secret ts_xxxx` ## Comandos Principais ### Pesquisa de Domínio bash tomba search --target "tomba.io" ### Localizador de E-mail bash tomba finder --target "tomba.io" --first "mohamed" --last "ben rebia" tomba finder --target "tomba.io" --full "Mohamed Ben Rebia" ### Enriquecimento bash tomba enrich --target "b.mohamed@tomba.io" ### Localizador de Autor bash tomba author --target "https://clearbit.com/blog/company-name-to-domain-api" ### Localizador do LinkedIn bash tomba linkedin --target "https://www.linkedin.com/in/mohamed-ben-rebia" ### Fontes de E-mail bash tomba sources --target "ab@tomba.io" ### Verificador de E-mail bash tomba verify --target "b.mohamed@tomba.io" ### Contagem bash tomba count --target "tomba.io" ### Status bash tomba status --target "tomba.io" ### Localizador de Telefone 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 Telefone bash tomba phone-validator --phone "+14155552671" tomba phone-validator --phone "4155552671" --country-code US ### Pesquisa de Empresas (Reveal) bash tomba reveal --query "SaaS startups in Europe" tomba reveal --country US,UK --industry Technology ### Domínios Semelhantes bash tomba similar --target "tomba.io" ### Detecção de Tecnologia bash tomba technology --target "tomba.io" ### Informações da Conta bash tomba whoami ## Comandos Adicionais - **Formato de E-mail**: `tomba format -t stripe.com` - **Localização de Funcionários**: `tomba location -t stripe.com` - **Sugestões de Domínio**: `tomba autocomplete -t "goo"` - **Enriquecimento**: `tomba enrichment person -t user@example.com`, `tomba enrichment company -t example.com`, `tomba enrichment combined -t user@example.com` - **Gerenciamento de Leads**: `tomba lead list`, `tomba lead create --email user@example.com --list-id 1`, `tomba lead get --id 123` - **Chaves de API**: `tomba key list`, `tomba key create`, `tomba key delete --id 123` - **Atributos**: `tomba attribute list`, `tomba attribute create --name "Company Size" --type "text"` - **Flags**: `tomba flag list`, `tomba flag create --type email --value bounce@example.com --reason hard_bounce` ## Chat com IA Tomba inclui uma interface de chat com IA que usa chamadas de função OpenAI para encadear ferramentas da API Tomba. Você pode fazer perguntas em linguagem natural e obter resultados. bash export OPENAI_API_KEY=sk-... tomba chat Exemplo de sessão: Você: Encontre o VP de Vendas da Stripe e obtenha o e-mail dele workflow: domain_search -> email_finder -> email_verifier ## Resultados **E-mail encontrado:** d.singleton@stripe.com **Verificado:** entregável (pontuação: 95) Modo em lote via chat: bash tomba chat --file contacts.csv --type enrich tomba chat --model gpt-4o-mini ## Processamento em Lote de CSV Processe arquivos CSV em lote com trabalhadores concorrentes, mapeamento automático de colunas e respeitando os limites de taxa da API. bash tomba bulk --file contacts.csv --type enrich Os tipos de operação suportados incluem: enrich, verify, finder, search, author, linkedin, phone, phone-validator, company, similar e sources. A concorrência é detectada automaticamente do seu plano (máx. 60 trabalhadores). ## Habilidades ClawHub ClawHub é um sistema de habilidades integrado que encadeia várias chamadas de API Tomba em workflows reutilizáveis. 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 As habilidades integradas incluem: find-email, company-emails, enrich-verify, company-intel, lead-gen, linkedin-intel, domain-check e author-verify. Você também pode criar, importar, exportar e remover habilidades personalizadas. ## Servidor HTTP Execute um servidor HTTP local expondo todos os endpoints da API Tomba como um proxy reverso. bash tomba http # inicia na porta 3000 tomba http --port 8080 # porta personalizada O servidor expõe 45 rotas cobrindo todos os endpoints principais da API, CRUD de leads e gerenciamento de listas de leads, atributos, chaves e flags. ## Formatos de Saída A maioria dos comandos suporta formatos de saída JSON e YAML para fácil integração com outras ferramentas. ## Atualização e Versão - **Atualização**: `tomba update` (também disponível como `tomba upgrade`) - **Versão**: `tomba version` ## Resumo Tomba é uma ferramenta CLI abrangente para descoberta, verificação e enriquecimento de e-mails. É projetada para profissionais de vendas, marketing e recrutamento que precisam encontrar e validar informações de contato rapidamente. Com suporte para processamento em lote, chat com IA e workflows reutilizáveis, pode ser integrada em vários pipelines de automação.