Mailgo Cold Mail Marketing

Gestión de campañas de correo frío impulsada por IA a través del Protocolo de Contexto de Modelo (MCP).

Documentación

mailgo-campaign-suite

Plugin completo de campañas de correo frío para Mailgo. Un solo plugin maneja todo el flujo de prospección:

Verificar correos de destinatarios (envío asíncrono + consulta)
Reclamar un buzón precalentado gratuito (puntuación de remitente 90+, 60 días)
Optimizar el contenido del correo (disparadores de spam, limpieza de HTML, entregabilidad)
Enviar campañas (carga de contenido, importación de contactos, activación)
Gestionar el ciclo de vida de la campaña (activar, pausar, eliminar, listar)
Reportar estadísticas de campaña (resumen, por ronda, progreso diario)

Instalación (Plugin de Claude)

# Add the marketplace
/plugin marketplace add leadsnaviDeveloper/mailgo-cold-mail-marketing

# Install the plugin
/plugin install mailgo-campaign-suite@mailgo-plugins

Después de la instalación, configura tu clave API de Mailgo como variable de entorno (consulta Seguridad y Credenciales a continuación), luego solo pide a Claude que te ayude a enviar correos fríos.

Instalación (Cursor)

/add-plugin leadsnaviDeveloper/mailgo-cold-mail-marketing

Consulta .cursor-plugin/plugin.json para más detalles.

Instalación (Codex)

git clone https://github.com/leadsnaviDeveloper/mailgo-cold-mail-marketing.git ~/.codex/mailgo-campaign-suite
mkdir -p ~/.agents/skills
ln -s ~/.codex/mailgo-campaign-suite/skills ~/.agents/skills/mailgo-campaign-suite

Consulta .codex/INSTALL.md para instrucciones completas.

Instalación (OpenCode)

Agrega a tu opencode.json:

{
  "plugin": ["mailgo-campaign-suite@git+https://github.com/leadsnaviDeveloper/mailgo-cold-mail-marketing.git"]
}

Consulta .opencode/INSTALL.md para instrucciones completas.

Instalación (Gemini CLI)

gemini extensions install https://github.com/leadsnaviDeveloper/mailgo-cold-mail-marketing

Editor

Este plugin es publicado por LeadsNavi, la empresa detrás de la plataforma de correo frío Mailgo.

Producto: https://app.mailgo.ai
Sitio web del editor: https://www.leadsnavi.com

Requisitos

Python 3.7+
Variable de entorno MAILGO_API_KEY (Clave OpenAPI de Mailgo)
Sin dependencias de terceros (solo biblioteca estándar: urllib, json, csv, ssl)
Opcional: openpyxl para soporte de archivos .xlsx (pip install openpyxl)

Seguridad y Credenciales

Esta habilidad requiere una Clave OpenAPI de Mailgo (MAILGO_API_KEY) para funcionar. Por favor, lee antes de usar:

Preocupación	Detalle
Qué puede hacer el token	Reclamar buzones, crear/activar/pausar/eliminar campañas, verificar correos, leer informes de campaña — todas las acciones en tu cuenta de Mailgo.
Cómo obtenerlo	Inicia sesión en https://app.mailgo.ai → Haz clic en tu avatar en la esquina inferior izquierda → Tokens Personales → Crear Token → Copia el token. Consulta SKILL.md Paso 0 para instrucciones paso a paso.
Cómo se usa	Se envía como encabezado `X-API-Key: {token}` a `api.leadsnavi.com` — el backend oficial de Mailgo (LeadsNavi es la marca matriz detrás de Mailgo; consulta app.mailgo.ai y el sitio web de Mailgo para más detalles).
Cómo mantenerse seguro	Configúralo solo como variable de entorno local — nunca lo pegues en el chat.
Cómo revocarlo	Ve a https://app.mailgo.ai → Tokens Personales → Elimina el token.
Endpoints de API llamados	Todas las llamadas van a `https://api.leadsnavi.com` (la API oficial de Mailgo) — verificación de correo, reclamo de buzones, CRUD de campañas y reportes. Revisa los scripts de Python incluidos para conocer los endpoints exactos.

MAILGO_API_KEY es tu credencial de cuenta de Mailgo. Mantenla segura y nunca la compartas públicamente.

Cumplimiento

Esta habilidad envía correos a listas de destinatarios que tú proporcionas. Eres responsable de asegurar que tus campañas cumplan con las leyes aplicables y los términos de la plataforma, incluyendo:

Ley CAN-SPAM (EE. UU.) — incluye una dirección física y respeta las solicitudes de exclusión voluntaria
GDPR (UE) — asegúrate de tener una base legal para contactar a los destinatarios
Términos de Servicio de Mailgo — https://app.mailgo.ai

El optimizador de correo integrado de la habilidad agrega una línea de exclusión voluntaria suave a cada correo por defecto.

Estructura de Directorios

mailgo-cold-mail-marketing/
├── .claude-plugin/                 # Claude Code plugin
│   ├── plugin.json
│   └── marketplace.json
├── .cursor-plugin/                 # Cursor IDE plugin
│   └── plugin.json
├── .codex/                         # GitHub Codex support
│   └── INSTALL.md
├── .opencode/                      # OpenCode support
│   └── INSTALL.md
├── skills/
│   └── mailgo-campaign-suite/
│       └── SKILL.md                # Main skill instructions
├── scripts/
│   ├── verify_emails.py            # Step 1: Email verification
│   ├── claim_free_mailbox.py       # Step 2: Free mailbox claiming
│   ├── run_campaign.py             # Step 4: Campaign creation & activation
│   ├── campaign_control.py         # Step 5: Lifecycle management
│   └── campaign_report.py          # Step 6: Statistics & reporting
├── resources/
│   ├── spam-triggers.md            # Step 3: Spam trigger replacement table
│   └── industry-templates.md       # Step 3: Industry-specific email templates
├── gemini-extension.json           # Gemini CLI extension
├── GEMINI.md                       # Gemini context pointer
├── package.json                    # Package metadata (OpenCode entry)
└── README.md                       # This file

Inicio Rápido

# 1. Set up authentication
export MAILGO_API_KEY="your-api-key"

# 2. Verify emails
python3 scripts/verify_emails.py alice@example.com bob@gmail.com

# 3. Claim free mailbox
python3 scripts/claim_free_mailbox.py

# 4. Create and send campaign
python3 scripts/run_campaign.py \
    --sender "claimed@mailbox.com" \
    --subject "Quick question" \
    --body "<html><body><p>Hi</p></body></html>" \
    --recipients "alice@example.com" \
    --campaign-name "My Campaign"

# 5. Check status
python3 scripts/campaign_control.py list
python3 scripts/campaign_report.py overview <campaignId>

Referencia de Scripts

Script	Propósito	Argumentos Clave
`verify_emails.py`	Enviar + consultar verificación de correo	`emails...`, `--file`, `--email-column`
`claim_free_mailbox.py`	Reclamar buzón precalentado	`--json`, `--api-key`
`run_campaign.py`	Flujo completo de creación de campaña	`--sender`, `--subject`, `--body/--body-file`, `--recipients/--recipients-file`
`campaign_control.py`	Activar/pausar/eliminar/listar	`activate/pause/delete/list/info`
`campaign_report.py`	Ver estadísticas de campaña	`overview/rounds/daily`, `--json`

Relación con Otras Habilidades de Mailgo

Este paquete consolida funcionalidad de:

mailgo-auth-setup — guía de autenticación (Paso 0)
mailgo-email-verifier — verificación de correo (Paso 1)
mailgo-email-optimizer — reglas de optimización de contenido (Paso 3)
mailgo-campaign — creación de campañas (Paso 4)
mailgo-campaign-control — gestión del ciclo de vida (Paso 5)
mailgo-campaign-report — estadísticas (Paso 6)

Esas habilidades individuales siguen disponibles para uso independiente. Este paquete proporciona las mismas capacidades en un solo paquete autocontenido.