OpenSDR

---

功能

OpenSDR 是一款 MCP 服务，为你的 AI 助手提供销售开发代表（SDR）所需的工具集。你只需描述想要联系的人选，助手便会完成后续工作：

• 🔎 寻找符合条件的潜在客户，匹配你的理想客户画像（Apollo）。
• ✉️ 查找并验证工作邮箱，采用兼顾成本的逐级方案：Apollo → Hunter → 免费本地检查。
• 📈 发现购买信号（融资、招聘、领导层变动、产品发布），并为每条信号提供来源链接（Tavily 或 Exa）。
• ✍️ 撰写有依据的外联内容：每条个性化内容都引用真实且有来源的事实。
• 🚀 在 Instantly 和 HubSpot 中暂存营销活动及 CRM 记录，仅在你批准预览后执行。

优势

常见做法	使用 OpenSDR
使用四五款 SaaS 工具（联系人数据库、邮箱查找器、信号工具、序列工具），还要支付加价后的额度费用	使用自己的 API 密钥，不加价。 直接向服务提供商付费，只为实际使用的内容付费。
将潜在客户名单和策略上传到别人的云端	本地优先。 在你的机器上运行。没有 OpenSDR 服务，也没有遥测。
会自行发送邮件、损害你域名信誉的“AI SDR”	未经你批准，绝不发送任何内容。 营销活动会创建为草稿，由你决定何时启动。
泛泛而谈、凭空捏造的个性化内容	有依据的文案。 每条开场白都引用服务提供商字段或信号 URL。
重复查询浪费额度	节省额度。 提供单次调用预算、费用估算和 30 天的扩充缓存。
购买前难以试用	无需密钥的演示模式。 在添加任何密钥之前，所有工具都可使用虚构数据运行。

实际体验

演示模式下的一次真实会话（无需密钥，使用虚构的 .example 公司）：

你： 找出 B2B 软件和金融科技公司的工程副总裁，获取他们的邮箱，并查看是否有购买信号。

潜在客户	公司	邮箱（已验证）	信号
Amara Haddad，工程副总裁	Bluepeak	[email protected]	完成 2,500 万美元 B 轮融资（来源）
Sofia Doe，工程副总裁	Ledgerly	[email protected]	完成 2,500 万美元 B 轮融资
Lena Alvarez，工程副总裁	Wellspring Care	[email protected]	完成 2,500 万美元 B 轮融资

你： Meridian Pay 要求我们不要联系他们。把其他人推送到我的 Instantly 营销活动中。

Preview (nothing sent yet)
  eligible: 4   excluded: 1 (suppressed: Meridian Pay)
  confirmation_token: 1045338e…  single-use, expires in 15 min
→ Claude shows you the list and waits for your approval before confirming.

完整演示 →（查找 → 扩充 → 信号 → 起草 → 暂存）

快速开始

需要 Node.js 22.12+。

1. 将 OpenSDR 添加到你的助手中。 Claude Desktop → Settings → Developer → Edit Config：

{
  "mcpServers": {
    "opensdr": { "command": "npx", "args": ["-y", "opensdr-mcp"] }
  }
}

Claude Code：claude mcp add opensdr -- npx -y opensdr-mcp。一键安装到 Claude Desktop： 从最新版本下载 opensdr-mcp.mcpb 并双击。Cursor 和其他客户端：请参阅入门指南。

2. 无需密钥即可试用。 重启客户端并提问：“查找金融科技公司的工程副总裁，并起草外联内容。” 或选择内置的 autonomous_sdr_workflow 提示词。

3. 添加你已有的服务商。 所有密钥都是可选的；将它们添加到 env：

"env": {
  "APOLLO_API_KEY": "…",
  "HUNTER_API_KEY": "…",
  "TAVILY_API_KEY": "…"
}

还支持：EXA_API_KEY、INSTANTLY_API_KEY、HUBSPOT_ACCESS_TOKEN。各密钥的获取方式和所有设置请参阅：配置。

工作原理

You ──▶ AI assistant ──MCP──▶ OpenSDR (on your machine) ──your keys──▶ Apollo · Hunter · Tavily/Exa · Instantly · HubSpot
                                 │
                                 ├─ safety gates: preview + confirm · do-not-contact list · read-only switch · credit budget
                                 ├─ engine: email waterfall · signal rules · outreach briefs
                                 └─ local store: ~/.opensdr (lists, cache, suppression)

1. 查找： 将你的理想客户画像转化为精确的搜索筛选条件。搜索不会返回电子邮件地址，因此成本低廉。
2. 丰富： 每个人都会经过电子邮件瀑布流程，在第一个验证成功的结果处停止，并遵守你的额度预算。每个结果都会显示尝试过程及其费用。
3. 研究： 购买信号能说明为何要现在联系，每个信号都附有来源 URL。
4. 起草： 外联简报会为助手提供有来源支持的事实、序列框架和写作规则。助手负责撰写；由你审核批准。
5. 暂存： 创建营销活动、添加潜在客户和同步 CRM 时，都会先返回预览和一次性令牌，并且只有在你确认后才会执行。

OpenSDR 本身不包含 AI 模型：由你的助手负责思考和写作，OpenSDR 负责处理数据、验证和安全执行。了解更多架构、瀑布流程和信号 →

工具

类别	工具
系统	sdr_provider_status
潜在客户	sdr_lookup_filters · sdr_search_people · sdr_search_companies
丰富数据	sdr_waterfall_enrich_person · sdr_enrich_company · sdr_verify_email
管理	sdr_save_prospects · sdr_list_prospects · sdr_export_csv · sdr_manage_suppression
信号	sdr_detect_buying_signals · sdr_research_account
互动	sdr_prepare_outreach_brief · sdr_create_campaign · sdr_push_to_campaign · sdr_sync_hubspot

另有 3 个内置提示词（autonomous_sdr_workflow、icp_prospecting、cold_outreach_sequence）和 4 个资源（opensdr://providers、opensdr://lists、opensdr://lists/{name}、opensdr://profile）。完整参考 →

安全与隐私

• 每次外部写入操作都需要预览并确认；如果你批准后内容发生任何变化，确认操作会被拒绝。
• 营销活动只会保存为草稿，不会激活；潜在客户只会加入草稿或已暂停的营销活动。
• 每次推送、同步和导出都会遵守禁止联系名单，不可绕过。
• 提供只读模式（OPENSDR_READ_ONLY=1）和单次调用额度上限。
• 你的密钥和数据都保留在本机：没有 OpenSDR 服务，不收集遥测数据，也不会记录或存储密钥。
• 绝不会自动操作 LinkedIn：只会为你起草备注，由你自行发送。

你有责任遵守 CAN-SPAM、GDPR、CASL 以及服务商的条款。安全、隐私与合规 →

文档

入门指南	在 Claude Desktop、Claude Code 或 Cursor 中安装；演示模式；故障排除
演示教程	完整的真实操作流程
配置	API 密钥、设置、模式、销售人员资料、本地数据
工具参考	所有工具、提示词、资源和错误代码
工作原理	架构、电子邮件瀑布流程、信号、预览并确认
安全与隐私	所有防护措施、本地数据说明、合规
服务商 API 说明	各服务商 API 的使用方式

路线图

• 更多序列工具：Smartlead、Lemlist
• 更多 CRM：Salesforce、Pipedrive
• 为基于 Web 的客户端提供远程传输（Streamable HTTP）
• 理想客户匹配度评分和回复跟踪

需要我们支持某个服务商？提交服务商需求。

贡献

欢迎贡献，无论你是亲自编写代码，还是与 AI 编码 Agent 合作完成。

• 从这里开始：CONTRIBUTING.md 介绍了环境配置、检查和 PR 流程。
• **添加服务商：**数据源、序列工具和 CRM 均通过精简的能力接口接入；请遵循添加服务商指南。
• 使用 AI Agent？AGENTS.md 列出了架构规则和安全不变量。Codex、Cursor 和 Copilot 会自动读取；Claude Code 和 Gemini CLI 则通过 CLAUDE.md 和 GEMINI.md 加载。
• **安全问题：**请私下报告，详见 SECURITY.md。

许可证

MIT © Arif

_{OpenSDR 是一个独立的开源项目，与 Anthropic、Apollo.io、Hunter、Exa、Tavily、Instantly 或 HubSpot 均无关联，也未获得其认可。产品名称是其各自所有者的商标。}