// tomba cli
ターミナルからメールインテリジェンスを活用
ドメイン検索、メール検索、アドレス検証、コンタクトのエンリッチメント すべてターミナルから離れずに実行できます。1つのコマンドでインストール。macOS、Linux、Windowsで動作。
$ tomba verify --target richard@piedpiper.com --json
{
"data": {
"email": {
"email": "richard@piedpiper.com",
"result": "deliverable",
"status": "valid",
"score": 99
}
}
}// 01 · インストール
macOS、Linux、Windows 向けの単一バイナリ
インストールスクリプトはリリースの SHA-256 チェックサムを確認し、シェル補完を設定します。リリースは 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 · コマンド
すべてのエンドポイントをターミナルから
入力は --target で渡します。機械可読な出力には --json、--yaml、--csv を、ファイルへの書き出しには --output を追加します。
tomba searchドメインについて Tomba が保有するメールアドレス
GET /v1/domain-searchtomba finder氏名と企業ドメインから個人のメールアドレス
GET /v1/email-findertomba author記事著者のメールアドレス
GET /v1/author-findertomba enrichメールアドレスの持ち主
GET /v1/enrichtomba enrichment personメールアドレスから人物プロフィール
GET /v1/people/findtomba enrichment companyドメインから企業プロフィール
GET /v1/companies/findtomba enrichment combined人物と企業を1回のリクエストで
GET /v1/combined/findtomba verifyメールアドレスが配信可能かどうか
GET /v1/email-verifiertomba linkedinLinkedIn プロフィールのメールアドレス
GET /v1/linkedintomba sourcesアドレスが見つかった公開ページ
GET /v1/email-sourcestomba countドメインのアドレス数(部門別・役職レベル別)
GET /v1/email-counttomba statusドメインが Web メールか使い捨てか
GET /v1/domain-statustomba formatドメインが使用するアドレスのパターン
GET /v1/email-formattomba location企業の拠点別従業員数
GET /v1/locationtomba autocomplete名前の一部から企業とドメイン
GET /v1/domain-suggestionstomba phone-finderメールアドレス、ドメイン、LinkedIn プロフィールから電話番号
GET /v1/phone-findertomba phone-validator電話番号が有効か、その形式と通信事業者
GET /v1/phone-validatortomba reveal自然言語のクエリやフィルターから企業
POST /v1/reveal/searchtomba similarドメインに類似した企業
GET /v1/similartomba technologyドメインの Web サイトで使われている技術
GET /v1/technologytomba lead · leads-list · attributeリード、リードリスト、カスタム属性の管理
/v1/leads, /v1/leads_lists, /v1/attributestomba flag create · list誤ったデータの報告と報告一覧
POST /v1/flag, GET /v1/flagtomba key list · get · create · deleteワークスペースの API キーの管理
/v1/keystomba whoami · usage · logsアカウント、日次利用状況、最近のリクエスト
GET /v1/me, /v1/usage, /v1/logs
| コマンド | 戻り値 | 呼び出し先 |
|---|---|---|
| tomba search | ドメインについて Tomba が保有するメールアドレス | GET /v1/domain-search |
| tomba finder | 氏名と企業ドメインから個人のメールアドレス | GET /v1/email-finder |
| tomba author | 記事著者のメールアドレス | GET /v1/author-finder |
| tomba enrich | メールアドレスの持ち主 | GET /v1/enrich |
| tomba enrichment person | メールアドレスから人物プロフィール | GET /v1/people/find |
| tomba enrichment company | ドメインから企業プロフィール | GET /v1/companies/find |
| tomba enrichment combined | 人物と企業を1回のリクエストで | GET /v1/combined/find |
| tomba verify | メールアドレスが配信可能かどうか | GET /v1/email-verifier |
| tomba linkedin | LinkedIn プロフィールのメールアドレス | GET /v1/linkedin |
| tomba sources | アドレスが見つかった公開ページ | GET /v1/email-sources |
| tomba count | ドメインのアドレス数(部門別・役職レベル別) | GET /v1/email-count |
| tomba status | ドメインが Web メールか使い捨てか | GET /v1/domain-status |
| tomba format | ドメインが使用するアドレスのパターン | GET /v1/email-format |
| tomba location | 企業の拠点別従業員数 | GET /v1/location |
| tomba autocomplete | 名前の一部から企業とドメイン | GET /v1/domain-suggestions |
| tomba phone-finder | メールアドレス、ドメイン、LinkedIn プロフィールから電話番号 | GET /v1/phone-finder |
| tomba phone-validator | 電話番号が有効か、その形式と通信事業者 | GET /v1/phone-validator |
| tomba reveal | 自然言語のクエリやフィルターから企業 | POST /v1/reveal/search |
| tomba similar | ドメインに類似した企業 | GET /v1/similar |
| tomba technology | ドメインの Web サイトで使われている技術 | GET /v1/technology |
| tomba lead · leads-list · attribute | リード、リードリスト、カスタム属性の管理 | /v1/leads, /v1/leads_lists, /v1/attributes |
| tomba flag create · list | 誤ったデータの報告と報告一覧 | POST /v1/flag, GET /v1/flag |
| tomba key list · get · create · delete | ワークスペースの API キーの管理 | /v1/keys |
| tomba whoami · usage · logs | アカウント、日次利用状況、最近のリクエスト | GET /v1/me, /v1/usage, /v1/logs |
// 03 · 一括処理
お使いのマシンから CSV を処理
tomba bulk は1行ごとに1回の API リクエストを送信し、行が完了するたびに結果を新しい CSV に書き込みます。各行は単一リクエストと同様に課金され、レート制限を受けます。サーバー側のジョブには 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
- お使いのマシンで実行、1行につき1リクエスト、それぞれ単一呼び出しとして課金
- POST /v1/bulk/{type}
- Tomba のサーバーで1つのジョブとして実行、初回ダウンロード時に課金
// 04 · サインイン
ブラウザでサインイン、または API キー
tomba login は OAuth 2.0 デバイスフローを使用するため、SSH 経由でも動作します。スクリプトではキーでサインインしてください。認証情報は ~/.tomba.json に保存されます。
tomba logintomba login --api-key
tomba whoamitomba verify --target richard@piedpiper.com --key "$TOMBA_API_KEY" --secret "$TOMBA_SECRET_KEY"--json、--yaml、--csv フラグで機械可読な出力が得られます。jq にパイプして絞り込んだり、ファイルにリダイレクトしたり、シェルスクリプト、cron ジョブ、CI/CD パイプラインで使ったりできます。