Prospector

通过Exa公司搜索+Apollo联系人丰富功能，查找符合您理想客户画像的潜在客户。

前置条件

首先运行/prospector:setup配置您的API密钥：

• - Exa（必需）：https://exa.ai - 公司发现
• Apollo（必需）：https://apollo.io - 联系人丰富
• Attio（可选）：https://attio.com - CRM同步

您也可以通过环境变量设置密钥：

• - PROSPECTOREXAAPIKEY
• PROSPECTORAPOLLOAPIKEY
• PROSPECTORATTIOAPI_KEY（可选）

使用方法

设置（一次性操作）

/prospector:setup

收集并验证API密钥，安全存储在~/.config/prospector/config.json中。

查找潜在客户

/prospector

询问理想客户画像问题，搜索Exa，通过Apollo丰富数据，输出CSV文件到桌面。

主命令：/prospector

当用户调用/prospector时，请遵循以下工作流程：

步骤1：检查配置或环境变量

首先，验证环境变量或配置文件是否存在：

bash
python3 -c
import json
import os
from pathlib import Path
config_path = Path.home() / .config / prospector / config.json
envexa = bool(os.getenv(PROSPECTOREXAAPIKEY))
envapollo = bool(os.getenv(PROSPECTORAPOLLOAPIKEY))
envattio = bool(os.getenv(PROSPECTORATTIOAPIKEY))
if not config_path.exists():
print(NOT_FOUND)
else:
with open(config_path) as f:
config = json.load(f)
print(FOUND)
print(fexa: {bool(config.get(\exaapikey\))})
print(fapollo: {bool(config.get(\apolloapikey\))})
print(fattio: {bool(config.get(\attioapikey\))})
print(fenvexa: {envexa})
print(fenvapollo: {envapollo})
print(fenvattio: {envattio})

如果返回NOT_FOUND且环境变量未设置，告知用户先运行/prospector:setup。

步骤2：询问理想客户画像问题

使用AskUserQuestion按顺序收集理想客户画像标准：

问题1：行业

header: 行业
question: 您针对哪个行业？
options:
- label: SaaS
description: 软件即服务公司
- label: 金融科技
description: 金融科技公司
- label: 医疗健康
description: 医疗健康与健康科技
- label: 电子商务
description: 在线零售与市场平台
- label: 人工智能/机器学习
description: 人工智能与机器学习
- label: 不限
description: 无行业筛选
multiSelect: false

问题2：公司规模

header: 规模
question: 您针对什么规模的公司？
options:
- label: 1-10人
description: 早期创业公司
- label: 11-50人
description: 种子轮到A轮
- label: 51-200人
description: A轮到B轮
- label: 201-500人
description: 成长期
- label: 500人以上
description: 企业级
- label: 不限
description: 无规模筛选
multiSelect: false

问题3：融资阶段

header: 融资
question: 您针对什么融资阶段？
options:
- label: 种子轮前
description: 产品市场匹配前
- label: 种子轮
description: 构建初始产品
- label: A轮
description: 产品规模化
- label: B轮及以上
description: 增长与扩张
- label: 不限
description: 无融资筛选
multiSelect: false

问题4：地理位置

header: 地理位置
question: 您针对什么地理位置？
options:
- label: 美国
description: 美国公司
- label: 欧洲
description: 欧洲公司
- label: 全球
description: 全球范围
- label: 不限
description: 无地理位置筛选
multiSelect: false

问题5：关键词（可选）

header: 关键词
question: 公司描述中需要包含哪些特定关键词？（可选）
options:
- label: 跳过
description: 无关键词筛选
- label: 输入关键词
description: 我将输入特定关键词
multiSelect: false

如果选择输入关键词，则要求用户输入文本。

问题6：联系人数量

header: 数量
question: 您想查找多少位联系人？
options:
- label: 25
description: 快速搜索，API使用量较低
- label: 50
description: 均衡推荐
- label: 100
description: 大批量，API使用量较高
multiSelect: false

步骤3：运行搜索

使用收集到的理想客户画像执行Python脚本：

bash
cd [技能目录]/scripts
python3 -c
from prospector import runsearch, exportcsv, Config

icp = {
industry: [行业],
company_size: [规模],
funding_stage: [融资],
geography: [地理位置],
keywords: [关键词或空字符串]
}

leads = runsearch(icp, numcontacts=[数量])
if leads:
path = export_csv(leads)
print(fSUCCESS: {len(leads)} 条潜在客户已保存至 {path})
else:
print(NO_RESULTS: 未找到符合标准的潜在客户)

将占位符替换为问题中的实际值。

步骤4：Attio同步（如已配置）

如果已配置Attio且找到了潜在客户，询问：

header: Attio
question: 将潜在客户同步到Attio CRM？
options:
- label: 是
description: 将公司和联系人同步到Attio
- label: 否
description: 仅保留CSV文件
multiSelect: false

如果选择是：

bash
cd [技能目录]/scripts
python3 -c
from prospector import synctoattio, Config, Lead
import json

从刚创建的CSV加载潜在客户（或直接传递）

为简化操作，重新运行并同步

companies, people = synctoattio(leads)
print(fSYNCED: {companies} 家公司, {people} 位联系人)

步骤5：报告结果

告知用户：

• - 找到了多少条潜在客户
• CSV文件保存位置
• 如果进行了Attio同步，同步了多少条记录

错误处理

• - 未找到配置：告知用户运行/prospector:setup
• 无效API密钥：告知用户哪个密钥失败，建议重新运行设置
• 无结果：建议放宽理想客户画像标准
• 部分失败：报告成功部分，警告失败部分