eracle/OpenOutreach

OpenOutreach – 자체 호스팅 AI 리드 생성 에이전트

개요 – 제품과 타겟 시장을 설명하면 언어 모델과 라이선스된 리드 데이터 서비스를 사용하여 잠재 고객을 발견, 평가, 이메일 발송하는 오픈소스 명령줄 도구입니다. 모든 처리는 자체 머신에서 실행되며, 외부 호출은 LLM API(예: OpenAI 또는 Anthropic)와 BetterContact 이메일 찾기 서비스뿐입니다.

대상 – SaaS 콜드 이메일 플랫폼에 비용을 지불하거나 기성 목록을 업로드하지 않고 자동화된 아웃바운드 outreach를 원하는 중소규모 B2B 팀, 창업자, 개발자.

주요 기능

• 원커맨드 온보딩 – uv tool install openoutreach && openoutreach가 4가지 입력(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 조회가 검증된 업무 이메일을 가져옵니다(히트당 1크레딧).
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 가입 링크에서 제휴 커미션을 받아 무료로 유지됩니다. 다른 제공업체를 선호하는 경우 사용할 수 있습니다.

지원

• 텔레그램 채널: https://t.me/openoutreach
• GitHub 이슈 또는 README의 배지를 통해 무료 15분 통화 예약.

---

모든 세부 사항은 저장소의 README에서 직접 가져왔으며, 추가 기능은 추론되지 않았습니다.