mcpField
C
cold-email-verifier

cold-email-verifier

github.com/varnan-techマーケティング・グロース68752 回インストール2 週間前に更新
リポジトリ

cold-email-verifier について

cold-email-verifierは、リードのCSVから企業ドメインを調べ、候補メールアドレスを作成して到達可能性を検証するスキルです。ValidEmail.coまたはReacherで検証できます。

主な機能

  1. 01Clearbitによる企業ドメイン検索
  2. 023種類のメール形式の生成
  3. 03ValidEmail.co APIでの検証
  4. 04ホスト型Reacherバックエンドでの検証
  5. 05CSVの読み込みと検証結果の出力

活用シーン

  1. 01氏名と企業名からメールアドレスを探す
  2. 02連絡前に候補アドレスを検証する

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/varnan-tech/opendirectory --skill cold-email-verifier

インストール後、Claude Code で/cold-email-verifierを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.env.example
README.md
requirements.txt
scripts/
email_verifier.py

詳細

コールドメール検証・推測ツール（公開）

概要

このスキルは、見込み顧客の CSV（名、姓、会社名を含む）を自律的に処理し、企業ドメインを特定して、ビジネス向けのメールアドレス候補を生成し、その到達可能性を厳密に検証します。

不足している連絡先情報を補うために、主要なメールアドレスの形式を推測し、どれが有効かを確認します。

メールアドレス推測エンジン

CSV にメールアドレスを入力する必要はありません。CSV に名、姓、会社名のみが含まれている場合、スクリプトは自動的に次の処理を行います。

  1. 無料の Clearbit API を使って、会社の公式ドメインを検索します。
  2. 名前を整形（句読点を削除）し、一般的な企業メールアドレスの形式を 3 種類生成します。

検証方法（エンジンを選択）

メールアドレスを推測した後、スクリプトで検証する必要があります。次の 3 つの方法をサポートしています。

1. ValidEmail.co API（強く推奨）

最良の選択肢です。 ValidEmail.co はエンタープライズグレードの精度を提供し、厳格なキャッチオールサーバーを回避できます。また、IP レピュテーションも管理します。

  • 無料プラン： 利用開始時に、十分な無料プラン（登録時に無料検証クレジット 50 件）が提供されます。
  • 使い方： validemail.co にアクセスしてアカウントを作成し、API キーを取得して、--mode validemail を指定してスクリプトを実行します。
2. Reacher オープンソース（セルフホスト）

100％無料のオープンソースソリューションを利用したい場合は、クラウドプロバイダー（AWS、GCP、Hetzner など）上で Reacher バックエンドをホストできます。

  • GitHub リポジトリ： reacherhq/check-if-email-exists
  • 重要： クラウドプロバイダーで送信ポート 25 が開放されている必要があります。
  • 使い方： Docker コンテナをホストし、--mode reacher-http --reacher-url "http://<YOUR_SERVER_IP>:8080/v0/check_email" を指定してスクリプトを実行します。
3. Reacher ローカル CLI（非推奨／信頼性に欠けます）

Reacher CLI をノート PC 上で直接実行できます。

  • 警告： スパム対策として、世界中の住宅向け ISP はポート 25 をブロックしています。さらに、主要なメールサーバー（Microsoft、Google）は、住宅向け Wi-Fi の IP アドレスからの SMTP ハンドシェイクを自動的に拒否します。
  • 結果： 大量の偽陰性やタイムアウトが発生します。代わりに ValidEmail.co を使用してください。

実行方法

まず、依存関係がインストールされていることを確認します。pip install -r requirements.txt

ValidEmail.co を使用する場合（推奨）： ash export VALIDEMAIL_API_KEY="your_api_key_here" python scripts/email_verifier.py --input leads.csv --output verified_leads.csv --mode validemail

セルフホストの Reacher を使用する場合： ash python scripts/email_verifier.py --input leads.csv --output verified_leads.csv --mode reacher-http --reacher-url "http://your-server-ip:8080/v0/check_email"

CSV 形式の要件

入力 CSV には、次の列見出し（または対応する特定のマッピング）が正確に含まれている必要があります。

  • 名
  • 姓
  • 会社名
  • ドメイン（任意 — 精度向上のため強く推奨）

コメント

Markdown 対応