Об этом проекте
# Tomba Email Finder CLI
Tomba — это утилита командной строки, которая помогает искать и проверять email-адреса, обогащать контактные данные и находить телефонные номера. Она предоставляет широкий набор функций для специалистов по продажам, маркетингу и рекрутингу.
## Ключевые возможности
- **Поиск email**: Мгновенный поиск email-адресов на любом сайте или по названию компании.
- **Проверка email**: Подтверждение подлинности и доставляемости email-адреса.
- **Обогащение**: Обогащение email-адресов дополнительными данными.
- **LinkedIn Finder**: Поиск email-адресов по LinkedIn-URL.
- **Author Finder**: Поиск email-адресов авторов статей.
- **Phone Finder**: Поиск телефонных номеров по email, домену или LinkedIn-URL.
- **Phone Validator**: Проверка телефонных номеров.
- **Similar Domains**: Получение доменов, похожих на указанный.
- **Technology Detection**: Определение технологий, используемых доменом.
- **Company Search**: Поиск компаний с помощью естественного языка или структурированных фильтров.
- **Account Info**: Вывод информации о текущем аккаунте.
- **AI Chat**: Запросы на естественном языке на основе OpenAI с инструментами Tomba.
- **Bulk CSV Processing**: Обогащение, проверка, поиск, author, linkedin, phone и sources из CSV-файлов с автоматическим сопоставлением колонок.
- **ClawHub Skills**: Переиспользуемые многошаговые рабочие процессы, объединяющие API-вызовы в одну команду.
## Установка
Tomba можно установить несколькими способами:
- **Быстрая установка (Linux/macOS)**: `curl -sSL https://releases.tomba.io/install.sh | sh`
- **Быстрая установка (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`
## Начало работы
После установки необходимо войти в свой аккаунт Tomba. Доступны два метода:
- **OAuth (через браузер)**: `tomba login`
- **API Key + Secret**: `tomba login --key ta_xxxx --secret ts_xxxx`
## Основные команды
### Поиск по домену
bash
tomba search --target "tomba.io"
### Поиск email
bash
tomba finder --target "tomba.io" --first "mohamed" --last "ben rebia"
tomba finder --target "tomba.io" --full "Mohamed Ben Rebia"
### Обогащение
bash
tomba enrich --target "b.mohamed@tomba.io"
### Поиск автора
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
bash
tomba sources --target "ab@tomba.io"
### Проверка email
bash
tomba verify --target "b.mohamed@tomba.io"
### Подсчет
bash
tomba count --target "tomba.io"
### Статус
bash
tomba status --target "tomba.io"
### Поиск телефона
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"
### Проверка телефона
bash
tomba phone-validator --phone "+14155552671"
tomba phone-validator --phone "4155552671" --country-code US
### Поиск компаний (Reveal)
bash
tomba reveal --query "SaaS startups in Europe"
tomba reveal --country US,UK --industry Technology
### Похожие домены
bash
tomba similar --target "tomba.io"
### Определение технологий
bash
tomba technology --target "tomba.io"
### Информация об аккаунте
bash
tomba whoami
## Дополнительные команды
- **Формат email**: `tomba format -t stripe.com`
- **Локация сотрудников**: `tomba location -t stripe.com`
- **Подсказки доменов**: `tomba autocomplete -t "goo"`
- **Обогащение**: `tomba enrichment person -t user@example.com`, `tomba enrichment company -t example.com`, `tomba enrichment combined -t user@example.com`
- **Управление лидами**: `tomba lead list`, `tomba lead create --email user@example.com --list-id 1`, `tomba lead get --id 123`
- **API-ключи**: `tomba key list`, `tomba key create`, `tomba key delete --id 123`
- **Атрибуты**: `tomba attribute list`, `tomba attribute create --name "Company Size" --type "text"`
- **Флаги**: `tomba flag list`, `tomba flag create --type email --value bounce@example.com --reason hard_bounce`
## AI-чат
Tomba включает AI-чат, использующий вызовы функций OpenAI для объединения инструментов Tomba API. Можно задавать вопросы на естественном языке и получать результаты.
bash
export OPENAI_API_KEY=sk-...
tomba chat
Пример сессии:
Вы: Найдите VP Sales в Stripe и получите их email
рабочий процесс: domain_search -> email_finder -> email_verifier
## Результаты
**Email найден:** d.singleton@stripe.com
**Проверен:** доставляемый (оценка: 95)
Пакетный режим через чат:
bash
tomba chat --file contacts.csv --type enrich
tomba chat --model gpt-4o-mini
## Пакетная обработка CSV
Обработка CSV-файлов пакетно с параллельными воркерами, автоматическим сопоставлением колонок и учетом лимитов API.
bash
tomba bulk --file contacts.csv --type enrich
Поддерживаемые типы операций: enrich, verify, finder, search, author, linkedin, phone, phone-validator, company, similar и sources.
Параллельность определяется автоматически на основе вашего плана (максимум 60 воркеров).
## ClawHub Skills
ClawHub — встроенная система скиллов, объединяющая несколько вызовов Tomba API в переиспользуемые рабочие процессы.
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
Встроенные скиллы включают: find-email, company-emails, enrich-verify, company-intel, lead-gen, linkedin-intel, domain-check и author-verify.
Также можно создавать, импортировать, экспортировать и удалять пользовательские скиллы.
## HTTP-сервер
Запуск локального HTTP-сервера, предоставляющего все конечные точки Tomba API в качестве обратного прокси.
bash
tomba http # запуск на порту 3000
tomba http --port 8080 # пользовательский порт
Сервер предоставляет 45 маршрутов, охватывающих все основные конечные точки API, CRUD для лидов и управление списками лидов, атрибутами, ключами и флагами.
## Форматы вывода
Большинство команд поддерживают форматы JSON и YAML для легкой интеграции с другими инструментами.
## Обновление и версия
- **Обновление**: `tomba update` (также доступно как `tomba upgrade`)
- **Версия**: `tomba version`
## Резюме
Tomba — это комплексный CLI-инструмент для поиска, проверки и обогащения email-адресов. Он предназначен для специалистов по продажам, маркетингу и рекрутингу, которым необходимо быстро находить и проверять контактную информацию. Благодаря поддержке пакетной обработки, AI-чата и переиспользуемых рабочих процессов, его можно интегрировать в различные автоматизированные конвейеры.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.