| name | geo-prospect |
| description | CRM ligero para gestionar prospectos y clientes de agencia GEO. Rastrea leads a través del flujo completo de ventas: Lead → Calificado → Propuesta Enviada → Ganado → Perdido. Almacena historial de auditorías, notas, valores de los tratos y genera resúmenes del embudo de ventas. Usar cuando el usuario diga "prospect", "lead", "client", "pipeline", "crm", "nuovo prospect", "aggiungi cliente", o cuando administre el lado comercial de los servicios GEO.
|
| version | 1.0.0 |
| tags | ["geo","business","crm","prospect","pipeline","sales"] |
| allowed-tools | Read, Write, Bash, Glob |
Gestor de Prospectos GEO
Propósito
Gestionar los prospectos y clientes de una agencia GEO a través del ciclo completo de ventas.
Todos los datos se almacenan en ~/.geo-prospects/prospects.json (persiste entre sesiones).
Comandos
| Comando | Qué Hace |
|---|
/geo prospect new <domain> | Crear nuevo prospecto (indicaciones interactivas) |
/geo prospect list | Mostrar todos los prospectos con estado en el pipeline |
/geo prospect list <status> | Filtrar: lead, qualified, proposal, won, lost |
/geo prospect show <id-or-domain> | Detalle completo del prospecto con historial |
/geo prospect audit <id-or-domain> | Ejecutar auditoría GEO rápida y guardar en registro del prospecto |
/geo prospect note <id-or-domain> "<text>" | Añadir nota de interacción con marca de tiempo |
/geo prospect status <id-or-domain> <new-status> | Mover a través del pipeline |
/geo prospect won <id-or-domain> <monthly-value> | Marcar como ganado, establecer valor de contrato |
/geo prospect lost <id-or-domain> "<reason>" | Marcar como perdido con motivo |
/geo prospect pipeline | Resumen visual del pipeline con previsión de ingresos |
Estructura de Datos
Cada prospecto se almacena como un registro JSON:
{
"id": "PRO-001",
"company": "Electron Srl",
"domain": "electron-srl.com",
"contact_email": "info@electron-srl.com",
"contact_name": "",
"industry": "Educational Equipment Manufacturing",
"country": "Italy",
"status": "qualified",
"geo_score": 32,
"audit_date": "2026-03-12",
"audit_file": "~/.geo-prospects/audits/electron-srl.com-2026-03-12.md",
"proposal_file": "~/.geo-prospects/proposals/electron-srl.com-proposal.md",
"monthly_value": 0,
"contract_start": null,
"contract_months": 0,
"notes": [
{
"date": "2026-03-12",
"text": "Escaneo rápido inicial GEO. Puntuación 32/100 - Nivel crítico. Fuerte candidato para servicios GEO."
}
],
"created_at": "2026-03-12",
"updated_at": "2026-03-12"
}
Instrucciones de Orquestación
/geo prospect new <domain>
- Verifica si
~/.geo-prospects/prospects.json existe, crea uno si no (array vacío)
- Autodetecta el nombre de la empresa a partir del dominio (ej.,
electron-srl.com → Electron Srl)
- Asigna siguiente ID secuencial:
PRO-001, PRO-002, etc.
- Pide al usuario:
- Nombre del contacto (opcional)
- Correo electrónico del contacto
- Estimación de valor mensual del contrato (opcional)
- Establece estado (status) en
lead
- Guarda en archivo JSON
- Sugiere siguiente paso: "Ejecuta
/geo prospect audit electron-srl.com para puntuar a este prospecto"
/geo prospect list
Lee ~/.geo-prospects/prospects.json y renderiza una tabla resumen:
Pipeline de Prospectos GEO — Marzo 2026
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ID Dominio Empresa Estado Puntaje Valor
─────── ────────────────────── ──────────────── ────────── ───── ──────
PRO-001 electron-srl.com Electron Srl Qualified 32/100 €4.5K
PRO-002 acme.com ACME Corp Lead — —
PRO-003 bigshop.it BigShop Won 41/100 €6.0K
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Pipeline: 1 lead | 1 calificado | 0 propuestas | 1 ganado | 0 perdidos
MRR (Ingresos Recurrentes) Comprometidos: €6,000 | Valor en Pipeline: €4,500
/geo prospect audit <id-or-domain>
- Ejecuta
/geo quick <domain> para obtener instantánea de la puntuación GEO
- Guarda la puntuación en el registro del prospecto:
geo_score, audit_date
- Guarda la salida de la auditoría en
~/.geo-prospects/audits/<domain>-<date>.md
- Actualiza la ruta
audit_file en el registro del prospecto
- Añade nota automática: "Auditoría rápida ejecutada. Puntuación GEO: XX/100."
- Si la puntuación es < 55: sugiere "La puntuación indica fuerte oportunidad de venta. Ejecuta
/geo proposal <domain> para generar propuesta."
/geo prospect note <id-or-domain> "<text>"
- Encuentra prospecto por ID o dominio
- Añade nota con la fecha ISO actual
- Guarda de vuelta en JSON
- Confirma: "Nota añadida a Electron Srl (PRO-001)"
/geo prospect status <id-or-domain> <status>
Estados válidos: lead, qualified, proposal, won, lost
- Actualiza el campo status
- Añade nota automática: "Estado cambiado a "
- Guarda y confirma
/geo prospect pipeline
Resumen visual del pipeline enfocado en ingresos:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
RESUMEN DEL PIPELINE AGENCIA GEO — Marzo 2026
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ETAPA CANT. VALOR POTENCIAL NOTAS
───────────── ───── ─────────────── ─────────────────────
Lead 2 €8,000/mes Nuevos descubrimientos
Calificado 1 €4,500/mes Listo para propuesta
Prop. Enviada 1 €6,000/mes A la espera de firma
Ganado 3 €18,500/mes Clientes activos (MRR)
Perdido 1 — Congelación presupuesto
MRR COMPROMETIDO: €18,500
PIPELINE (calificado+): €10,500
POTENCIAL TOTAL: €29,000/mes → €348,000/año
Próximas acciones:
→ PRO-003 (acme.com): Enviar propuesta — puntuación 38/100 (caso fuerte)
→ PRO-007 (shop.it): Seguimiento — propuesta enviada hace 8 días
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Ubicación de Almacenamiento
Todos los datos se guardan en ~/.geo-prospects/:
~/.geo-prospects/
├── prospects.json # Base de datos CRM principal
├── audits/ # Instantáneas de auditorías rápidas
│ └── electron-srl.com-2026-03-12.md
└── proposals/ # Propuestas generadas
└── electron-srl.com-proposal.md
Crea el directorio si no existe: mkdir -p ~/.geo-prospects/audits ~/.geo-prospects/proposals
Definiciones de Etapas del Pipeline
| Estado | Significado | Acción Siguiente Típica |
|---|
lead | Descubierto, aún no contactado | Ejecutar auditoría rápida, evaluar oportunidad |
qualified | Auditoría hecha, confirmación de puntos de dolor | Generar propuesta |
proposal | Propuesta enviada, a la espera de decisión | Hacer seguimiento, responder dudas |
won | Contrato firmado, cliente activo | Ejecutar auditoría completa, inicio onboarding |
lost | Trato cerrado perdido | Registrar motivo para futura referencia |
Salida
- Todos los comandos imprimen confirmación + estado actual del prospecto en la terminal
- No generar archivos externos a menos que se guarden explícitamente auditorías/propuestas
- La base de datos JSON es la única fuente de verdad
