email-finder

メールアドレス検索

概要

ハイブリッド方式で、ドメインに関連付けられたメールアドレスを検索します。まず無料の方法（ウェブスクレイピング、パターン推測、WHOIS 検索）を試し、API キーが利用できる場合は API（Hunter.io、Apollo.io など）を使用します。

使用する場面

• ドメインをスキャンして関連するメールアドレスを検索する
• 企業の連絡先メールアドレスを検索する
• メール検索機能を置き換える
• ドメインのメールアドレスのパターンを調べる
• メールアドレスを検証する
• 見つかったメールアドレスで連絡先データを充実させる

プロジェクトのコンテキストを確認する

メールアドレスを検索する前に、次の項目を確認します。

1. 既存のメールアドレス検索ツールを確認する
2. 利用可能な API キー（Hunter.io、Apollo.io）を確認する
3. コンプライアンスとプライバシーの要件を確認する
4. プロジェクト固有の [project]-email-finder スキルを探す

方法

無料の方法（優先）

1. ウェブスクレイピング - /contact、/about、/team ページをスキャンしてメールアドレスを探します
2. WHOIS 検索 - ドメイン登録情報を照会します
3. パターン推測 - サイトで見つかった名前からパターンを生成します：
   • [email protected]
   • [email protected]
   • [email protected]
   • [email protected]

API を使用する方法（API キーが利用可能な場合）

API	環境変数	目的
Hunter.io	HUNTER_API_KEY	ドメイン検索と検証
Apollo.io	APOLLO_API_KEY	連絡先の検索
Snov.io	SNOV_CLIENT_ID/SECRET	メールアドレス検索
Clearbit	CLEARBIT_API_KEY	企業情報の充実

メール検索結果のインターフェース

interface EmailResult {
  email: string;
  source: 'web-scraping' | 'whois' | 'pattern-guessing' | 'hunter' | 'apollo';
  confidence?: number;
  firstName?: string;
  lastName?: string;
  position?: string;
  verified?: boolean;
}

ベストプラクティス

• レート制限：リクエストの間隔を空けます（1 秒を推奨）
• robots.txt を遵守する：スクレイピングの前に確認します
• 重複を排除する：メールアドレスを正規化します（小文字に変換し、前後の空白を削除）
• 検証する：MX レコードの確認または API による検証を使用します
• フィルタリングする：noreply@、donotreply@ アドレスを除外します

法的・倫理的な配慮

• GDPR／CCPA を遵守します
• 利用規約を尊重します
• オプトアウトのリクエストに対応します
• 見つかったメールアドレスに迷惑メールを送信しません

連携

次のツールと相性よく連携できます。

• leads-researcher - 企業の調査後に連絡先メールアドレスを検索します
• copywriter - 見つかったメールアドレスをアウトリーチキャンペーンに使用します

---

完全な実装コード、API の使用例、検証パターン、レート制限ユーティリティについては、こちらを参照してください： references/full-guide.md