LeadAce

Claude Code용 자동 리드 생성 플러인입니다. 잠재 고객 목록을 구축하고, 아웃리치를 실행하며, 전략을 반복 개선합니다 — 모두 핸즈프리로 처리합니다.

웹사이트: https://leadace.ai

두 가지 실행 방법이 있습니다. app.leadace.ai의 호스팅 서비스(무료 티어 — 하루 5건 아웃리치, 유료 플랜 월 $29부터)를 이용하거나, 자체 호스팅으로 백엔드를 본인 Cloudflare + Supabase에 배포할 수 있습니다. 플러그인은 어느 쪽이든 동일합니다 — 호스팅 MCP 또는 본인 MCP를 가리키기만 하면 됩니다.

사용자용

사전 요구 사항

• Claude Code

• https://app.leadace.ai의 LeadAce 계정 (무료 티어 — 카드 불필요)

• 연결된 Gmail 계정 — 이메일 전송용 (Google로 로그인하거나 웹 앱의 "Gmail 연결" 배너를 통해 부여)

• Gmail MCP(claude.ai 내장) — 이메일 답장 확인용

• claude-in-chrome MCP — 양식 제출 및 SNS DM용 (양식은 직접 구성한 다른 브라우저 자동화 MCP(예: Playwright)를 사용할 수도 있음, SNS DM에는 claude-in-chrome 필요)

설치

터미널에서 한 줄:

claude plugin marketplace add aitit-inc/leadace && claude plugin install leadace@leadace

또는 실행 중인 Claude Code 세션 내부에서:

/plugin marketplace add aitit-inc/leadace
/plugin install leadace@leadace

나중에 업데이트하려면:

/plugin marketplace update
/plugin update leadace@leadace

LeadAce에 로그인

플러그인이 LeadAce 도구를 처음 호출하면 브라우저가 열리며 Google 로그인(웹 앱과 동일한 Google 계정)을 진행합니다. 토큰은 이후 실행을 위해 로컬에 캐시됩니다. 자세한 내용 및 문제 해결은 plugin/README.md를 참조하세요.

사용법

대부분의 명령은 첫 번째 인자로 프로젝트 이름을 사용합니다(/leadace 온보딩 중 선택). /leadace 자체는 자유 형식 질문이나 홈페이지 URL을 받습니다.

프로젝트, 잠재 고객, 아웃리치 로그 및 전략 문서는 클라우드에 저장됩니다 — 관리할 로컬 파일이 없습니다. https://app.leadace.ai의 웹 앱에서 모든 것을 검토하세요.

흐름

flowchart TD
  LA["/leadace<br/>onboard · setup · strategy"] --> P{add prospects}

  P -- web search --> BL["/build-list"]
  P -- CSV / Excel --> IP["/import-prospects"]
  P -- reuse tenant --> MP["/match-prospects"]

  BL --> OB["/outbound"]
  IP --> OB
  MP --> OB

  OB --> CR["/check-responses"]
  CR --> EV["/evaluate"]
  EV -- next round --> P

  CR -. PMF signals .-> CF["/check-feedback"]
  CF -. revisit strategy .-> LA

  DC["/daily-cycle<br/>check + outbound + build, one shot"]
  SC["/setup-cron<br/>OS schedule"] --> DC
  DC -. replaces manual loop .-> P

  DEL["/delete-project"]

실선 화살표 = 기본 루프. 점선 = 선택 사항 / 가끔 / 래퍼. /evaluate는 /check-responses가 기록한 거절 피드백의 전술적 부분(재접촉 요청, 의사 결정권자 추천, not_relevant 업종 클러스터)도 소비합니다 — 별도의 사용자 단계가 필요 없습니다.

Related MCP server: swarmix-mcp

라이선스

LeadAce는 LeadAce 오픈 소스 라이선스에 따라 배포됩니다 — 두 가지 추가 조건이 있는 수정된 Apache 2.0입니다:

• SurpassOne Inc.의 상업용 라이선스 없이 제3자를 위한 멀티 테넌트 SaaS 금지. 자체 조직을 위한 자체 호스팅은 괜찮습니다.

• LeadAce 콘솔을 노출하는 모든 배포에서 프런트엔드 로고 및 저작권을 유지해야 합니다.

호스팅 서비스(클라우드)

• 무료 티어: 프로젝트 1개, 잠재 고객 500명, 일일 아웃리치 5건(평생 100건 한도)

• 유료 플랜은 월 $29부터 시작합니다. 웹 앱에서 구독을 관리하세요.

자체 호스팅

docs/self-host.md를 참조하세요. 자체 호스팅 버전은 무제한 티어로 실행됩니다 — Stripe도, 한도도 없습니다. 상업용 라이선스 문의는 leo.uno@surpassone.com으로 연락하세요.

개발자용

저장소 구조

plugin/                          # Claude Code plugin
├── .claude-plugin/plugin.json   # Manifest
├── .mcp.json                    # MCP server config (uses LEADACE_MCP_URL)
├── skills/                      # Slash commands (each directory has SKILL.md)
├── scripts/fetch_url.py         # Local web fetch helper
└── references/                  # Shared reference docs
backend/                         # API + MCP servers (Cloudflare Workers, Hono, Drizzle)
frontend/                        # Web app (SvelteKit, Cloudflare Pages)
docs/                            # Project-wide docs (deploy runbook, self-host, architecture)
docker-compose.yml               # Bare Postgres for non-Supabase local dev

• 플러그인 규칙 및 스키마 변경 워크플로: CLAUDE.md

• 자체 호스팅 및 로컬 개발: docs/self-host.md

빠른 시작(로컬 개발)

일회성 설정 — 환경 변수 템플릿 복사:

cp backend/.dev.vars.example backend/.dev.vars
cp frontend/.env.example frontend/.env

supabase status의 Supabase 키를 입력하세요 — 로컬 스택이 실행되면 출력됩니다. make dev를 먼저 실행한 후(Supabase 시작) 키를 붙여넣으세요.

로컬 스택에 Google 로그인을 사용하려면 Google OAuth 클라이언트를 만들고 첫 make dev 이전에 셸에서(.envrc 통해) SUPABASE_AUTH_EXTERNAL_GOOGLE_CLIENT_ID / _SECRET을 내보내세요 — 시작 시 셸에서 이를 읽는 Supabase를 부팅합니다. docs/self-host.md → 로컬 개발을 참조하세요. (이 셸 변수는 로그인을 제어하며, backend/.dev.vars의 GOOGLE_CLIENT_ID / _SECRET은 별개로 Gmail 전송을 담당합니다.)

그런 다음 한 명령으로 전체 스택을 시작하세요 — Supabase, 마이그레이션, 마스터 시드, API/MCP 워커, 프런트엔드가 모두 함께 시작됩니다. Ctrl-C로 개발 서버를 종료할 수 있습니다(빠른 재시작을 위해 Supabase는 유지됨, make stop으로 중지):

make dev          # or: ./scripts/dev.sh

다른 포트에서 실행하려면(예: 다른 개발 서버가 사용 중인 경우) dev.ports.env.example을 dev.ports.env로 복사하고 포트를 설정하세요 — dev.sh가 모든 종속 URL을 다시 연결합니다(Google 로그인도 계속 작동). 파일이 없으면 기본값이 사용됩니다.

npx supabase start                      # Auth + Postgres on ports 54321/54322
cd backend
npm install
npm run db:migrate
npx tsx scripts/seed-master-documents.ts

npm run dev:api                         # API → http://localhost:8787
npm run dev:mcp                         # MCP → http://localhost:8788  (separate terminal)

cd ../frontend
npm install
npm run dev                             # → http://localhost:5273

사전 릴리스 확인:

cd backend && npm run typecheck
cd frontend && npm run check

종속성 업데이트(lockfile 주의사항)

node_modules가 이미 있는 상태에서 npm install을 실행하면 package-lock.json에서 다른 플랫폼의 선택적 종속성(@emnapi/*, @img/sharp-*, esbuild 바이너리)이 제거될 수 있습니다(npm/cli#7961, npm 10.3+–11.x). 그러면 CI가 축소된 lockfile로 npm ci를 실행하고 Missing: … from lock file 오류로 실패합니다. 이는 backend/와 frontend/ 모두에 영향을 미치며 Dependabot의 npm PR이 빨간불이 되는 원인입니다.

package.json / package-lock.json을 변경할 때(또는 Dependabot PR을 수리할 때) 리포지토리의 고정된 도구 체인에서 lockfile을 재생성하세요 — Docker가 아닌:

nvm use                 # node 22 (repo .nvmrc) — matches CI
cd backend              # or cd frontend
rm -rf node_modules     # removing this first is what avoids the prune
npm install --no-audit --no-fund

그런 다음 재생성된 package-lock.json을 커밋하세요. 코드 전용 변경에는 이 작업이 필요 없습니다 — CI는 커밋된 lockfile을 그대로 사용합니다.