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；沒有推斷額外的功能。