Mailgo Cold Mail Marketing

Gerenciamento de campanhas de e-mail frio com inteligência artificial através do Model Context Protocol (MCP).

Documentação

mailgo-campaign-suite

Plugin completo de campanhas de e-mail frio para Mailgo. Um único plugin gerencia todo o pipeline de outreach:

Verifique e-mails dos destinatários (envio assíncrono + consulta)
Reivindique uma caixa de entrada pré-aquecida gratuita (pontuação de remetente 90+, 60 dias)
Otimize o conteúdo do e-mail (gatilhos de spam, limpeza de HTML, entregabilidade)
Envie campanhas (upload de conteúdo, importação de leads, ativação)
Gerencie o ciclo de vida da campanha (ativar, pausar, excluir, listar)
Relate estatísticas da campanha (visão geral, por rodada, progresso diário)

Instalação (Plugin Claude)

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

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

Após a instalação, defina sua chave de API Mailgo como uma variável de ambiente (veja Segurança e Credenciais abaixo) e então basta pedir ao Claude para ajudar você a enviar e-mails frios.

Instalação (Cursor)

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

Veja .cursor-plugin/plugin.json para detalhes.

Instalação (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

Veja .codex/INSTALL.md para instruções completas.

Instalação (OpenCode)

Adicione ao seu opencode.json:

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

Veja .opencode/INSTALL.md para instruções completas.

Instalação (Gemini CLI)

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

Editor

Este plugin é publicado pela LeadsNavi, a empresa por trás da plataforma de e-mail frio Mailgo.

Produto: https://app.mailgo.ai
Site do editor: https://www.leadsnavi.com

Requisitos

Python 3.7+
Variável de ambiente MAILGO_API_KEY (Chave OpenAPI do Mailgo)
Sem dependências de terceiros (apenas stdlib: urllib, json, csv, ssl)
Opcional: openpyxl para suporte a arquivos .xlsx (pip install openpyxl)

Segurança e Credenciais

Esta skill requer uma Chave OpenAPI Mailgo (MAILGO_API_KEY) para operar. Leia antes de usar:

Preocupação	Detalhe
O que o token pode fazer	Reivindicar caixas de entrada, criar/ativar/pausar/excluir campanhas, verificar e-mails, ler relatórios de campanha — todas as ações na sua conta Mailgo.
Como obtê-lo	Faça login em https://app.mailgo.ai → Clique no seu avatar no canto inferior esquerdo → Tokens Pessoais → Criar Token → Copie o token. Veja SKILL.md Passo 0 para instruções passo a passo.
Como é usado	Enviado como cabeçalho `X-API-Key: {token}` para `api.leadsnavi.com` — o backend oficial do Mailgo (LeadsNavi é a marca controladora por trás do Mailgo; veja app.mailgo.ai e o site do Mailgo para detalhes).
Como se manter seguro	Defina apenas como uma variável de ambiente local — nunca cole no chat.
Como revogar	Vá para https://app.mailgo.ai → Tokens Pessoais → Exclua o token.
Endpoints de API chamados	Todas as chamadas vão para `https://api.leadsnavi.com` (API oficial do Mailgo) — verificação de e-mail, reivindicação de caixa de entrada, CRUD de campanha e relatórios. Revise os scripts Python incluídos para endpoints exatos.

MAILGO_API_KEY é sua credencial de conta Mailgo. Mantenha-a segura e nunca a compartilhe publicamente.

Conformidade

Esta skill envia e-mails para listas de destinatários que você fornece. Você é responsável por garantir que suas campanhas estejam em conformidade com as leis aplicáveis e os termos da plataforma, incluindo:

Lei CAN-SPAM (EUA) — inclua um endereço físico e respeite solicitações de exclusão
GDPR (UE) — garanta que você tenha uma base legal para contatar destinatários
Termos de Serviço do Mailgo — https://app.mailgo.ai

O otimizador de e-mail integrado da skill adiciona uma linha de opt-out suave a cada e-mail por padrão.

Estrutura de Diretórios

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

Início 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>

Referência de Scripts

Script	Finalidade	Argumentos Principais
`verify_emails.py`	Enviar + consultar verificação de e-mail	`emails...`, `--file`, `--email-column`
`claim_free_mailbox.py`	Reivindicar caixa de entrada pré-aquecida	`--json`, `--api-key`
`run_campaign.py`	Fluxo completo de criação de campanha	`--sender`, `--subject`, `--body/--body-file`, `--recipients/--recipients-file`
`campaign_control.py`	Ativar/pausar/excluir/listar	`activate/pause/delete/list/info`
`campaign_report.py`	Visualizar estatísticas da campanha	`overview/rounds/daily`, `--json`

Relação com Outras Skills do Mailgo

Este pacote consolida funcionalidades de:

mailgo-auth-setup — orientação de autenticação (Passo 0)
mailgo-email-verifier — verificação de e-mail (Passo 1)
mailgo-email-optimizer — regras de otimização de conteúdo (Passo 3)
mailgo-campaign — criação de campanha (Passo 4)
mailgo-campaign-control — gerenciamento do ciclo de vida (Passo 5)
mailgo-campaign-report — estatísticas (Passo 6)

Essas skills individuais permanecem disponíveis para uso autônomo. Este pacote fornece as mesmas capacidades em um único pacote autocontido.