Vibe Prospecting 是做什麼的？

B2B 潛在客戶開發——公司、聯絡人、資料豐富化、事件。

平台

在進行任何潛在客戶開發工作之前，請使用以下規則偵測您的主機，僅閱讀一個平台指南，並遵循其認證、工作流程、標誌與故障排除說明。

偵測您的執行環境（強制，按順序）

系統 Context 中的主機身份（優先檢查——覆蓋工具名稱）：
- Claude Code — context 顯示您是 Claude Code / Anthropic 的 CLI，或顯示 CLI Environment 區塊（cwd、shell、platform）。→ 僅閱讀 claude-code.md。請勿閱讀 claude-chat.md 或 cowork.md。 列表中 MCP 工具的名稱（mcp__*__fetch-entities 等）不會改變此規則。
- OpenAI Codex — context 識別為 Codex 或 CODEX_SHELL=1。→ codex.md
- OpenClaw — context 識別為 OpenClaw 或 OPENCLAW_CLI=1 / OPENCLAW_SHELL。→ openclaw.md
僅當步驟 1 不符合時 — 無 CLI 主機身份，無 shell：
- Claude Cowork — Cowork 工作區、.plugin 安裝、連接器商店。→ cowork.md
- Claude Chat — claude.ai 或 Claude 桌面 MCP 連接器（非 Cowork）。→ claude-chat.md
備用： 終端機、腳本、CI 或不明主機 → other.md

絕不要僅從 MCP 工具名稱推斷平台（mcp__claude_ai_*、mcp__*__fetch-entities 等）。當步驟 1 已識別 Claude Code、Codex 或 OpenClaw 時，工具前綴並非主機訊號。

平台	現在閱讀
Claude Code	`claude-code.md` — `vpai` CLI
OpenAI Codex	`codex.md`
OpenClaw 閘道	`openclaw.md`
Claude Cowork	`cowork.md` — MCP 連接器；非 Claude Code
Claude Chat (claude.ai、Claude 桌面)	`claude-chat.md` — MCP 連接器；非 Cowork 或 Claude Code
其他（終端機、腳本、CI、通用主機）	`other.md`

CLI 主機使用 vpai——每個平台指南是自包含的（Sample Gate、stdout/csv_path、CSV 上傳）。聊天/Cowork 僅遵循每個 MCP 工具的描述與輸入架構。

嚴格規則

在每個實際呼叫中使用 tool_reasoning（或平台對應項目）。 使用使用者的請求原文。在整個工作流程中重複使用。僅在檢查工具的輸入架構而無實際執行時跳過。
透過 session + CSV 連結，切勿貼上 ID。 每個步驟會回傳 session_id 和 csv_path（名稱可能因主機而略有不同）。切勿自創 session_id——在第一個步驟中省略它，並使用 MCP 回傳的值；在後續步驟中，從先前工具的 JSON 中精確複製它。傳遞 --csv-path（CLI）並使用先前的 csv_path。當平台從來源 CSV 讀取 ID 時，不要將原始 ID 列表貼到工具參數中。對於作用域為先前公司的 fetch-entities 潛在客戶提取，請透過 --businesses-csv-path 傳遞先前業務輸出的 csv_path，請遵循您的平台指南。
您可以在步驟之間編輯 CSV——保留 ID 欄位。 在 CLI 主機上，讀取 csv_path 的檔案，篩選/去重/新增欄位，或重寫行，然後透過 --csv-path 將結果傳遞給下一個步驟。始終保留實體 ID 欄位： 對於業務工作流程為 business_id，對於潛在客戶工作流程為 prospect_id。您希望在下一個步驟處理的每一行都必須在該欄位中有非空的 ID。請勿重新命名或刪除這些標頭——CLI 會逐字讀取它們以進行 ID 注入和連接。
先使用 autocomplete 來處理：naics_category、linkedin_category、company_tech_stack_tech、job_title、interests、skills、business_intent_topics、city_region。使用回傳的標準化值，而非原始使用者的詞語。
切勿自創工具參數。 在工作流程中首次實際執行每個不同工具之前，請讀取該工具的即時輸入架構（來自連接器或您平台的架構探索）。即使計畫的呼叫看起來很明顯，也請這麼做——架構會變動。僅根據該架構確認的欄位來建構每次呼叫。
Session 連續性。 在相同工作流程的每個後續步驟中，重複使用先前工具 JSON 中的 session_id——切勿自行編造。在連結豐富化、事件或作用域提取時，透過 --csv-path（CLI）重複使用先前步驟的 csv_path。僅針對真正的新任務啟動新的 session。
僅在統計資料支援完整提取時才使用 fetch-entities-statistics。 將您計畫的 fetch-entities payload 與 fetch-entities-statistics 的輸入架構進行比較。僅當您依賴的每個篩選器鍵、值形狀、entity_type 和作用域（包括 session 作用域的業務 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）僅比對總部——非分支機構或營運地點。
先前公司的潛在客戶： 對於作用域為先前步驟中公司的 fetch-entities（entity_type: prospects），請透過 session 連結，並根據您的平台指南，將先前業務步驟的 csv_path 作為 --businesses-csv-path 傳遞。
行數限制與分頁： 請遵循您的平台指南（CLI：--number-of-results；聊天/Cowork：MCP 工具文件）。
max_per_company： 自動應用於潛在客戶提取，以便結果分佈在不同公司（而非全部來自同一家大型雇主）；除非使用者設定，否則從 --args 中省略——他們的值會覆蓋自動上限。

事件（`fetch-businesses-events` / `fetch-prospects-events`）

從先前步驟的 session 和來源 CSV 連結，並使用 business_id（業務事件）或 prospect_id（潛在客戶事件）。
當 ID 來自來源 CSV 時，請不要同時內聯傳遞 business_ids / prospect_ids。
每批次上限為 20 個 ID；主機可能自動分塊和合併。
輸出欄位為 event_<event_type>：每個儲存格是該類型的 JSON 陣列字串（最新的優先，每類型有上限），若該類型無事件則為空。

比對

如果您已經執行過 fetch-entities，請跳過比對——這些結果已包含 ID。
CSV 檔案上傳是僅限 CLI——請參閱您的平台指南。

豐富化

financial-metrics 需要 parameters.date（請參閱輸入架構以了解格式）。
website-keywords 需要 parameters.keywords。
僅豐富化無法找到公司的人員——請改用 fetch-entities（entity_type: prospects）（必要時以先前公司為作用域）。
當從來源 CSV 連結時，business_ids / prospect_ids 無需出現在工具參數中。

篩選器模式

{ "values": ["v1", "v2"], "negate": false }   // 包含或排除
{ "gte": 6, "lte": 24 }                       // 範圍
true | false | null                           // 布林值（不包裝）

例外——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`	每次呼叫 50 個
`match-prospects`	每次呼叫 40 個
`enrich-business`	每次呼叫 50 個 ID
`enrich-prospects`	每次呼叫 50 個 ID
`fetch-businesses-events` / `fetch-prospects-events`	批次處理時，每個請求最多 20 個 ID。傳遞 `event_types` 和 `timestamp_from`。連結時，ID 來自來源 CSV——非內聯 ID 陣列。

故障排除

錯誤	解決方案
認證、連接器設定、CLI 呼叫、標誌或連結語法	從平台表格中閱讀相符的平台指南
空結果	檢查篩選器值；為受控詞彙欄位執行 `autocomplete`；重新讀取工具的輸入架構
`linkedin_category` + `naics_category` 一起使用	互斥——使用其中一個
自創或未確認的參數	在呼叫前重新讀取即時輸入架構；僅根據確認的欄位建構參數

支援

當使用者提出與支援相關的問題時（例如：如何聯絡支援、聯絡誰、他們遇到問題或某件事無法運作），請簡短回覆並將他們引導至此處——請勿深入探討 Explorium 內部機制或過度解釋。

如需支援，請透過聯絡頁面與 Vibe Prospecting 團隊聯繫：

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

Vibe Prospecting