Prospector

フォークできる GTM リードパイプラインです。パイプライン本体に加えて、AIアシスタントにその実行方法を教えるプレイブックを「augment」として同梱したものです。フォークして Claude Code で /onboard を実行し、ゲートにあなた自身のICPを設定し、キーを入れるだけで、あなたの顧客プロファイルに合った qualified リードを見つけ出します。

ゲートはスコアリングではなく失格判定を行います。サイトが死んでいる、info@ のみしか連絡先がない、営業を所有する人物が誰もいない、といった項目です。いずれかのゲートに引っかかった行はアウトになり、どのゲートで落とされたかがその行に記録されます。

来歴を率直に述べます。これは、2026年8月に実際のGTMトライアル課題のために48時間で構築したパイプラインから抽出したものです。その実行では、100件のリードを生成し、すべてのメールが実在するDNS MXレコードで裏付けられ、新規費用は$4.12でした。その実行こそが証明であり、このパイプラインがプロダクトです。このリポジトリにリードデータは一切含まれていません。リードリストは個人データに当たるため、各自で生成してください（data/README.md 参照）。

初回実行が強いた3つの設計判断

1. 基盤を築く前に、情報源を計測する。 最初のCrunchbaseスクレイプ（300社）では、74%が収益上限を超えて資金調達しており、ICPに適合したのは7%だけでした。そのため初日からClutchを主要な情報源にしました。エージェンシーはベンチャーキャピタルを調達することは極まれまれで、Clutchの一覧はサービス単位で掲載されているからです。

2. 失敗をはっきりと報告する。さもなければ静かに見逃すことになる。 初期の実行では、全行が null にもかかわらず、ファイルが書き出されて成功と報告されました。現在のClutchスクレイパーのnull率チェックは、ファイル書き出しの前に必ず実行されます。

3. 確認した以上のことを表明しない。 メールは構文、実在のDNS MX、ロールアカウントの各チェックを通過します。SMTP やハンドシェイクは実行しないため、email_status が valid を「と言うことはありません。CAPTCHAに遭遇したら、回避ではなく、その Crunchbase の実行を停止します。

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 は、このパイプラインを4つのツールを持つ MCP サーバーとして公開します。src/agent/qualify.ts がそれを駆動し、各リードを ICP に対して評価して、人間の承認ゲートで停止します。人間が承認を明言しない限り、どのリードも qualified とは見なされません。

実行

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 が実際のスクレイピングを始める前に、3つの FICTIONAL（架空）の行を処理できます。

シグナルのステップには APIFY_TOKEN が必要です（.env.example を .env にコピー）。Clay のステップは Clay の MCP サーバーを通じて実行されます。その設定はあなたのエージェントホスト側で行うもので、ここではスクリプト化していません。

自分のICPに合わせてフォークする

Claude Code で /onboard を実行すると、あなたの ICP を src/icp.ts に登録し、キーを設定し、実行の構成が一通り完了します。かかる時間は約15分です。手動での手順は この .claude/skills/onboard/SKILL.md にあります。

一回の実行は Apify クレジットで 約4ドルです。データの取得とフィルタリングは$0です。

やらないこと

メールの送信、データの購入、CAPTCHA の解決・回避、人間の承認なしでリードを qualified とマーク、または誰かの個人データをリポジトリに入れること、これらのいずれも行いません。

ライセンス: MIT. LICENSE.md.