LeadAce

Claude Code向け自律型リードジェネレーションプラグイン。 見込み顧客リストの作成、アウトリーチの実行、戦略の反復改善を、すべてハンズフリーで行います。

ウェブサイト: https://leadace.ai

2つの実行方法 ホスト型サービスを https://app.leadace.ai で利用するか（無料枠 — 1日5件のアウトリーチ、有料プランは月額$29〜）、またはセルフホストで独自のCloudflare + Supabase環境にバックエンドをホストします。プラグインはいずれの場合も同じです — ホスト型MCPか自前のMCPのどちらかにポイントするだけです。

ユーザー向け

前提条件

• Claude Code

• LeadAceアカウント at https://app.leadace.ai（無料枠 — カード不要）

• 接続済みの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を受け取ります。

プロジェクト、見込み客、アウトリーチログ、戦略ドキュメントはクラウド上にあり、ローカルで管理するファイルはありません。すべてはウェブアプリ at 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 オープンソースライセンス の下で公開されています。これは 2つの追加条件を持つ修正 Apache 2.0 というセレンスです:

• マルチテナント型パッケージ: サードパーティのためのマルチテナント向けクラウドサービスを、SurpassOne Inc. からの商用ライセンスなくして提供することは不可。自社組織向けのセルフホスティングは問題ありません。

• フロントエンドのロゴと著作権表示 は、LeadAce コンソールを公開するいかなるデプロイにおいても保持しなければなりません。

ホスト型サービス（クラウド）

• 無料枠： 1プロジェクト、500ページ見込み客、1日5 アクション（100生涯上限）

• 有料プラン は月額 $29 から。ウェブアプリからサブスクリプションを管理します。

セルフホスト

詳細は docs/self-host を参照。セルフホスト版はデータ上限なしのプランで動作します — 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

クイックスタート（ローカル開発）

一度だけのセットアップ — env ファイルのテンプレートをコピー:

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

Supabase キーを supabase status から入力 — ローカルスタックが起動すると、表示されるのでまず make dev を一度実行して（Supabase が起動する）、そのキーを貼り付けます。

ローカル Stack への Google サインインの有効設定には、Google OAuth クライアントを作成し、最初の make dev の前に、シェルで SUPABASE_AUTH_EXTERNAL_GOOGLE_CLIENT_ID / _SECRET を export します（.envrc 経由で）。 これは Supabase を起動して起動時にシェルから読み取るためです。詳細は docs/self-host.md → ローカル開発 を参照。 （GOOGLE_CLIENT_ID / _SECRET は backend/.dev にあります。

その後、ワーカー全体をワンボードで起動 — Supabase、マイグレーション、マスターシード、API/MCP Workers、フロントエンドをまとめて。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

依存関係の更新（ロックファイルの落とし穴）

node_modules が既に存在する状態での npm install は、他プラットフォームのオプション依存関係（@emnapi/*、@img/sharp-*、esbuildバイナリ）を package-lock.json から削除することがあります（npm/cli#7961、npm 10.3+–11.x）。CIはその後、そのトリムされたロックファイルに対し 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をそのまま消費します。