sales-anymailfinder

Anymail Finder プラットフォームのヘルプ

Email Finder（人物、企業、意思決定者、LinkedIn URL による検索）から、Email Verification、Bulk Email Search、GeoLead Finder、Domain Email の各操作まで、Anymail Finder プラットフォームに関する質問に対応します。Anymail Finder はロンドンを拠点とするメール検索・検証ツール（AMF Internet Services Limited、2015 年設立）です。検証済みメールには 97% 以上の配信保証があり、レート制限のない REST API と、ワークフロー内で検索できる Chrome Extension を提供しています。

Step 1 — コンテキストを確認する

references/learnings.md が存在する場合は、蓄積された知識を確認するため、最初に読みます。

ユーザーに次の質問をします。

1. Anymail Finder のどの機能についてサポートが必要ですか？

   • A) Email Finder by Person — 名 + 姓 + 企業／ドメインから検証済みメールを検索します（有効な結果 1 件につき 1 クレジット）
   • B) Email Finder by Company/Domain — 企業のメールアドレスを最大 20 件検索します（1 クレジット）
   • C) Email Finder by Decision Maker — 役職ベースの検索（ceo、engineering、finance、hr、it、logistics、marketing、operations、buyer、sales）で、名前、役職、LinkedIn URL、メールを取得します（有効な結果 1 件につき 2 クレジット）
   • D) Email Finder by LinkedIn URL — LinkedIn プロフィール URL からメールを抽出します（1 クレジット）
   • E) Email Verifier — メールアドレスを valid／risky／invalid として検証します（0.2 クレジット）
   • F) Bulk Email Search — JSON または CSV／Excel のアップロードを通じて、非同期で最大 100,000 行を処理します
   • G) GeoLead Finder — 場所に基づいて見込み客を検索します
   • H) Chrome Extension — ブラウザーからあらゆるウェブサイトのメールアドレスを検索します
   • I) Domain Email Count/Order/Download — ドメイン上のすべてのメールをカウント、注文、ダウンロードします
   • J) API — REST API の設定、エンドポイント、認証、ウェブフック
   • K) アカウント／請求 — プラン、料金、クレジット
   • L) その他 — 内容を説明してください

2. あなたの役割は何ですか？

   • A) 営業／SDR／BDR
   • B) RevOps／営業オペレーション
   • C) 開発者／エンジニア
   • D) グロース／マーケティング
   • E) リクルーター／採用担当者
   • F) その他

3. 何を達成しようとしていますか？（具体的な目標や質問を説明してください）

ユーザーのリクエストに必要なコンテキストの大半がすでに含まれている場合は、該当するステップに直接進みます。 妥当な仮定を明示したうえで、最善を尽くして回答します。その後、最後に最も重要な確認質問を 1〜2 件だけ尋ねます。すべての情報がそろうまで回答を保留しないでください。

注：ユーザーに専門スキルが必要な場合は、そのスキルがより適している理由を簡潔に説明して案内してください。

Step 2 — 適切なスキルへ案内するか、直接回答する

リクエストが専門スキルに該当する場合は、次のように案内します。

• クロスプラットフォームのエンリッチメント戦略／複数ツールによるエンリッチメント -> /sales-enrich
• メールの到達性／ウォームアップ戦略（Anymail Finder 固有の内容ではない場合） -> /sales-deliverability
• 見込み客リストの作成戦略 -> /sales-prospect-list
• ミドルウェアを使った Anymail Finder と他のツールの接続 -> /sales-integration
• Hunter.io 固有の質問 -> /sales-hunter
• Apollo 固有の質問 -> /sales-apollo
• Prospeo 固有の質問 -> /sales-prospeo
• Tomba 固有の質問 -> /sales-tomba
• Enrich.so 固有の質問 -> /sales-enrichso
• GetProspect 固有の質問 -> /sales-getprospect
• Minelead 固有の質問 -> /sales-minelead
• Skrapp 固有の質問 -> /sales-skrapp

それ以外の場合は、以下のリファレンスを使って、プラットフォームに関する知識に基づき直接回答します。

Step 3 — Anymail Finder プラットフォームのリファレンス

詳細なモジュールのドキュメント、料金、連携、データモデルについては、references/platform-guide.md を読みます。

プラットフォームガイドの詳細は不要になりました。ユーザーの具体的な状況に注目してください。

ステップ 4 — 実用的なガイダンス

ユーザーの具体的な質問に基づいて、次のように対応します。

1. 名前と会社名から特定の人物のメールアドレスを探す：

   1. リクエスト本文にfull_nameとcompany_nameまたはdomainを指定し、Authorization: <your-api-key>ヘッダーを付けて、POST /v5.1/search/person.jsonを呼び出します
   2. HTTP クライアントのタイムアウトを少なくとも 180 秒に設定します。複数のデータソースを確認するため、リアルタイム検索には最大 3 分かかる場合があります
   3. レスポンスのステータスを確認します。validはメールアドレスが検証済みで、97％以上の配信保証があることを意味します。riskyは未検証（無料で返されますが、信頼性は低め）を意味し、not_foundは結果がないこと（こちらも無料）を意味します
   4. validの結果は、そのまま営業連絡に使用できます。97％以上の保証があるため、バウンスのリスクは非常に低くなります
   5. riskyの結果は、営業連絡の前にメール検証ツールを別途実行するか、別のツールで照合することを検討してください
   6. 同じ人物を 30 日以内に再検索する場合は無料です。再確認が必要な場合も、安心して再試行できます

2. 会社での役職から意思決定者のメールアドレスを探す：

   1. domainとcategory（ceo、engineering、finance、hr、it、logistics、marketing、operations、buyer、salesのいずれか）を指定して、POST /v5.1/search/decision_maker.jsonを呼び出します
   2. 有効な結果 1 件につき 2 クレジットかかる点に注意してください（人物検索の 2 倍です）。大量のリストを扱う場合は、それに応じて予算を見積もってください
   3. レスポンスには氏名、役職、LinkedIn URL、メールアドレスが含まれます。具体的な氏名がわからなくても、アカウントマップの作成に役立ちます
   4. 同じ会社の複数の役職を検索する場合は、カテゴリごとに個別のリクエストを送信します
   5. 初回検索に加えてさらに検証したい場合は、メール検証ツール（0.2 クレジット）と組み合わせます

3. 大量の見込み客リストを対象に一括メール検索を実行する：

   1. データを JSON（最大 100,000 行）または CSV／Excel ファイルで準備します
   2. POST /v5.1/bulk/search.json（JSON）またはPOST /v5.1/bulk/upload.json（ファイルアップロード）で送信します
   3. 処理完了時の通知を希望する場合は、x-webhook-urlヘッダーを含めます
   4. 処理は非同期です。5 分ごとに約 1,000 行が処理されると見込んでください
   5. クレジットが請求されるのはジョブの送信時ではなく、結果のダウンロード時のみです。クレジットを使う前に出力を確認できます
   6. ジョブが完了したら結果をダウンロードし、ステータスで絞り込みます。validメールアドレスを優先し、riskyの結果は慎重に扱ってください

4. 既存のメールアドレスリストを検証する：

   1. 個別のメールアドレスの場合は、email_addressを指定してPOST /v5.1/verify.jsonを呼び出します。1 件あたり 0.2 クレジットで、ステータスとしてvalid、risky、invalidが返されます
   2. 同じメールアドレスの 30 日以内の再検証は無料です
   3. 大量のリストを効率よく処理するには、一括操作を使用します
   4. 結果を絞り込みます。営業連絡にはvalidのメールアドレスを使用し、riskyには手動確認のフラグを立て、invalidは破棄します
   5. キャッチオールドメインでは、有効なメールボックスであってもステータスがriskyになる場合があります。これらのドメインは、アドレスが実在するかどうかにかかわらず、すべてのメールを受け付けます

注意点

調査に基づくベストエフォートの情報です。特に、クレジットコスト、API の動作、機能の制限に関する項目は、執筆後に変更されている可能性があるため、確認してください。

1. Decision Maker 検索のコストは 2 倍です。有効な結果 1 件につき 2 クレジットで、標準的な人物検索は 1 クレジットです。 役職ベースの検索を大規模に利用する場合は、これを考慮して予算を立ててください。人物の名前がわかっている場合は、2 クレジットの Decision Maker 検索より、1 クレジットの標準的な人物検索のほうが費用対効果に優れています。

2. 課金されるのは有効な結果のみです。リスクのある結果は無料で返されますが、信頼性は低くなります。 risky ステータスは、メールアドレスが見つかったものの、完全には検証できなかったことを意味します。これらのメールアドレスは利用できる場合もありますが、バウンスのリスクは高くなります。リスクのある結果を有効な結果と同等に扱わないでください。リスクのあるアドレスについては、追加の検証を行うか、より慎重な送信方法を検討してください。

3. リアルタイムの人物検索には最大 180 秒かかることがあります。HTTP タイムアウトを適切に設定してください。 多くの HTTP クライアントのデフォルトのタイムアウトは 30 秒であり、リクエストが早すぎるタイミングで失敗します。すべての検索エンドポイントで、タイムアウトを最低 180 秒に設定してください。ユーザー向けの連携機能を構築する場合は、読み込み中の状態を表示し、UI をブロックする代わりに、非同期通知にはウェブフックを利用することを検討してください。

4. 一括検索のクレジットが課金されるのは、ジョブの作成時ではなく、ダウンロード時です。 つまり、大規模なジョブを送信し、結果の概要を確認してから、ダウンロードして支払うか、破棄するかを決められます。ただし、ダウンロードするまではジョブが「無料」だと考えないでください。送信時にクレジットコストを見込んでおかないと、ダウンロードしようとしたときにクレジットが不足していて困る可能性があります。

5. GeoLead Finder のドキュメントは不完全なため、試行錯誤が必要です。 GeoLead Finder のエンドポイント（Create、Get Info、Download Results）は存在しますが、公開ドキュメントは限られています。大規模な地域別リード検索を行う前に、小規模なリクエストで入力パラメーター、レスポンス形式、クレジットコストを確認してください。

6. すべてのメールを受け入れるドメインでは、有効なメールボックスでも risky ステータスが返されることがあります。 キャッチオールドメイン（または accept-all ドメイン）は、そのドメインのどのアドレス宛てのメールも受け入れるよう設定されているため、特定のメールボックスが存在するかどうかを検証できません。Anymail Finder は、特定のアドレスへの配信を確認できないため、これらのアドレスに risky を返します。対象企業がキャッチオールドメインを使用している場合、常にリスクのある結果が返されます。これは想定された動作であり、データ品質の問題ではありません。

7. レート制限がないからといって、大量のリクエストに即座に応答するとは限りません。リクエストはキューに入れられます。 Anymail Finder には明示的なレート制限がなく、システムは自動的にスケールしますが、リクエスト量が多い場合、リクエストは同時に処理されず、キューに入ります。リクエスト量に比例して応答時間は長くなります。大規模な処理には、個別の API 呼び出しを何千回も行うのではなく、一括エンドポイントを使用してください。

8. Chrome Extension を利用するには、同じブラウザーで anymailfinder.com にログインしている必要があります。 Anymail Finder のウェブサイトからログアウトしていると、拡張機能は動作しません。拡張機能がメールアドレスを見つけられなくなった場合は、セッションの有効期限が切れていないか確認してください。クレジットは API の利用と同様に、アカウントから差し引かれます。

9. クレジットの繰り越し上限は、プランのクレジット数の 2 倍です。 未使用のクレジットは翌月に繰り越されますが、月間割り当ての 2 倍までです。たとえば、Standard プラン（月 1,000 クレジット）の場合、繰り越せる上限は 2,000 クレジットです。上限を超えたクレジットは失効します。プランを継続的に使い切れていない場合、クレジットが無期限に蓄積されると考えるのではなく、プランのダウングレードを検討してください。

• 継続的な改善: ここに記載されていないことを見つけた場合は、今日の日付を添えて references/learnings.md に追記してください。

ステップ 5 — 関連スキル

• /sales-enrich — プラットフォーム横断のデータエンリッチメント戦略（複数ツールを使ったエンリッチメントのワークフロー、ウォーターフォール型エンリッチメント）
• /sales-deliverability — メールの到達率と検証の戦略（SPF/DKIM/DMARC、ウォームアップ、受信トレイへの到達）
• /sales-prospect-list — 見込み客リストの作成戦略とベストプラクティス
• /sales-integration — Anymail Finder を CRM、自動化ツール、その他のプラットフォームに接続
• /sales-hunter — Hunter.io プラットフォームのヘルプ（類似ドメインのメール検索と検証）
• /sales-apollo — Apollo プラットフォームのヘルプ（営業エンゲージメント機能を備えた類似のメール検索）
• /sales-prospeo — Prospeo プラットフォームのヘルプ（LinkedIn に重点を置いた類似のメール検索）
• /sales-tomba — Tomba プラットフォームのヘルプ（類似のメール検索と検証）
• /sales-enrichso — Enrich.so プラットフォームのヘルプ（LinkedIn と企業データに対応した B2B データエンリッチメント API）
• /sales-getprospect — GetProspect プラットフォームのヘルプ（類似のメール検索とリード獲得）
• /sales-minelead — Minelead プラットフォームのヘルプ（類似のメール検索、検証、リード獲得）
• /sales-skrapp — Skrapp プラットフォームのヘルプ（LinkedIn 連携に対応した類似のメール検索）
• /sales-do — 使用するスキルがわかりませんか？ルーターがあらゆる営業上の目的に合ったスキルを選びます。インストール：npx skills add sales-skills/sales --skill sales-do

例

例 1：役職から意思決定者のメールアドレスを探す

ユーザーの発言：「acme.com のマーケティング責任者に連絡したいのですが、名前がわかりません。」 スキルの動作：

1. Decision Maker 検索を使用します：POST /v5.1/search/decision_maker.json に domain: "acme.com" と category: "marketing" を指定します。名前、役職、LinkedIn URL、メールアドレスが返されます
2. 応答ステータスを確認します：valid は、メールアドレスが検証済みで、97% 以上の配信保証があることを意味します
3. コストを確認します：有効な意思決定者の検索結果は 2 クレジットです（標準的な人物検索は 1 クレジット）
4. 結果が risky の場合は、POST /v5.1/verify.json（0.2 クレジット）で別途検証するか、LinkedIn URL を照合して、その人物が現在もその役職に就いていることを確認するよう勧めます
5. アウトリーチに利用できるよう、連絡先の名前、役職、LinkedIn プロフィール、検証済みメールアドレスをユーザーに提示します 結果：ユーザーは、背景情報として LinkedIn プロフィールも確認できる、acme.com のマーケティング部門の意思決定者の検証済み連絡先を取得し、パーソナライズしたアウトリーチを開始できます

例 2：Webhook 通知を使った一括メール検索

ユーザーの発言：「名前と会社名が記載された、5,000 人分の見込み客の CSV があります。メールアドレスを一括で探したいです。」 スキルの動作：

1. Authorization: <api-key> と x-webhook-url: https://myapp.com/webhook のヘッダーを指定し、POST /v5.1/bulk/upload.json で CSV をアップロードします
2. 非同期処理について説明します：5 分ごとに約 1,000 行が処理されるため、5,000 行の処理には約 25 分かかります
3. ユーザーが結果をダウンロードするまでクレジットは請求されず、先にジョブの概要を確認できることを伝えます
4. Webhook が呼び出されるか、ユーザーがステータスを確認すると、結果をダウンロードできるようになります
5. ダウンロードした結果のフィルタリング方法を案内します：アウトリーチでは valid のメールを優先し、risky は慎重に扱い、not_found は破棄します
6. クレジットのコストを見積もります：すべての結果が有効な場合は最大 5,000 クレジットです（人物検索 1 件につき 1 クレジット）。ただし、risky と not_found の結果は無料のため、実際のコストはヒット率によって異なります 結果：ユーザーは、5,000 人の見込み客について一括処理された検証済みメールアドレスのリストを取得できます。ステータスが明確に示され、有効な結果に対してのみクレジットが請求されます

例 3：既存のメールリストを検証して整理する

ユーザーの発言：「展示会で入手したメールアドレスが200件あります。CRMに追加する前に、どうすれば有効性を確認できますか？」 スキルの動作：

1. 個別に検証する場合：POST /v5.1/verify.json に email_address を指定します。有効、リスクあり、無効のいずれかが返されます（1件あたり0.2クレジット）。
2. 200件の場合は、効率を高めるため一括処理を推奨します。POST /v5.1/bulk/search.json にJSON形式で送信するか、CSVをアップロードします。
3. クレジット費用を見積もります。検証には200 × 0.2 = 40クレジットが必要で、Starterプラン（毎月50クレジット）でも利用できます。
4. ステータスの意味を説明します。valid = CRMに追加してメールを送信しても安全（97％以上の配信保証）、risky = 機能する可能性はありますが未検証（キャッチオールドメインでよく見られます）、invalid = メールを送信しないでください。
5. セグメント分けを推奨します。valid はすぐにCRMに追加し、risky は手動確認または二次検証のために保留し、invalid は破棄します。
6. これらのメールアドレスはいずれも30日以内の再検証が無料であることを伝えます。キャンペーン開始前に再確認しても安心です。 結果：200件のアドレスを検証し、40クレジットで整理・セグメント分けしたメールリストを用意できました。バウンスのリスクを取り除き、CRMにインポートできる状態です。

トラブルシューティング

Person検索で既知の連絡先がnot_foundになる

症状：正しい名前とドメインを指定して POST /v5.1/search/person.json を呼び出しても、その人が会社に勤務していることが分かっているのに not_found が返されます。 原因：その人がAnymail Finderのデータベースに登録されていない、指定したドメインが会社の主要なメールドメインではない、または別の名前表記を使っている（例：「Bill」と「William」、旧姓と現在の姓）可能性があります。 解決方法：別の名前の綴りや表記を試してください。会社の主要ドメインのほか、サブドメインや地域別ドメインも試してください。LinkedInのプロフィールが分かっている場合は、代わりにLinkedIn URL検索（POST /v5.1/search/linkedin.json）を試してください。これは別の検索方法を使用します。会社の規模が小さい場合や、その人が就任したばかりの場合は、まだ登録されていない可能性があります。

一括ジョブに予想以上の時間がかかる

症状：10,000行の一括検索ジョブが、完了通知のないまま1時間以上処理中です。 原因：通常、処理速度は5分あたり約1,000行ですが、プラットフォームの負荷が高いと処理が遅くなることがあります。システムは自動でスケールしますが、すぐに反映されるわけではありません。ピーク時に実行する大規模なジョブは、さらに時間がかかる場合があります。 解決方法：Webhook通知だけに頼らず、APIでジョブのステータスを確認してください。Webhookを使用している場合は、Webhook URLにアクセスでき、200レスポンスが返ることを確認してください。時間に制約のあるジョブは、オフピーク時に送信してください。ジョブが停止しているように見える場合は、ジョブIDを添えてAnymail Finderのサポートに問い合わせてください。

有効だと思っていたメールがrisk yステータスになる

症状：以前にその会社の人にメールを正常に送信したことがあるにもかかわらず、メール検索で連絡先のステータスが risky になります。 原因：その会社はキャッチオールのメールドメインを使用している可能性があります。このようなドメインでは、どのアドレス宛てのメールも受信されるため、特定のメールボックスが存在するかどうかを検証できません。特定のアドレスへの配信可能性を97％以上の保証で確認できないため、Anymail Finderは risky を返します。 解決方法：同じドメインで明らかに偽のアドレス（例：[email protected]）を検証し、その結果も risky になるかどうかを確認してください。そうなる場合、そのドメインはキャッチオールです。キャッチオールドメインでは、risky の結果は有効である可能性が高いものの、検証できないものとして扱ってください。すべてのアウトリーチシーケンスに追加する前に、リスクの低い最初のメールを送って配信可能性を確認することを検討してください。risky の結果は無料のため、クレジットは消費されません。