eracle/OpenOutreach

OpenOutreach – 自托管 AI 潜在客户生成代理

它是什么 – 一个开源命令行工具，让您描述产品和目标市场，然后使用语言模型和许可的潜在客户数据服务来发现、筛选和发送邮件给潜在客户。所有处理都在您自己的机器上运行；唯一的外部调用是 LLM API（例如 OpenAI 或 Anthropic）和 BetterContact 电子邮件查找服务。

适用对象 – 中小型 B2B 团队、创始人或开发者，希望自动化外展，而无需支付 SaaS 冷邮件平台或上传预制列表。

主要功能

• 一键入门 – uv tool install openoutreach && openoutreach 引导您完成四个输入（LLM 密钥、BetterContact 密钥、产品描述、目标市场），并将它们存储在 ~/.openoutreach 中。
• 潜在客户发现与筛选 – 配套的 OpenOutFind 搜索许可的数据源，LLM 将您的描述转换为搜索关键词，一个小型主动学习循环决定哪些候选者合适，并为每个潜在客户附上人类可读的 原因。
• 电子邮件丰富与发送 – OpenOutSend 解析已验证的工作电子邮件（每次查找付费），并从您自己的邮箱发送个性化开场白，遵守节奏和每日上限。
• 仅 CLI，无需浏览器或社交媒体账户 – 无抓取，无平台 ToS 风险。
• 可导出的 CSV – openoutreach find 10 emails > leads.csv 生成一个文件，其列与常见序列器导入匹配（email,first_name,last_name,company,title,website,linkedin_url,reason,…）。
• Claude Code 集成 – 现成的 Claude 插件/技能允许任何 LLM 驱动的代理调用相同的命令。

工作原理（高层）

1. 您提供简短的产品+市场描述。
2. LLM 生成搜索关键词。
3. OpenOutFind 查询 BetterContact 的许可索引（免费）以查找匹配的公司。
4. LLM 根据您的理想客户画像评估每个候选者，撰写平实的 原因，高斯过程模型从这些判断中学习，以优先处理下一批。
5. 当置信度门槛通过时，付费的 BetterContact 查找获取已验证的工作电子邮件（每次命中一个积分）。
6. OpenOutSend 使用相同的产品描述撰写开场白，并通过您的 SMTP 凭据发送。

安装与快速开始

uv tool install openoutreach   # 安装包及其两个子 CLI
openoutreach                  # 运行向导，然后查找并发送邮件给潜在客户
# 或更明确
openoutreach run 5            # 查找最多 5 个带电子邮件的合格潜在客户并发送

所有状态都存储在 ~/.openoutreach 下；重新运行命令会从上次中断的地方继续。

核心命令

• openoutreach – 完整向导 + 查找 + 发送（默认）。
• openoutreach init – 仅运行入门向导。
• openoutreach find <n> [emails] – 获取 n 个合格潜在客户；添加 emails 以花费积分获取已验证地址。
• openoutreach send [<n>] – 为存储的潜在客户发送电子邮件，可选限制为 n 个。
• openoutreach status – 显示配置、积分使用情况和排队中的潜在客户。

依赖项

• Python（通过 uv 或 pip 安装）。
• LLM API 密钥（OpenAI、Anthropic 或兼容）。
• BetterContact API 密钥（免费层提供 40 个电子邮件查找积分）。
• 发送邮箱的 SMTP 凭据。

项目结构

• openoutreach/ – 编排器代码（__main__.py、设置、向导）。
• 子项目（OpenOutFind、OpenOutSend）作为固定依赖项引入，可单独使用。
• 测试、Docker compose（local.yml）和用于开发的 Makefile。

许可证与可持续性

• 根据 GPL-v3 许可。
• 该工具通过从 BetterContact 注册链接赚取联盟佣金来保持免费；如果您愿意，可以使用任何其他提供商。

获取帮助

• Telegram 频道：https://t.me/openoutreach
• GitHub 上的问题，或通过 README 中的徽章预订免费的 15 分钟通话。

---

所有细节均直接取自存储库的 README；没有推断额外的功能。