tomba

# Tomba Email Finder CLI Tomba is a command-line utility that helps you search for and verify email addresses, enrich contact data, and discover phone numbers. It provides a wide range of features for sales, marketing, and recruitment professionals. ## Key Features - **Email Search**: Instantly locate email addresses from any website or company name. - **Email Verification**: Confirm an email address's authenticity and deliverability. - **Enrichment**: Enrich email addresses with additional data. - **LinkedIn Finder**: Discover email addresses from LinkedIn URLs. - **Author Finder**: Find email addresses of article authors. - **Phone Finder**: Search for phone numbers given an email, domain, or LinkedIn URL. - **Phone Validator**: Validate phone numbers. - **Similar Domains**: Retrieve domains similar to a specific domain. - **Technology Detection**: Discover technologies used by a domain. - **Company Search**: Search for companies using natural language or structured filters. - **Account Info**: Print current account information. - **AI Chat**: Natural language queries powered by OpenAI with Tomba tools. - **Bulk CSV Processing**: Enrich, verify, find, author, linkedin, phone, and sources from CSV files with auto column mapping. - **ClawHub Skills**: Reusable multi-step workflows that chain API calls into one command. ## Installation Tomba can be installed via several methods: - **Quick Install (Linux/macOS)**: `curl -sSL https://releases.tomba.io/install.sh | sh` - **Quick Install (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` ## Getting Started After installation, you need to log in to your Tomba account. Two methods are available: - **OAuth (browser-based)**: `tomba login` - **API Key + Secret**: `tomba login --key ta_xxxx --secret ts_xxxx` ## Core Commands ### Domain Search bash tomba search --target "tomba.io" ### Email Finder bash tomba finder --target "tomba.io" --first "mohamed" --last "ben rebia" tomba finder --target "tomba.io" --full "Mohamed Ben Rebia" ### Enrichment bash tomba enrich --target "b.mohamed@tomba.io" ### Author Finder bash tomba author --target "https://clearbit.com/blog/company-name-to-domain-api" ### LinkedIn Finder bash tomba linkedin --target "https://www.linkedin.com/in/mohamed-ben-rebia" ### Email Sources bash tomba sources --target "ab@tomba.io" ### Email Verifier bash tomba verify --target "b.mohamed@tomba.io" ### Count bash tomba count --target "tomba.io" ### Status bash tomba status --target "tomba.io" ### Phone Finder 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" ### Phone Validator bash tomba phone-validator --phone "+14155552671" tomba phone-validator --phone "4155552671" --country-code US ### Company Search (Reveal) bash tomba reveal --query "SaaS startups in Europe" tomba reveal --country US,UK --industry Technology ### Similar Domains bash tomba similar --target "tomba.io" ### Technology Detection bash tomba technology --target "tomba.io" ### Account Info bash tomba whoami ## Additional Commands - **Email Format**: `tomba format -t stripe.com` - **Employee Location**: `tomba location -t stripe.com` - **Domain Suggestions**: `tomba autocomplete -t "goo"` - **Enrichment**: `tomba enrichment person -t user@example.com`, `tomba enrichment company -t example.com`, `tomba enrichment combined -t user@example.com` - **Lead Management**: `tomba lead list`, `tomba lead create --email user@example.com --list-id 1`, `tomba lead get --id 123` - **API Keys**: `tomba key list`, `tomba key create`, `tomba key delete --id 123` - **Attributes**: `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` ## AI Chat Tomba includes an AI chat interface that uses OpenAI function calling to chain Tomba API tools together. You can ask natural language questions and get results. bash export OPENAI_API_KEY=sk-... tomba chat Example session: You: Find the VP Sales at Stripe and get their email workflow: domain_search -> email_finder -> email_verifier ## Results **Email found:** d.singleton@stripe.com **Verified:** deliverable (score: 95) Bulk mode via chat: bash tomba chat --file contacts.csv --type enrich tomba chat --model gpt-4o-mini ## Bulk CSV Processing Process CSV files in bulk with concurrent workers, auto-mapping columns and respecting API rate limits. bash tomba bulk --file contacts.csv --type enrich Supported operation types include: enrich, verify, finder, search, author, linkedin, phone, phone-validator, company, similar, and sources. Concurrency is auto-detected from your plan (max 60 workers). ## ClawHub Skills ClawHub is a built-in skill system that chains multiple Tomba API calls into reusable workflows. 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 Built-in skills include: find-email, company-emails, enrich-verify, company-intel, lead-gen, linkedin-intel, domain-check, and author-verify. You can also create, import, export, and remove custom skills. ## HTTP Server Run a local HTTP server exposing all Tomba API endpoints as a reverse proxy. bash tomba http # starts on port 3000 tomba http --port 8080 # custom port The server exposes 45 routes covering all core API endpoints, leads CRUD, and management for lead lists, attributes, keys, and flags. ## Output Formats Most commands support JSON and YAML output formats for easy integration with other tools. ## Update and Version - **Update**: `tomba update` (also available as `tomba upgrade`) - **Version**: `tomba version` ## Summary Tomba is a comprehensive CLI tool for email discovery, verification, and enrichment. It's designed for sales, marketing, and recruitment professionals who need to find and validate contact information quickly. With support for bulk processing, AI chat, and reusable workflows, it can be integrated into various automation pipelines.