使用说明
GTM-MCP——克劳德代码B2B冷外联工具包
一套技能和API包装器，将Claude Code变成一个完整的B2B冷电子邮件管道。描述你销售的产品和你的目标客户——它可以找到公司、验证合适性、提取联系人、编写序列和启动活动。所有这些都来自你的终端，都在你的机器上。
建造于 GetSallyB2B潜在客户开发机构。该工具包中的分类规则、过滤逻辑和电子邮件模式来自为美国、欧盟和其他市场（从早期初创企业到大型企业）的100多家B2B公司开展的数千次外展活动。我们的活动每月提供10-50个合格的潜在客户。我们的20人销售团队每天使用。现在开源。
如需更新，请关注 Rinat Khatipov在领英上.
我们有一个 松弛的工作空间 在这里，您可以提问、报告错误、请求集成，并分享您如何使用该工具包。
要求和灵活性
完整版 /launch 管道运行在三个工具上： 阿波罗 对于公司和人员数据， SmartLead 用于电子邮件活动，以及 Apify 用于网页抓取。如果您已经使用Apollo+SmartLead，您可以插入API密钥并端到端地运行整个管道。
不使用这些工具？ 你仍然可以掌握个人技能，并在自己的设置中使用它们——人工智能分类技能、ICP过滤逻辑、电子邮件序列模式。它们只是中的标记文件 .claude/skills/，可移植到任何Claude Code项目。
我们正在积极开发更多的集成（Instantly、Lemlist、ZoomInfo、Hunter等），为您的堆栈提供更大的灵活性。如果您的设置需要我们尚未涵盖的内容-- 打开一个问题 或者发表评论。反馈塑造了我们下一步的构建。
入门指南
打开终端，复制粘贴下面的每个块，一次一个。这就是整个安装过程。
在Mac上：按 Cmd + Space，键入“终端”，按Enter键。在Windows上：打开“Windows终端”或“PowerShell”。
步骤1——克隆仓库
git clone https://github.com/impecablemee/gtm-mcp.git
cd gtm-mcp
步骤2-添加您的API密钥
cp .env.example .env
打开 .env 在任何文本编辑器中填写：
| 密钥 | 在哪里获取 | 必填项？ |
|---|---|---|
GTM_MCP_APOLLO_API_KEY |
阿波罗 → 设置→ API密钥 | 是 |
GTM_MCP_SMARTLEAD_API_KEY |
SmartLead → 设置→ API | 是 |
GTM_MCP_USER_EMAIL |
您的电子邮件--测试电子邮件在激活前会到达此处 | 是 |
GTM_MCP_APIFY_PROXY_PASSWORD |
Apify → 代理→ 密码 | 可选，改进抓取 |
GTM_MCP_GETSALES_API_KEY |
GetSales → 设置 | 可选，用于LinkedIn推广 |
GTM_MCP_GETSALES_TEAM_ID |
GetSales→ 团队设置 | 可选，用于LinkedIn推广 |
GOOGLE_SERVICE_ACCOUNT_JSON |
Google Cloud控制台 | 可选，用于表格导出 |
GOOGLE_SHARED_DRIVE_ID |
Google Drive | 可选，用于表格导出 |
保存并关闭文件。
步骤3——在Claude代码中打开
claude
这将在内部打开Claude Code gtm-mcp 目录。它会自动发现 .mcp.json 并装载所有工具。不 pip install，无虚拟-- uv run 处理一切。
如果
claude无法识别，请先安装Claude Code：https://docs.anthropic.com/en/docs/claude-code/overview
如何使用
第一步：制定外展策略
在启动活动之前，您需要一个策略——一个md文件，描述您销售的产品、目标客户、细分市场以及您有哪些案例研究。创建一个的两种方法：
选项A——让克劳德为你生成。
在gtm-mcp目录中的Claude Code内部：
Generate an outreach strategy for [yourwebsite.com].
Use all case studies from the website — focus on segments
where we have proven results and success stories.
您还可以向克劳德提供其他材料：球场甲板、产品描述、报价。更多的上下文=更准确的策略。
Claude抓取您的网站，研究案例研究和产品页面，并生成一个包含分段、Apollo关键字和电子邮件草稿序列的结构化md文件。另存为 outreach-plan-[segment].md.
查看文档，必要时进行调整，然后转到步骤2。
选项B--手动创建策略文件。
如果您已经知道您的ICP并希望完全控制，请自己创建一个md文件并将其放置在项目目录中。
第二步：启动活动
当你的策略准备就绪时，启动活动。类型 /launch，提供您的网站并详细描述您的ICP。 ICP描述越详细越好 --它直接决定了过滤质量以及有多少目标公司最终参与了活动。
从战略文件中：
/launch outreach-plan-fintech.md
或者直接从URL+ICP描述：
/launch https://yourcompany.com fintech payments companies in US, 50-500 employees, Series A+
之后会发生什么 /launch:
- 提供提取 --克劳德阅读你的策略（或浏览网站），并建立一个结构化的档案：你卖什么，谁需要它，你解决了什么问题。
- 过滤器生成 --根据报价，选择Apollo关键字和过滤器。运行探测搜索（6学分）以估算体积和成本。
- ⏸️ 战略审批 --显示完整计划：关键字、地理位置、成本估算、电子邮件草稿序列。 除非你说“是”，否则什么都不会跑。 您可以调整：删除关键字、添加地理位置、更改电子邮件副本。
- 搜索和分类 --在阿波罗搜索公司，抓取每个网站，使用人工智能确定：这家公司真的是你的目标吗？过滤掉60-70%的无关结果。
- 触点提取 --在每个经过验证的公司找到决策者。免费用户先搜索，然后付费丰富（每个联系人1个阿波罗积分）。
- 活动创建 --在草稿模式下创建SmartLead活动（不发送！）。上传联系人，设置序列。向您的收件箱发送测试电子邮件。
- ⏸️ 激活 --你查看测试电子邮件。如果它看起来不错，键入
activate。只有到那时，SmartLead才会开始发送。
你决定的两个时刻： 策略批准（步骤3）和活动激活（步骤7）。介于两者之间的一切都是自主的。
发射后
- 添加更多联系人 对于跑步活动：
gather 50 more - 新细分市场 在现有项目中：
/launch project=easystaff segment=LENDING geo=UK - 添加到任何SmartLead活动 （即使是手动创建的）：
/launch campaign=3070919 kpi=+100--粘贴活动URL并描述您想要什么。系统会自动对现有潜在客户进行重复数据消除。
建筑
Claude Code ──stdio──> gtm-mcp (49 tools, 0 LLM calls)
|
+---------+---------+
v v v
Apollo SmartLead GetSales
(search) (campaigns) (LinkedIn)
工具箱内没有LLM调用。Claude Code使用编码为技能的领域知识进行所有推理。
工具 (src/gtm_mcp/)：薄API包装。只有数据访问。
技能 (.claude/skills/)：markdown中的领域知识——分类规则、电子邮件编写规则、过滤策略。克劳德读了这些和原因。
命令 (.claude/commands/)：The /launch 命令——协调整个管道。
管道步骤
| 步骤 | 发生了什么 | 人工输入 |
|---|---|---|
| 1.提取报价 | 抓取URL/读取文件/解析文本->结构化ICP | - |
| 2.生成过滤器 | Apollo分类+关键字+探测（6学分） | - |
| 3.策略审批 | 显示报价+筛选+成本估算 | 批准？ |
| 4.收集+分类 | 阿波罗搜索->抓取网站->人工智能分类 | - |
| 5.提取人物 | 免费搜索->付费丰富（1学分/人） | - |
| 6.生成序列 | 根据12条规则模板或引用生成电子邮件序列 | - |
| 7.活动推送 | SmartLead草稿+测试电子邮件+谷歌表格 | 激活 |
关键规则
- 每个Apollo请求1个关键字 --独特公司比合并公司多7倍
- 通过否定分类 --排除非目标，不定义目标（准确率97%）
- 最多200阿波罗学分 每次运行（默认，可覆盖）
- 100个已验证的联系人 KPI目标（默认，可覆盖）
- 纯文本电子邮件，无跟踪，周一至周五9-18目标时区
工具（49）
配置与项目（8）
| 工具 | 说明 |
|---|---|
get_config |
获取配置状态（设置了哪些密钥） |
set_config |
设置配置值 |
create_project |
创建新项目 |
list_projects |
列出所有项目 |
save_data |
将数据保存到项目工作区（写入/合并/附加/版本化） |
load_data |
从项目工作区加载数据 |
find_campaign |
通过SmartLead ID或项目间的slug查找活动 |
get_project_costs |
每个项目的成本明细——总计、每个活动、每次运行 |
黑名单（3）
| 工具 | 说明 |
|---|---|
blacklist_check |
检查域是否被列入黑名单（支持时间窗口检查） |
blacklist_add |
添加包含元数据（来源、活动、联系日期）的域 |
blacklist_import |
从文件导入黑名单 |
阿波罗（6）
| 工具 | 说明 |
|---|---|
apollo_search_companies |
按关键字、行业、位置、规模、资金进行搜索 |
apollo_search_people |
搜索公司人员（免费-无积分） |
apollo_enrich_people |
用经过验证的电子邮件丰富内容（1个信用卡/人） |
apollo_enrich_companies |
按域名批量丰富公司 |
apollo_get_taxonomy |
使用tag_ids获取全部84个阿波罗行业 |
apollo_estimate_cost |
估算管道运行所需的信用额度 |
报废（2）
| 工具 | 说明 |
|---|---|
scrape_website |
通过具有回退功能的Apify代理抓取网站文本 |
scrape_batch |
批量并行抓取多个URL（50个并发） |
智能领导（13）
| 工具 | 说明 |
|---|---|
smartlead_list_campaigns |
列出所有活动 |
smartlead_list_accounts |
列出所有电子邮件帐户（分页，可处理2000+个） |
smartlead_search_accounts |
按名称/域筛选缓存帐户 |
smartlead_create_campaign |
使用日程表和设置创建活动（草稿） |
smartlead_set_sequence |
使用A/B变体支持设置电子邮件序列步骤 |
smartlead_add_leads |
通过公司名称规范化将潜在客户添加到活动中 |
smartlead_get_campaign |
获取活动详细信息（帐户、序列、状态） |
smartlead_get_lead_messages |
获取完整消息线程以进行回复分类 |
smartlead_export_leads |
导出活动中的所有潜在客户（用于删除/黑名单） |
smartlead_sync_replies |
同步回复了活动中的线索 |
smartlead_send_reply |
向潜在客户发送回复 |
smartlead_send_test_email |
激活前发送测试电子邮件进行验证 |
smartlead_activate_campaign |
激活活动--开始发送（需要确认） |
GetSales-领英（4）
| 工具 | 说明 |
|---|---|
getsales_list_profiles |
列出LinkedIn个人资料 |
getsales_create_flow |
创建LinkedIn外展流 |
getsales_add_leads |
将潜在客户添加到GetSales流中（验证LinkedIn URL） |
getsales_activate_flow |
激活流程——开始LinkedIn推广 |
谷歌表格（3）
| 工具 | 说明 |
|---|---|
sheets_create |
在共享驱动器上创建带有联系人标题的Google表格 |
sheets_export_contacts |
通过分类推理导出联系人 |
sheets_read |
读取表单数据（用于黑名单导入、公司列表） |
管道（7）
| 工具 | 说明 |
|---|---|
pipeline_probe |
探测搜索——6次阿波罗呼叫+一次呼叫中的批量抓取 |
pipeline_gather_and_scrape |
完整收集——所有阿波罗搜索+所有抓取、流媒体 |
pipeline_import_blacklist |
将SmartLead活动线索导出为项目黑名单 |
pipeline_save_contacts |
将联系人保存到项目+原子运行文件 |
pipeline_compute_leaderboard |
根据运行数据计算关键字质量分数 |
pipeline_save_intelligence |
保存交叉运行关键字智能以备将来运行 |
campaign_push |
原子战役设置——创建+序列+线索+测试电子邮件 |
作业（2）
| 工具 | 说明 |
|---|---|
assign_campaigns_to_projects |
自动将SmartLead活动分配给项目 |
learn_assignment_correction |
从用户更正中学习，以便将来自动分配 |
公用事业（1）
| 工具 | 说明 |
|---|---|
normalize_company_name |
去掉法律后缀（Inc、LLC、Ltd、GmbH等） |
数据存储
中的所有项目数据 ~/.gtm-mcp/projects/<slug>/:
~/.gtm-mcp/
├── config.yaml # API keys
├── blacklist.json # global domain blacklist (structured, temporal)
├── filter_intelligence.json # cross-run keyword quality scores
└── projects/
└── sally-fintech/
├── project.yaml # offer, segments, ICP
├── state.yaml # pipeline phase progress
├── contacts.json # extracted contacts
├── runs/
│ └── run-001.json # complete execution record
└── campaigns/
└── payments-us/
├── campaign.yaml
├── sequence.yaml
└── replies.json
电子邮件基础架构
在发送冷邮件之前，您需要单独的发送域和收件箱-- 永远不要从你的主域发送冷外展 （谷歌/微软会将其标记为垃圾邮件，您将停止接收正常的商务电子邮件）。
您需要什么：
- 5+相似域名 （例如。，
acme-team.com,getacme.com)--约10美元/域名/年 Namecheap - 每个域2个收件箱 通过 Google 工作区
- 将所有收件箱连接到 SmartLead 并进行热身（大约在开始发送前2周）
- 容量： 每个域名每天约100封电子邮件。5个域名=约500封电子邮件/天
- 每4-6周轮换一次 --随着收件人将电子邮件标记为垃圾邮件，域名会随着时间的推移而降级。买新的，热身，退役旧的。
发展
pip install -e ".[dev]"
pytest tests/ -v
受启发于
克劳德管 --文件优先代理编排框架。采用的核心思想：状态持久化到YAML文件，阶段之间的质量门，通过确定性工具代码预测成本。
许可证
麻省理工学院
