Hunter 自動化
Hunter.io を活用したアウトリーチを効率化しましょう。ドメインごとのメールアドレス発見、特定人物のメール特定、配信可能性の確認、リードの保存、API使用状況の追跡を、すべて自然言語のコマンドで実行できます。
ツールキットドキュメント: composio.dev/toolkits/hunter
セットアップ
- Composio MCPサーバーをクライアント設定に追加します。
https://rube.app/mcp - プロンプトに従ってHunter.ioアカウントを接続します（APIキー認証）。
- 自然言語のコマンドを発行して、メールの検索と確認を開始します。
コアワークフロー
1. ドメインのメールアドレス検索
指定されたドメインまたは企業の、公開されているすべてのメールアドレスを、部署、役職、タイプでフィルタリングして検出します。
ツール: HUNTER_DOMAIN_SEARCH
プロンプト例:
"Hunterを使ってstripe.comのすべての役員メールアドレスを探して"
主要パラメータ:
domain-- 検索するドメイン（例："stripe.com"）。companyが指定されていない場合は必須。company-- 検索する企業名（例："Stripe"）。domainが指定されていない場合は必須。type-- "personal"（個人）または"generic"（汎用）メールでフィルタリング。seniority-- レベルでフィルタリング："junior"（ジュニア）、"senior"（シニア）、"executive"（エグゼクティブ）（配列）。department-- 部署でフィルタリング："executive"（役員）、"it"（IT）、"finance"（財務）、"sales"（営業）など（配列）。required_field-- 特定のフィールドを必須にする："full_name"（氏名）、"position"（役職）、"phone_number"（電話番号）（配列）。limit-- リクエストあたりの最大結果数（1～100、デフォルト10。無料/基本プランは10に制限）。offset-- ページネーション用のスキップ数（デフォルト0）。
2. 特定人物のメールアドレス検索
名前とドメインまたは会社名から、その人物の最も可能性の高いメールアドレスを推定します。
ツール: HUNTER_EMAIL_FINDER
プロンプト例:
"Hunterを使ってreddit.comのAlexis Ohanianのメールアドレスを探して"
主要パラメータ:
domain-- 対象ドメイン（例："reddit.com"）。companyより優先されます。company-- 企業名（例："Reddit"）。ドメインが指定されていない場合に使用されます。- 名前（以下のいずれかの組み合わせが必要）：
first_name+last_name（例："Alexis" + "Ohanian"）full_name（例："Alexis Ohanian"）
max_duration-- 最大リクエスト時間（秒）（3～20、デフォルト10）。時間が長いほど正確な結果が得られます。
3. メール配信可能性の確認
メールアドレスが有効で、配信可能で、安全に送信できるかどうかを確認します。
ツール: HUNTER_EMAIL_VERIFIER
プロンプト例:
"[email protected] が有効なメールアドレスか確認して"
主要パラメータ:
email（必須） -- 確認するメールアドレス（例："[email protected]"）
レスポンスに含まれる情報: 確認ステータス、配信可能性スコア、MXレコードの検証、リスク評価。
4. メール数の見積もり取得
Hunterがドメインまたは企業に対して持っているメールアドレスの数を確認します。この呼び出しは無料で、APIクレジットを消費しません。
ツール: HUNTER_EMAIL_COUNT
プロンプト例:
"Hunterはstripe.comのメールアドレスをいくつ持っている？"
主要パラメータ:
domain-- 照会するドメイン（例："stripe.com"）。companyが指定されていない場合は必須。company-- 企業名（最低3文字）。domainが指定されていない場合は必須。type-- "personal"（個人）または"generic"（汎用）メールで数をフィルタリング。
戻り値: タイプ、部署、役職レベルごとの内訳を含む総数。
5. リードの保存と管理
単一のアップサート呼び出しで、メールによるリードの作成または更新を行います。事前に存在確認をする必要はありません。
ツール: HUNTER_UPSERT_LEAD
プロンプト例:
"[email protected] をHunterにリードとして保存して。名前はJohn Doe、役職はCTO"
主要パラメータ:
email-- リードのメールアドレス（アップサートの主要な識別子）。- 名前、役職、会社、その他のリードメタデータ。
6. アカウント使用状況と制限の確認
大量操作を実行する前に、Hunterアカウントのプラン詳細、残りの検索数、確認クォータを確認します。
ツール: HUNTER_ACCOUNT_INFORMATION
プロンプト例:
"今月、Hunter APIの検索はあと何回できる？"
主要パラメータ: 必須なし。
既知の問題点
- HTTP 401は認証情報が無効な場合:
authentication_failedエラーは、APIキーが無効または期限切れであることを示します。大量操作の前に修正してください。 - メール数は推定値:
HUNTER_EMAIL_COUNTは、規模の見積もりや優先順位付けのためのおおよその数を返します。取得可能なメールアドレス数を保証するものではありません。 - ドメイン検索はオフセットページネーションを使用:
HUNTER_DOMAIN_SEARCHはlimit/offsetでページネーションを行います。最初のページが完全であると想定せず、結果が空になるか上限に達するまでフェッチを続けてください。 - 空の結果はエラーではない:
HUNTER_DOMAIN_SEARCHはエラーなしでemails: []を返すことがあります。「データなし」と解釈し、失敗として再試行するのではなく続行してください。 - 確認ステータスのニュアンス:
HUNTER_EMAIL_VERIFIERからのaccept_allやriskyステータスは不確実性を示します。厳格な配信可能性ワークフローからこれらを除外するか、個別に処理してください。 - 無料/基本プランの制限: 無料プランと基本プランでは、
HUNTER_DOMAIN_SEARCHの結果がリクエストあたり10件に制限されます。より高い制限が必要な場合は、有料プランが必要です。 - ドメイン形式に注意: "stripe.com"のようなベアドメインを使用してください。プロトコル（"https://"）や"www."接頭辞は含めないでください。
クイックリファレンス
| アクション | ツールスラッグ | 必須パラメータ |
|---|---|---|
| ドメインメール検索 | HUNTER_DOMAIN_SEARCH | domain または company |
| 人物のメール検索 | HUNTER_EMAIL_FINDER | 名前 + （domain または company） |
| メール確認 | HUNTER_EMAIL_VERIFIER | email |
| メール数取得 | HUNTER_EMAIL_COUNT | domain または company |
| リード保存/更新 | HUNTER_UPSERT_LEAD | email |
| アカウント確認 | HUNTER_ACCOUNT_INFORMATION | なし |
Powered by Composio