eracle/OpenOutreach

OpenOutreach – セルフホスト型AIリード生成エージェント

概要 – 製品とターゲット市場を記述すると、言語モデルとライセンスされたリードデータサービスを使用して、見込み客を発見、評価、メール送信するオープンソースのコマンドラインツールです。すべての処理は自分のマシン上で実行され、外部呼び出しはLLM API（例：OpenAIやAnthropic）とBetterContactのメール検索サービスのみです。

対象ユーザー – SaaSのコールドメールプラットフォームに費用を支払ったり、既製のリストをアップロードしたりせずに、自動化されたアウトバウンド outreach を希望する中小規模のB2Bチーム、創業者、開発者。

主な機能

• ワンコマンドのオンボーディング – uv tool install openoutreach && openoutreach が4つの入力（LLMキー、BetterContactキー、製品説明、ターゲット市場）を案内し、~/.openoutreach に保存します。
• リードの発見と評価 – コンパニオンの OpenOutFind がライセンスされたデータソースを検索し、LLMが説明を検索キーワードに変換し、小さなアクティブラーニングループがどの候補が適合するかを決定し、各リードに人間が読める 理由 を添付します。
• メールのエンリッチメントと送信 – OpenOutSend が検証済みの仕事用メールを解決し（検索ごとに有料）、自分のメールボックスからパーソナライズされたオープナーを送信し、ペーシングと1日の上限を尊重します。
• 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検索が検証済みの仕事用メールを取得します（ヒットごとに1クレジット）。
6. OpenOutSend が同じ製品説明を使用してオープナーを作成し、SMTP認証情報を介して送信します。

インストールとクイックスタート

uv tool install openoutreach   # パッケージと2つの子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のIssue、またはREADMEのバッジから無料の15分間の通話を予約。

---

すべての詳細はリポジトリのREADMEから直接取得されており、追加の機能は推測されていません。