sales-prospeo

Prospeo プラットフォームのヘルプ

人物／企業のエンリッチメントや検索から、一括操作、Chrome 拡張機能、API、インテグレーションまで、Prospeo プラットフォームに関する質問に対応します。

ステップ 1 — 背景情報を確認する

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

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

1. Prospeo のどの分野についてサポートが必要ですか？

   • A) 人物のエンリッチメント — 特定の連絡先の、確認済みメールアドレスや電話番号を見つける
   • B) 企業のエンリッチメント — 企業属性データ、テックスタック、資金調達情報
   • C) 人物検索 — フィルターを使って 2 億件以上の連絡先を検索する
   • D) 企業検索 — フィルターを使って 3,000 万社以上の企業を検索する
   • E) 一括操作 — API 経由で一度に最大 50 件のレコードをエンリッチメントする
   • F) Chrome 拡張機能 — LinkedIn Sales Navigator から情報を抽出する
   • G) API — 認証、エンドポイント、インテグレーション
   • H) インテグレーション — HubSpot、Salesforce、Clay、Zapier、Make、n8n
   • I) クレジットと請求 — クレジットの費用を理解し、利用状況を管理する
   • J) その他 — 内容を説明してください

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

   • A) 営業担当者／AE／BDR
   • B) 営業マネージャー／チームリーダー
   • C) RevOps／Sales Ops
   • D) グロース／マーケティング
   • E) 開発者／エンジニア
   • F) 創業者／個人営業担当者
   • G) その他

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

ユーザーのリクエストに、これらの背景情報のほとんどがすでに含まれている場合は、該当するステップに直接進みます。 妥当な仮定を明示したうえで、できる限りの回答を先に示し、最後に最も重要な確認質問を 1～2 個だけ尋ねます。背景情報がすべて揃うまで回答を保留しないでください。

ステップ 2 — 適切なスキルに振り分けるか、直接回答する

リクエストが特定のスキルに該当する場合は、次のように振り分けます。

• プロスペクトリストを一から作成する → /sales-prospect-list
• 複数のツールにまたがるエンリッチメント戦略 → /sales-enrich
• メールの到達性／確認戦略 → /sales-deliverability
• 購買シグナル／インテントの解釈 → /sales-intent
• ツール／Webhook／Zapier の接続 → /sales-integration

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

ステップ 3 — Prospeo プラットフォームのリファレンス

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

プラットフォームガイドの詳細を確認する必要はなくなりました。ユーザーの具体的な状況に集中してください。

ステップ 4 — 実行可能なガイダンスを提供する

ユーザーの具体的な質問に基づいて、次の内容を提示します。

1. 手順 — Prospeo で目標を達成するための番号付きの手順
2. 設定の推奨事項 — ナビゲーションパスを含む具体的な設定
3. よくある落とし穴 — 起こりうる問題と、その回避方法
4. 確認方法 — 変更が反映されたことを確認する方法
5. API に関する質問の場合 — 必ず次の文を含めます。「エンドポイントの全カタログ、リクエスト／レスポンスのスキーマ、レート制限については、references/prospeo-api-reference.md を参照してください。」

注意点

調査に基づくベストエフォートの情報です。特に、プランによって利用が制限される機能や、古くなっている可能性のある連携に関する注意点を確認してください。

• 検索とエンリッチメントを混同しないでください。 Person Search と Company Search はプロフィールデータを返しますが、メールアドレスや電話番号は返しません。連絡先情報を取得するには、別途 Enrich Person／Company を呼び出す必要があります。これは2段階のプロセスで、各ステップでクレジットが消費されます。

• モバイル情報のエンリッチメントには10倍のコストがかかることを忘れないでください。 標準のエンリッチメントは1クレジットですが、enrich_mobile: true を追加すると10クレジットになります。大量に処理するとすぐにコストがかさみます。実際に電話をかける連絡先に限って、モバイル情報を有効にしてください。

• 非推奨のエンドポイントは使用しないでください。 旧 Email Finder、Mobile Finder、Email Verifier、Domain Search、Social URL Enrichment の各エンドポイントは、2026年3月1日に削除されました。代わりに、新しい Enrich Person／Company エンドポイントを使用してください。

• 無期限の重複排除を見落とさないでください。 Prospeoでは、同じレコードを再エンリッチメントしても課金されません。すでにエンリッチメントした人物の最新データが必要な場合は、エンリッチメントを再実行すれば無料で取得できます。ただし、これはチームメンバー単位ではなく、アカウント単位で適用されます。

• 会社名だけで検索しないでください。 会社名の照合はあいまいで、誤った結果が返されることがあります。可能な場合は、会社の識別子としてウェブサイト／ドメインまたは LinkedIn URL を必ず使用してください。

• 自己改善：ここに記載されていない情報を見つけた場合は、今日の日付とともに references/learnings.md に追記してください。

ステップ5 — 関連スキル

• /sales-enrich — 複数のツールをまたいだエンリッチメント戦略（ウォーターフォール、CRM のデータ品質管理、クレジットの最適化）
• /sales-prospect-list — Prospeo でエンリッチメントする見込み顧客リストを作成
• /sales-deliverability — メールの到達率 — 送信前にメールアドレスを検証
• /sales-intent — エンリッチメント済みの連絡先に購買シグナルを追加し、アプローチの優先順位を決定
• /sales-cadence — エンリッチメント済みの連絡先向けにアウトバウンドシーケンスを設計
• /sales-integration — API、Zapier、Make、n8n 経由で Prospeo を他のツールに接続
• /sales-do — どのスキルを使えばよいかわからない場合に使用します。ルーターがあらゆる営業の目的に適したスキルを選びます。インストール：npx skills add sales-skills/sales --skill sales-do

使用例

例1：見込み顧客のリストをエンリッチメントする

ユーザーの発言：「Sales Navigator から取得した LinkedIn URL が200件あります。Prospeo でメールアドレスをすべてエンリッチメントするにはどうすればよいですか？」 スキルの動作：

1. LinkedIn URL を使って、Bulk Enrich Person API エンドポイントを使用する方法を推奨します
2. 50件ずつのグループに分ける方法を説明します（1回の API 呼び出しあたりの上限）
3. linkedin_url をデータフィールドとして使う API リクエスト形式を示します
4. クレジットを節約するため、only_verified_email: true の設定を推奨します
5. クレジットコストを計算します：最大200クレジット（マッチ1件につき1クレジット、マッチなしの場合は無料） 結果：ユーザーは、API の例とクレジットの見積もりを含む、バッチ処理によるエンリッチメント計画を得られます

例2：対象企業の意思決定者を見つける

ユーザーの発言：「従業員数が100～500人の SaaS 企業50社で、VP レベルの連絡先を見つける必要があります」 スキルの動作：

1. 会社フィルター（headcount_range、industry）と人物フィルター（seniority：VP）を使った Search Person の使用を推奨します
2. 対象ドメインのリストを使って company.websites フィルターを使用する方法を示します
3. メールアドレスを取得するには、検索結果を別途エンリッチメントする必要があることを説明します
4. ワークフローを提案します：Search → 結果をフィルタリング → 上位の一致候補を Bulk Enrich 結果：フィルター設定を含む、検索からエンリッチメントへ進む2段階のワークフローが得られます

例3：CRM との API 連携

ユーザーの発言：「Prospeo で HubSpot の新しい連絡先を自動エンリッチメントするには、どう設定すればよいですか？」 スキルの動作：

1. ユーザーが HubSpot のネイティブ連携とカスタム API パイプラインのどちらを希望するか確認します
2. ネイティブ連携の場合：Prospeo の設定で HubSpot を接続する手順を案内します
3. カスタム連携の場合：Zapier／Make のワークフローを設計します — HubSpot の「New Contact」トリガー → Prospeo の Enrich Person アクション → エンリッチメント済みのフィールドで HubSpot の「Update Contact」
4. 継続的な自動エンリッチメントに必要なクレジット予算について説明します 結果：クレジット管理戦略を含む、自動エンリッチメントパイプラインが得られます

トラブルシューティング

エンリッチメントのマッチ率が低い

症状：多くのレコードで NO_MATCH が返されます 原因：識別に必要なデータが不足しているか、対象の連絡先がデータベースのカバー率が低いニッチな業界に属しています 解決策：最適なマッチングのために、複数のデータポイント（名前 + 会社のウェブサイト + LinkedIn URL）を指定してください。未検証の結果を表示するには、only_verified_email: false を使用します。カバー率が低いセグメントでは、複数のプロバイダーを使ったウォーターフォールエンリッチメントを検討してください。詳しくは /sales-enrich をご覧ください。

API が 429 エラーを返す

症状：API 呼び出しでレート制限超過エラーが発生します 原因：ご利用プランの上限を超えるリクエストを、1 分間または 1 秒間に送信しています 解決策：レスポンスヘッダー（x-minute-request-left、x-second-rate-limit）を確認して、上限を把握してください。429 レスポンスには指数バックオフを実装します。リクエスト数を減らすには、個別のエンリッチメントではなく、一括エンドポイント（1 回の呼び出しで 50 レコード）を使用してください。

月の途中でクレジットがなくなる

症状：請求サイクルのリセット前に INSUFFICIENT_CREDITS エラーが発生します 原因：モバイルエンリッチメントでクレジットを 10 倍消費しているか、一括操作で条件に合わないレコードをエンリッチしています 解決策：Account Information エンドポイントまたはダッシュボードで使用状況を確認してください。電話をかけない連絡先では enrich_mobile を無効にします。検証できないレコードを除外するには、only_verified_email: true を使用してください。エンリッチメントの前に ICP フィルターを適用します。今後連絡する予定のない連絡先はエンリッチしないでください。