Skip to main content
Glama
leadsnaviDeveloper

Mailgo Cold Mail Marketing

mailgo-campaign-suite

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

  1. Verificar correos electrónicos de los destinatarios (envío asíncrono + sondeo)

  2. Reclamar un buzón gratuito precalentado (puntuación de remitente 90+, 60 días)

  3. Optimizar el contenido del correo (disparadores de spam, limpieza de HTML, entregabilidad)

  4. Enviar campañas (carga de contenido, importación de leads, activación)

  5. Gestionar el ciclo de vida de la campaña (activar, pausar, eliminar, listar)

  6. Informar sobre las estadísticas de la campaña (resumen, por rondas, 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 una variable de entorno (consulta Seguridad y credenciales a continuación), y luego simplemente pídele a Claude que te ayude a enviar correos en frío.

Related MCP server: smartlead-mcp-server-sse

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 obtener instrucciones completas.

Instalación (OpenCode)

Añade a tu opencode.json:

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

Consulta .opencode/INSTALL.md para obtener 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 en frío Mailgo.

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 esto antes de usarla:

Preocupación

Detalle

Qué puede hacer el token

Reclamar buzones, crear/activar/pausar/eliminar campañas, verificar correos, leer informes de campañas: 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 → Personal Tokens → Create Token → Copia el token. Consulta el Paso 0 de SKILL.md para obtener instrucciones paso a paso.

Cómo se utiliza

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 una variable de entorno local: nunca lo pegues en el chat.

Cómo revocarlo

Ve a https://app.mailgo.ai → Personal Tokens → Elimina el token.

Endpoints de API llamados

Todas las llamadas van a https://api.leadsnavi.com (API oficial de Mailgo): verificación de correo, reclamación de buzones, CRUD de campañas e informes. Revisa los scripts de Python incluidos para ver los endpoints exactos.

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

Cumplimiento

Esta habilidad envía correos electrónicos a las listas de destinatarios que proporciones. Eres responsable de garantizar 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 (opt-out)

  • RGPD (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 electrónico integrado de la habilidad añade una línea de exclusión voluntaria (opt-out) suave a cada correo electrónico de forma predeterminada.

Estructura del directorio

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 + sondeo de 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

Esta suite consolida la funcionalidad de:

  • mailgo-auth-setup: guía de autenticación (Paso 0)

  • mailgo-email-verifier: verificación de correo electrónico (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 estando disponibles para su uso independiente. Esta suite proporciona las mismas capacidades en un paquete único y autónomo.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    MCP server for Sendook - an AI email communication platform. Enables AI agents to send and receive emails, manage inboxes, threads, and webhooks programmatically.
    16
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that enables AI agents to manage Smartlead campaigns, including creating campaigns, updating schedules, managing email sequences, and adding leads, all over SSE.
    223 npm
    5
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    MCP server for Prosp.ai LinkedIn outreach automation. Manage leads, campaigns, messaging, and analytics programmatically.
    17
    MIT
  • A
    license
    Not graded
    quality
    F
    maintenance
    MCP server for managing cold email campaigns, leads, email accounts, sequences, analytics, webhooks, and client sub-accounts via the Smartlead API.
    6 npm
    7
    MIT