LeadAce

Plugin autónomo de generación de leads para Claude Code. Crea listas de prospectos, ejecuta acciones de divulgación saliente e itera sobre la estrategia, todo sin intervención manual.

Sitio web: https://leadace.ai

Dos formas de ejecutarlo. Usa el servicio alojado en app.leadace.ai (plan gratuito: 5 divulgaciones/día, planes de pago desde 29 $/mes), o auto-aloja el backend en tu propio Cloudflare + Supabase. El plugin es el mismo en ambos casos: apúntalo al MCP alojado o al tuyo propio.

Para usuarios

Requisitos previos

• Claude Code

• Una cuenta de LeadAce en https://app.leadace.ai (plan gratuito, sin tarjeta)

• Una cuenta de Gmail conectada, para el envío de correos (se concede al iniciar sesión con Google, o mediante el banner «Conectar Gmail» en la aplicación web)

• Gmail MCP (integrado en claude.ai), para comprobar las respuestas de correo

• claude-in-chrome MCP, para el envío de formularios y mensajes directos en redes sociales (los formularios también pueden usar cualquier otro MCP de automatización de navegador que configures tú, p. ej. Playwright; los mensajes directos en redes sociales requieren claude-in-chrome)

Instalación

Una línea en tu terminal:

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

O, desde una sesión de Claude Code en ejecución:

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

Para actualizar más adelante:

/plugin marketplace update
/plugin update leadace@leadace

Iniciar sesión en LeadAce

La primera vez que el plugin llama a una herramienta de LeadAce, tu navegador se abre para el inicio de sesión con Google (la misma cuenta de Google que en la aplicación web). El token se guarda en caché localmente para ejecuciones posteriores. Consulta plugin/README.md para más detalles y solución de problemas.

Uso

La mayoría de los comandos toman el nombre de tu proyecto como primer argumento (elegido durante la incorporación con /leadace); /leadace en sí mismo acepta una pregunta libre o la URL de una página de inicio.

Los proyectos, prospectos, registros de divulgación y documentos de estrategia viven en la nube: no hay archivos locales que gestionar. Revisa todo en la aplicación web en https://app.leadace.ai.

Flujo

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"]

Las flechas sólidas = el bucle principal. Las discontinuas = opcional / ocasional / envoltorio. /evaluate también consume la parte táctica de los comentarios de rechazo (solicitudes de reconcontacto, referencias de decisores, clústeres de sectores not_relevant) registrados por /check-responses — sin paso de usuario adicional.

Related MCP server: swarmix-mcp

Licencia

LeadAce se publica bajo la Licencia de código abierto de LeadAce, una versión modificada de Apache 2.0 con dos condiciones adicionales:

• No se permite SaaS multiinquilino para terceros sin una licencia comercial de SurpassOne Inc. El auto-alojamiento para tu propia organización está bien.

• El logotipo y el aviso de copyright del frontend deben conservarse en cualquier despliegue que exponga la consola de LeadAce.

Servicio alojado (nube)

• Plan gratuito: 1 proyecto, 500 prospectos, 5 acciones de divulgación al día (límite de por vida de 100)

• Planes de pago desde 29 $/mes. Gestiona tu suscripción desde la aplicación web.

Auto-alojamiento

Consulta docs/self-host.md. La edición auto-alojada funciona con el plan ilimitado: sin Stripe, sin límites. Para consultas sobre licencias comerciales, contacta con leo.uno@surpassone.com.

Para desarrolladores

Estructura del repositorio

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

• Convenciones del plugin y flujo de trabajo de cambios de esquema: CLAUDE.md

• Auto-alojamiento y desarrollo local: docs/self-host.md

Inicio rápido (desarrollo local)

Configuración única: copia las plantillas de variables de entorno:

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

Rellena las claves de Supabase desde supabase status — las imprime una vez que la pila local está en marcha, así que ejecuta make dev una vez primero (inicia Supabase) y luego pega las claves.

Para el inicio de sesión con Google en tu pila local, crea también un cliente OAuth de Google y exporta SUPABASE_AUTH_EXTERNAL_GOOGLE_CLIENT_ID / _SECRET en tu shell (a través de .envrc) antes del primer make dev — arranca Supabase, que las lee del shell al inicio. Consulta docs/self-host.md → Desarrollo local. (Estas variables de shell controlan el inicio de sesión; las GOOGLE_CLIENT_ID / _SECRET en backend/.dev.vars son independientes — alimentan el envío de Gmail.)

Luego inicia toda la pila con un solo comando: Supabase, migraciones, la semilla maestra, los Workers de API/MCP y el frontend, todo junto. Ctrl-C detiene los servidores de desarrollo (Supabase permanece activo para un reinicio rápido; make stop lo detiene):

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

Para ejecutar en puertos diferentes (p. ej. si uno está ocupado por otro servidor de desarrollo), copia dev.ports.env.example a dev.ports.env y establece los puertos allí — dev.sh reconfigura todas las URL dependientes (y el inicio de sesión con Google sigue funcionando). Los valores predeterminados no cambian si el archivo no existe.

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

Comprobaciones previas al lanzamiento:

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

Actualización de dependencias (problema del archivo de bloqueo)

npm install con node_modules ya presente puede eliminar dependencias opcionales de otras plataformas (@emnapi/*, @img/sharp-*, binarios de esbuild) de package-lock.json (npm/cli#7961, npm 10.3+–11.x). CI luego ejecuta npm ci contra ese archivo de bloqueo recortado y falla con Missing: … from lock file. Esto afecta tanto a backend/ como a frontend/, y es lo que hace que los PR de npm de Dependabot se pongan en rojo.

Cuando cambies un package.json / package-lock.json (o repares un PR de Dependabot), regenera el archivo de bloqueo bajo la cadena de herramientas fijada del repositorio — no en 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

Luego confirma el package-lock.json regenerado. Los cambios solo de código no necesitan esto — CI consume el archivo de bloqueo confirmado tal cual.