ai-marketing-skills 外呼引擎:从 ICP 定义到冷邮件入箱的全自动流程
【免费下载链接】ai-marketing-skillsOpen-source AI marketing skills — growth experiments, sales pipeline, content ops, outbound, SEO, and finance automation项目地址: https://gitcode.com/gh_mirrors/ai/ai-marketing-skills
ai-marketing-skills是一个开源的 AI 营销技能库,覆盖增长实验、销售管道、内容运营等方向。其中Outbound Engine(外呼引擎)模块专为冷邮件外呼(cold outbound)打造:从 ICP 定义、专家团评分文案、线索搜寻与验证,到批量上传邮件平台,一条命令即可完成冷邮件全自动入箱流程。
🧩 外呼引擎能做什么:5 个脚本 + 1 套评分标准
外呼引擎不是一个脚本,而是一条完整的冷邮件流水线(pipeline):
| 阶段 | 负责的工具 | 干什么 |
|---|---|---|
| 策略设计 | SKILL.md | 引导 AI 智能体完成 ICP 定义、基础设施审计、文案评分 |
| 线索管道 | lead-pipeline.py | Apollo 搜寻 → LeadMagic 验真 → 去重 → Instantly 上传 |
| 账号体检 | instantly-audit.py | 拉取发送账号、预热分数、打开率/回复率健康数据 |
| 安全发送 | cold-outbound-sender.py | 按审批清单发送,每日限额、完整发送历史 |
| 竞争情报 | competitive-monitor.py | 监控竞品定价页与博客变化,生成周报 |
| 信号挖掘 | cross-signal-detector.py | 跨数据源发现重叠信号,输出带置信度的行动建议 |
整条链路的架构是这样的:ICP 定义 → 专家团递归评分(直到 90 分以上)→ 线索搜寻/验证/去重/上传 → 竞争监控与信号检测 → 每周情报报告。
🚀 快速开始:三步跑起外呼引擎
第 1 步:克隆仓库
git clone https://gitcode.com/gh_mirrors/ai/ai-marketing-skills cd ai-marketing-skills/outbound-engine第 2 步:安装依赖(需要 Python 3.9+)
pip install -r requirements.txt第 3 步:配置 API 密钥
cp .env.example .env # 填入 APOLLO_API_KEY、LEADMAGIC_API_KEY、INSTANTLY_API_KEY💡 提示:所有密钥都通过环境变量读取,也可以直接用
--apollo-key等命令行参数传入,密钥不会写进代码里。
🎯 第 1 步:ICP 定义——先想清楚"发给谁"
外呼引擎的起点不是写邮件,而是ICP(理想客户画像)定义。项目内置了一份结构化的收集模板 icp-template.md,它会引导你回答 6 类关键问题:
- 目标职位:高意向职位(如 VP Marketing)、次要职位、以及"永不触达"名单
- 目标行业:主攻垂直领域 + 明确排除的领域(anti-ICP)
- 公司规模:员工数区间、营收下限、融资阶段
- 地域范围:主攻市场与排除区域
- 购买信号:最近融资、新招增长负责人、上线新产品等触发事件
- 反 ICP 清单:谁绝对不该收到这封邮件
想清楚这些之后,ICP 参数可以直接传给线索管道脚本,一步到位:
python3 scripts/lead-pipeline.py \ --titles "VP Marketing,CMO,Head of Growth" \ --industries "SaaS,Marketing" \ --company-size "11,50" \ --locations "United States" \ --campaign-id "YOUR_CAMPAIGN_UUID" \ --volume 500 --dry-run--dry-run会完整走一遍搜寻、验证、去重,但不真正上传——强烈建议第一次运行时加上。
🏆 第 2 步:10 位专家给冷邮件文案"打擂台"
这是外呼引擎最有趣的设计:文案不是写完就算,而是由一个 10 人虚拟专家团递归打分,直到平均分达到 90/100 才放行。
默认成员名单在 expert-panel.md 中,每位专家代表一种真实打法:
- 有人只看回复率潜力(价值主张是否清晰、够不够短)
- 有人专抓框架与地位感(是不是在"乞求"对方回复)
- 有人负责反垃圾邮件(链接密度、垃圾词风险)
- 有人死磕第一句是否打断阅读惯性("I hope this finds you well" 直接出局)
评分维度包括主题行好奇心、首句模式中断、正文简洁度、CTA 柔和度、序列跟进逻辑等。评分规则极其严格:低于 90 分就找出 Top 3 弱点、改写、再打一轮,每一轮的迭代过程都会写进最终文档,留痕可查。
评分依据来自两份规则文件:
- copy-rules.md——冷邮件写作铁律:第一句永远不能以 "I"/"We" 开头、Step 1 最多 3 句话、CTA 用 "Worth a look?" 这类软请求、绝不虚构案例数据
- instantly-rules.md——Instantly 变量语法与送达率规则,保证成品可直接粘贴使用
📥 第 3 步:线索管道——从搜寻到入箱的自动化
lead-pipeline.py 把最耗人力的"找线索"环节压缩成一条命令,内部串联 4 个环节:
- Apollo People Search——按 ICP 职位/行业/规模/地域条件批量拉取候选人
- LeadMagic 验真——发送前逐条验证邮箱有效性,避免退信伤域名
- 去重——与 Instantly 已有线索和排除名单交叉比对,不重复打扰
- 批量上传 Instantly——带限速(429 自动等待重试)与失败重试逻辑
整个过程在终端实时打印进度,比如📡 Apollo page 1 …、⏳ Rate limited (429). Waiting 5s …,每一步都在你眼前。
📊 第 4 步:账号体检与安全发送
邮件发出去之前,先确认"枪"是好的:
账号体检——运行 instantly-audit.py 即可生成一份 Markdown 健康报告,包含发送账号库存、预热分数、各活动的打开率/回复率/正向回复率,并自动标记两类风险:预热分数低于 80 的账号、预热不足 14 天的账号。
容量公式——报告里还会给出保守/激进的产能测算:
就绪账号数 × 30~50 封/天 = 日发送量;日发送量 × 22 个工作日 = 月产能;再乘以回复率就是预期线索量。
安全发送——cold-outbound-sender.py 只读取"已审批"的名单文件,内置每日发送上限、完整发送历史追踪和 dry-run 测试模式,还附带内容安全校验(拦截密钥泄露等异常内容)。
每周指标基线(来自 SKILL.md):
| 指标 | 良好 | 优秀 |
|---|---|---|
| 打开率 | 40%+ | 60%+ |
| 回复率 | 3%+ | 7%+ |
| 正向回复率 | 1%+ | 3%+ |
| 会议率 | 0.5%+ | 1.5%+ |
🛰 附加武器:竞争监控与跨信号检测
外呼引擎还内置了"雷达"能力,让冷邮件策略始终基于最新情报:
- competitive-monitor.py:基于 diff 检测竞品定价页变化、监控竞品博客新内容,每周生成竞争情报报告,竞品列表可自由增删
- cross-signal-detector.py:把 SEO、销售、外呼等多份数据放在一起,找出公司重叠、行业对齐、关键词聚类相关,并输出带置信度评分的协同行动建议
📁 关键文件路径速查
| 文件 | 用途 |
|---|---|
| outbound-engine/SKILL.md | 核心工作流定义(供 Claude Code 等 AI 智能体执行) |
| outbound-engine/references/icp-template.md | ICP 数据收集模板 |
| outbound-engine/references/expert-panel.md | 10 位默认专家与评分视角 |
| outbound-engine/references/copy-rules.md | 冷邮件写作规则 |
| outbound-engine/references/instantly-rules.md | Instantly 变量语法与送达率规则 |
| outbound-engine/scripts/lead-pipeline.py | 端到端线索管道脚本 |
| outbound-engine/README.md | 模块总览与使用说明 |
✅ 最后提醒:人工审核关卡
外呼引擎有一条不可逾越的红线:任何内容都不会被自动推送到 Instantly。专家团评分的最终文档仅供人工审阅,必须得到你的明确批准后才允许执行 API 写入操作。自动化负责效率,人负责把关——这正是它敢"全自动"的原因。
从 ICP 定义到冷邮件入箱,外呼引擎把冷邮件外呼中最重的 80% 工作交给了脚本和 AI,而你只需要做两件事:定义好 ICP,以及批准最终文案。
【免费下载链接】ai-marketing-skillsOpen-source AI marketing skills — growth experiments, sales pipeline, content ops, outbound, SEO, and finance automation项目地址: https://gitcode.com/gh_mirrors/ai/ai-marketing-skills
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考