LeadAce

Автономный плагин для генерации лидов для Claude Code. Составляет списки потенциальных клиентов, запускает исходящие касания и итеративно улучшает стратегию — полностью без ручного управления.

Веб-сайт: https://leadace.ai

Два способа запуска. Используйте облачный сервис на app.leadace.ai (бесплатный тариф — 5 исходящих сообщений в день, платные тарифы от $29/мес) или самостоятельно разверните бэкенд на собственном Cloudflare + Supabase. Плагин в обоих случаях одинаков — направьте его на облачный MCP или на свой.

Для пользователей

Предварительные требования

• Claude Code

• Аккаунт LeadAce на https://app.leadace.ai (бесплатный тариф — без карты)

• Подключённый аккаунт Gmail — для отправки писем (предоставляется при входе через Google или через баннер «Connect Gmail» в веб-приложении)

• Gmail MCP (встроенный в claude.ai) — для проверки ответов на письма

• claude-in-chrome MCP — для отправки форм и личных сообщений в SNS (для форм можно использовать любой другой MCP автоматизации браузера, который вы настроите, например Playwright; для личных сообщений SNS требуется 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 также использует тактическую часть обратной связи об отказах (запросы на повторный контакт, перенаправления к ЛПР, кластеры отраслей not_relevant), зафиксированную /check-responses — отдельный шаг пользователя не нужен.

Related MCP server: swarmix-mcp

Лицензия

LeadAce выпускается под LeadAce Open Source License — модифицированной Apache 2.0 с двумя дополнительными условиями:

• Никакого мультитенантного SaaS для третьих сторон без коммерческой лицензии от SurpassOne Inc. Самостоятельное развёртывание для собственной организации — допустимо.

• Логотип и копирайт фронтенда должны сохраняться в любом развёртывании, предоставляющем доступ к консоли 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

Быстрый старт (локальная разработка)

Разовая настройка — скопируйте шаблоны env-файлов:

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

Заполните ключи Supabase из вывода supabase status — он печатает их, когда локальный стек запущен, поэтому сначала один раз запустите make dev (он запускает Supabase), а затем вставьте ключи.

Для входа через Google в ваш локальный стек также создайте OAuth-клиент Google и экспортируйте SUPABASE_AUTH_EXTERNAL_GOOGLE_CLIENT_ID / _SECRET в вашей оболочке (через .envrc) до первого make dev — он запускает Supabase, которая читает их из окружения при старте. См. docs/self-host.md → Локальная разработка. (Эти переменные оболочки управляют входом; GOOGLE_CLIENT_ID / _SECRET в backend/.dev.vars — отдельные: они отвечают за отправку Gmail.)

Затем запустите весь стек одной командой — Supabase, миграции, мастер-сид, API/MCP Workers и фронтенд, всё сразу. Ctrl-C останавливает dev-серверы (Supabase остаётся запущенной для быстрого перезапуска; make stop полностью останавливает её):

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

Чтобы запуститься на других портах (например, если один из них уже занят другим dev-сервером), скопируйте 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)

npm install при уже существующей node_modules может удалить опциональные зависимости для других платформ (@emnapi/*, @img/sharp-*, бинарники esbuild) из package-lock.json (npm/cli#7961, npm 10.3+–11.x). Затем CI выполняет npm ci с этим урезанным lockfile и завершается ошибкой Missing: … from lock file. Эта проблема затрагивает и backend/, и frontend/ — именно из-за неё PR от Dependabot с npm становятся красными.

Когда вы меняете package.json / package-lock.json (или исправляете PR от Dependabot), перегенерируйте 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 как есть.