Prospector

포크해서 사용할 수 있는 GTM 리드 파이프라인입니다. 이 저장소에는 파이프라인과, AI 어시스턴트가 그 파이프라인을 실행하는 방법을 가르쳐 주는 플레이북이 함께 담겨 있습니다. 포크한 뒤 Claude Code에서 /onboard를 실행하고, 게이트에 자신의 ICP를 설정하고, 키를 넣으면 당신의 고객 프로필에 맞는 자격을 갖춘 리드를 찾아냅니다.

게이트는 점수를 매기는 대신 자격을 박탈합니다: 죽은 사이트, info@만 있는 경우, 판매를 소유할 사람이 없는 경우를 걸러낸니다. 그 기준 중 하나라도 걸리는 행은 제외되고, 그 행에는 어떤 게이트가 해당 스탭을 탈락시켰는지 표시됩니다.

출처를 분명히 밝히면: 2026년 8월 실제 GTM 시험 과제를 위해 48시간에 걸쳐 만든 파이프라인에서 가져온 것입니다. 그 결과는 모든 이메일이 실제 DNS MX 레코드로 검증된 리드 100개를 만들어 냈고, $ 4.12의 기존 지출이 발생했습니다. 그 실행 자체가 증명이었고, 이 파이프라인이 제품입니다. 여기에는 리드 데이터가 포함되지 않습니다. 리드 목록은 개인정보이므로 직접 생성해야 합니다(data/README.md 참권).

첫 실행이 강제한 설계 결정

1. 만들기 전에 소스를 검증다. 첫 크런치베이스 스커페이에서 300개 기업 중 74%가 매출 상한선을 넘는 자금 조달을 받았고, 7%만이 ICP에 부합했기 때문에 첫날부터 클러치를 기본 소스로 채택했습니다. 대행사는 벤처 투자를 거의 유치하지 않으며, Clutch는 서비스별로 분류해 줍니다.

2. 크게 실패하거나 아니면 조용히 다른. 초기 실행에서 파일이 기록되고 성공으로 보고했지만, 모든 행이 null이었습니다. 이제 Clutch 스크레이퍼의 null 수검사는 모든 파일 쓰기 이전에 실행됩니다.

3. 확인 안 한 사실을 주장하지 말아 메이는 문법, 라이브 DNS MX, 담당자/카운트 검사를 통과합니다. SMTP 화이트셰이크는 하지 않으므로, email_status가 valid`라고 표시되지 않습니다. CAPTCHA가 나타나면 우회로 외 않지 않는 일의 종료됩니다.

Related MCP server: SignalPipe

파이프라인

src/icp.ts                   The ICP as zod schemas: the company gate and the shape of a shipped lead.
src/scrapers/crunchbase.ts   Playwright. Logged-in saved search, real pagination, 2s between requests, stops on CAPTCHA.
src/scrapers/clutch.ts       Playwright. Category listings, null-rate check before it writes anything.
src/pipeline/normalize.ts    Merge both sources, normalize domains, ICP geo and headcount filter, dedupe by domain.
Apify actors                 LinkedIn jobs and posts for the intent signal.
Clay                         Decision maker, sales owner, work email, through Clay's MCP server.
src/pipeline/finalize.ts     Join Clay output, MX check, drop non-sales titles, rank by tier, validate every row.

src/mcp/server.ts는 파이프라인을 MCP 서버로 노출하며, 네 가지 도구를 제공합니다. src/agent/qualify.ts는 이 파이프라인을 실행하고, 각 리드를 사용자별 ICP. 점수화하며, 사람의 승인 게이트에서 멈출니다. 사람이 동의하지 않는 한 여기에서 리드가 'valid'로 표시되지 않습니다.

실행

pnpm install
npx playwright install chromium
pnpm test                                # 42 tests green before you trust anything
pnpm scrape:clutch
pnpm scrape:crunchbase                   # optional; needs .crunchbase.storageState.json from a logged-in session
pnpm normalize                           # writes data/companies.csv
pnpm finalize path/to/clay-export.csv    # writes data/leads_final.csv
pnpm mcp                                 # the pipeline as an MCP server
pnpm agent                               # reads data/companies.csv

새 클론에서 가상 실행 시도: cp data/sample-companies.csv data/companies.csv로 pnpm agent가 실제 데이터를 스크레이핑하기 전에 세 개의 가상 행을 검토할 수 있습니다.

시그널 단계에는 APIFY_TOKEN이 필요합니다(.env.example을 .env에 복사). Clay 단계는 Clay의 MCP 서버를 통해 실행되며, 여기에 서버에 연결하는 것이 아니라 호스트의 에이전트 구성에 설정합니다.

자신의 ICP에 맞춰 포크하기

Claude Code에서 /onboard 실행하면 전체 설정을 안내합니다: src/icp.ts에 자신의 ICP를 작성하고, 키를 넣고, 실행 순서을 정합니다. 약 15분이 걸립니다. 수동 실행 버전은 .claude/skills/onboard/SKILL.md에 있습니다.

실행 한 회당 약 $4의 Apify 크레딧가 사용됩니다. 스크레이핑과 필터링 비용은 $0입니다.

이 저장소가 하지 않는 것

이메일 송부, 데이터 수집, CAPTCHA 해결/우회, 사람 승인 이전의 리드자격 판정, 그리고 누군가의 개인 데이터를 저장: 어떤 것도 수행하지 않습니다.

라이선스: MIT. LICENSE.md.