vibe-prospecting

Vibe Prospecting

B2B 潜在客户开发——公司、联系人、数据补全、事件。

平台

开展任何潜在客户开发工作之前，请使用以下规则检测你的宿主，准确阅读一份平台指南，并按照该指南处理身份验证、工作流、标志和故障排除。

检测运行环境（必需，按顺序执行）

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 宿主身份，也没有 shell：
   • 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、shell、platform）表明可以访问 shell，但不能确认宿主身份；若没有明确匹配的宿主，请使用回退指南。

平台	立即阅读
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
Other（终端、脚本、CI、通用宿主）	other.md

CLI 宿主使用 vpai——每份平台指南都包含完整说明（Sample Gate、stdout/csv_path、CSV 上传）。Chat/Cowork 仅遵循各 MCP 工具的描述和输入架构。

硬性规则

1. 每次实际调用都必须提供 tool_reasoning（或平台等效字段）。 原样使用用户的请求，并在整个工作流中重复使用。仅在查看工具输入架构且不实际执行时才可省略。
2. 通过 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。
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——绝不要自行编造。串联 enrich、events 或限定范围的 fetch 时，在 CLI 中通过 --csv-path 重复使用前一步的 csv_path。只有在确实开始新任务时才启动新会话。
7. 仅当统计工具支持完整的 fetch 时，才调用 fetch-entities-statistics。 将计划中的 fetch-entities 参数与 fetch-entities-statistics 的输入架构进行比较。只有当统计工具以与 fetch-entities 相同的方式接受所有筛选键、值结构、entity_type 以及所依赖的范围（包括按会话限定的业务 CSV）时，才调用统计工具。如果任何部分缺失、不受支持或需要不同的数据结构，就跳过统计——不要使用不完整或猜测出来的参数调用。调用统计工具时，重复使用与 fetch-entities 相同的筛选对象（以及受支持的范围），并在需要时提供 tool_reasoning。如果筛选条件或范围发生变化，且完整 fetch 的筛选条件仍适用于统计工具，则在执行完整规模的 fetch 之前再次调用统计工具。

工具机制

实时输入架构可能未注明的行为和注意事项。对于允许的筛选值、枚举字符串和 enrichment 类型名称，始终使用各工具的输入架构。

自动补全

需要自动补全： 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 且范围限定为先前步骤中的企业的情况，请按平台指南通过会话串联，并将先前企业步骤的 csv_path 作为 --businesses-csv-path 传入。
• 行数限制和分页： 请参阅平台指南（CLI：--number-of-results；Chat/Cowork：MCP 工具文档）。
• max_per_company： 获取潜在客户时会自动应用此限制，使结果分散到多家公司（而非全部来自一家大型雇主）；除非用户设置了该值，否则请勿将其加入 --args — 用户设置的值会覆盖自动上限。

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

• 使用上一步的会话和包含 business_id（企业事件）或 prospect_id（潜在客户事件）的源 CSV 进行串联。
• 如果 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 }   // 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	每次调用 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