vibe-prospecting

Vibe Prospecting

B2B の見込み顧客開拓 — 企業、連絡先、エンリッチメント、イベント。

プラットフォーム

見込み顧客開拓を始める前に、以下のルールでホストを検出し、プラットフォームガイドを1つだけ読み、認証、ワークフロー、フラグ、トラブルシューティングについてそのガイドに従ってください。

ランタイムの検出（必須、順番どおり）

1. システムコンテキスト内のホスト識別情報（最初に確認してください。ツール名より優先されます）：
   • Claude Code — コンテキストで、Claude Code／Anthropic の CLI であることが明示されています。→ claude-code.md のみを読んでください。claude-chat.md または cowork.md は読まないでください。 リスト内の MCP ツール（mcp__*__fetch-entities）によって、この判定が変わることはありません。
   • OpenAI Codex — コンテキストで Codex または CODEX_SHELL=1 が示されています。→ codex.md
   • OpenClaw — コンテキストで OpenClaw または OPENCLAW_CLI=1／OPENCLAW_SHELL が示されています。→ openclaw.md
   • Grok Build — コンテキストで Grok Build／xAI の CLI であることが示されています。→ other.md を読み、vpai CLI ワークフローに従ってください。
2. ステップ1に該当しない場合のみ — CLI のホスト識別情報がなく、シェルもありません：
   • Claude Cowork — Cowork ワークスペース、.plugin インストール、コネクターストア。→ cowork.md
   • Claude Chat — claude.ai または Claude デスクトップの MCP コネクター（Cowork ではありません）。→ claude-chat.md
3. フォールバック： ターミナル、スクリプト、CI、または不明なホスト → other.md

MCP ツール名だけからプラットフォームを推測しないでください（mcp__claude_ai_*、mcp__*__fetch-entities など）。ステップ1で Claude Code、Codex、OpenClaw、または Grok Build と特定済みの場合、ツールのプレフィックスはホストを示すものではありません。汎用 CLI の Environment ブロック（cwd、シェル、プラットフォーム）はシェルへのアクセスを示しますが、ホストの識別情報ではありません。ホストが明示的に一致しない場合は、フォールバックガイドを使用してください。

プラットフォーム	今すぐ読む
Claude Code	claude-code.md — vpai CLI
OpenAI Codex	codex.md
OpenClaw gateway	openclaw.md
Grok Build	other.md — vpai CLI
Claude Cowork	cowork.md — MCP コネクター。Claude Code ではありません
Claude Chat（claude.ai、Claude デスクトップ）	claude-chat.md — MCP コネクター。Cowork または Claude Code ではありません
その他（ターミナル、スクリプト、CI、汎用ホスト）	other.md

CLI ホストでは vpai を使用します。各プラットフォームガイドには、サンプルゲート、標準出力／csv_path、CSV アップロードがすべて記載されています。Chat／Coworkでは、各 MCP ツールの説明と入力スキーマのみに従ってください。

厳守事項

1. すべての実際の呼び出しで tool_reasoning（またはプラットフォーム上の同等の項目）を指定してください。ユーザーの依頼文をそのまま使用してください。ワークフロー全体で同じ内容を再利用してください。ツールの入力スキーマを調べるだけで、実際に実行しない場合に限り、省略できます。
2. セッションと CSV を使って連鎖させ、ID を貼り付けないでください。 各ステップは session_id と csv_path（ホストによって名前が多少異なる場合があります）を返します。session_id を捏造しないでください。最初のステップではこれを省略し、MCP が返した値を使用してください。以降のステップでは、直前のツール JSON から正確にコピーしてください。直前の csv_path を --csv-path（CLI）で渡してください。プラットフォームが ID をソース CSV から読み込む場合、ツール引数に ID のリストを直接貼り付けないでください。以前の企業に絞り込んだ fetch-entities の見込み顧客については、プラットフォームのガイドに従い、直前の企業データ出力の csv_path を --businesses-csv-path で渡してください。
3. ステップ間で CSV を編集してもかまいませんが、ID 列は残してください。 CLI ホストでは、csv_path にあるファイルを読み込み、フィルタリング、重複排除、列の追加、行の書き換えを行ったうえで、結果を --csv-path で次のステップに渡します。エンティティ ID 列は必ず保持してください。ビジネスのワークフローでは business_id、見込み顧客のワークフローでは prospect_id を使います。次のステップで処理する行では、該当列の ID を空欄にしないでください。CLI は ID の挿入や結合にこれらのヘッダーをそのまま使用するため、名前を変更したり削除したりしないでください。
4. 次の項目では、まず autocomplete を使用してください：naics_category、linkedin_category、company_tech_stack_tech、job_title、interests、skills、business_intent_topics、city_region。ユーザーの生の表現ではなく、返された標準化済みの値を使用してください。
5. ツールのパラメーターを捏造しないでください。 ワークフロー内で各ツールを初めて実際に実行する前に、そのツールのライブ入力スキーマ（コネクターまたはプラットフォームのスキーマ検出機能から取得）を確認してください。呼び出し内容が明白に見える場合でも、必ず確認してください。スキーマは変更されることがあります。ツール、フィルター、またはデータ形状が大きく変わった場合は、スキーマを再確認してください。各呼び出しには、そのスキーマで確認できたフィールドのみを使用してください。
6. セッションの継続性を保ってください。 同じワークフロー内の後続ステップでは、直前のツール JSON にある session_id を再利用してください。決して値を捏造しないでください。エンリッチ、イベント、または範囲を指定した取得を連鎖させる場合は、直前のステップの csv_path を --csv-path（CLI）で再利用してください。本当に新しいタスクを開始する場合に限り、新しいセッションを開始してください。
7. 完全な取得条件を統計機能でサポートしている場合に限り、fetch-entities-statistics を使用してください。 予定している fetch-entities のペイロードと、fetch-entities-statistics の入力スキーマを比較してください。統計を呼び出すのは、使用するすべてのフィルターキー、値の形状、entity_type、および範囲（セッションに紐づいた企業 CSV を含む）が、fetch-entities と同じ方法で受け付けられる場合に限ります。一部でも欠けている、サポートされていない、または異なる形状が必要な場合は、統計をスキップしてください。不完全な条件や推測した条件で呼び出さないでください。統計を呼び出す場合は、fetch-entities と同じフィルターオブジェクト（およびサポートされている範囲）を使用し、必要に応じて tool_reasoning も指定してください。フィルターまたは範囲を変更したうえで、その変更後のフィルター一式が引き続き統計に対応している場合は、大規模な取得の前に統計を再度呼び出してください。

ツールの仕組み

ライブ入力スキーマに記載されていない動作や注意事項については、許可されるフィルター値、列挙値の文字列、エンリッチメントタイプ名には、必ず各ツールの入力スキーマを使用してください。

オートコンプリート

オートコンプリートが必要です： linkedin_category、naics_category、company_tech_stack_tech、job_title、interests、skills、business_intent_topics、city_region。

オートコンプリートは不要です： company_country_code（ISO Alpha-2）、company_region_country_code（ISO 3166-2）、固定バケット（company_size、company_revenue、company_age、job_level、job_department — 正確に使用できる文字列は、入力スキーマの fetch-entities ／ fetch-entities-statistics から取得します）、website_keywords（自由入力テキスト）。

相互排他： linkedin_category と naics_category は、どちらか一方のみを使用してください。company_region_country_code と company_country_code も、どちらか一方のみを使用してください。

値の選択： オートコンプリートの結果には、ノイズの多い候補が含まれることがあります。正規のクリーンな値（通常は最初のクリーンな候補）を選んでください。複数の値を指定すると OR ロジックで対象が広がるため、検索範囲を広げたい場合を除き、類似した値の重複は避けてください。

取得

• job_title は完全一致ではなく、部分文字列で照合します。経営幹部を検索する場合は、アシスタント、アドバイザー、役員室付きの役職を除外するため、job_level（通常は c-suite）と組み合わせてください。
• company_size は固定バケットを使用しており、正確な数値の境界はありません。「N 人超」を検索する場合は、隣接するバケットで近似するか、firmographics で正確な従業員数を追加取得してください。
• 事業所の所在地フィルター（company_country_code、company_region_country_code、city_region）は、本社の所在地のみを照合します。支店や事業所の所在地は対象になりません。
• 以前の企業に所属していた見込み客： 以前の手順で取得した企業を対象に entity_type: prospects で fetch-entities を実行する場合は、セッションを介して処理を連鎖させ、プラットフォームガイドに従って、以前の企業取得手順の csv_path を --businesses-csv-path として渡してください。
• 行数の上限とページネーション： プラットフォームガイドに従ってください（CLI：--number-of-results、Chat／Cowork：MCP ツールのドキュメント）。
• max_per_company： 見込み客の取得時には、結果が複数の企業に分散するよう自動的に適用されます（大企業 1 社の結果だけにならないようにします）。ユーザーが値を指定しない限り --args から省略してください。ユーザーが指定した値は自動上限に優先します。

イベント（fetch-businesses-events ／ fetch-prospects-events）

• 直前の手順のセッションとソース CSV を使って処理を連鎖させ、企業イベントには business_id、見込み客イベントには prospect_id を指定してください。
• ID がソース CSV から取得される場合、business_ids ／ prospect_ids をインラインで追加指定しないでください。
• 1 リクエストあたりの上限は 20 ID です。ホストによっては、分割と結合が自動的に行われます。
• 出力列は event_<event_type> です。各セルには、その種類のイベントを格納した JSON 配列文字列（新しい順、種類ごとに上限あり）が入り、該当する種類のイベントがない場合は空になります。

マッチ

• すでに fetch-entities を実行している場合は、結果に ID が含まれるため、マッチを省略してください。
• CSV ファイルのアップロードは CLI のみで可能です。プラットフォームガイドを参照してください。

エンリッチ

• financial-metrics には parameters.date が必要です（形式は入力スキーマを参照してください）。
• website-keywords には parameters.keywords が必要です。
• エンリッチだけでは企業の人物を見つけられません。代わりに、必要に応じて以前の企業に対象を絞ったうえで、entity_type: prospects を指定して fetch-entities を使用してください。
• ソース CSV を使って処理を連鎖させる場合、ツール引数に business_ids ／ prospect_ids を含める必要はありません。

フィルターパターン

{ "values": ["v1", "v2"], "negate": false }   // include or exclude
{ "gte": 6, "lte": 24 }                       // range
true | false | null                           // boolean (not wrapped)

例外 — business_intent_topics： { "topics": ["Category:Topic"], "negate": false } を使用してください（values ではありません）。トピックは autocomplete から取得してください。

所在地の照合： 事業所の所在地フィルター（company_country_code、company_region_country_code、city_region）は、企業の本社所在地のみを照合します。たとえば「英国の企業」を検索すると、本社が英国にある企業が返され、英国で事業を行っているだけの外国企業は除外されます。これは、すべての fetch-entities ／ fetch-entities-statistics の企業検索でのデフォルト動作であり、ユーザーによる変更はできません。

制限

ツール	上限
match-business	1 回の呼び出しにつき 50
match-prospects	1 回の呼び出しにつき 40
enrich-business	1 回の呼び出しにつき 50 ID
enrich-prospects	1 回の呼び出しにつき 50 ID
fetch-businesses-events / fetch-prospects-events	バッチ処理の場合、リクエストごとに最大 20 ID です。event_types と timestamp_from を渡してください。連鎖処理では、ID はインラインの ID 配列ではなく、ソース CSV から取得します。

トラブルシューティング

エラー	解決方法
認証、コネクターのセットアップ、CLI の実行、フラグ、または連鎖処理の構文	Platform テーブルから該当するプラットフォームガイドをお読みください
結果が空	フィルター値を確認してください。選択肢が制限された語彙を使うフィールドでは autocomplete を実行し、ツールの入力スキーマを再度お読みください
linkedin_category と naics_category の併用	相互排他的です。どちらか一方を使用してください
作成されたパラメーター、または確認されていないパラメーター	呼び出しの前に最新の入力スキーマを再度お読みください。確認済みのフィールドのみを使って引数を作成してください

サポート

ユーザーからサポートに関する質問（たとえば、サポートへの連絡方法や問い合わせ先、問題がある場合、または何かが正常に動作しない場合）を受けたら、簡潔に返信して、以下のページを案内してください。Explorium の内部事情を調べたり、詳しく説明したりしないでください。

サポートについては、お問い合わせページから Vibe Prospecting チームにご連絡ください。

👉 https://www.vibeprospecting.ai/contact-us