Communitygithub.com

smnju98/marketing-copilot

Diagnostica e otimiza landing pages para melhorar a taxa de conversão (CRO). Usa replay de sessões e funis do PostHog para medir pontos de saída, verifica a consistência entre anúncio e landing page, e prioriza hipóteses até a geração de copy/código, deploy e nova medição.

O que é marketing-copilot?

O skill 'marketing-copilot' é uma ferramenta especializada em otimização de conversão (CRO) focada exclusivamente em landing pages. Ele trata a landing page como o destino final de todos os canais de tráfego, onde a taxa de conversão impacta diretamente o CAC de todos os canais. O fluxo de trabalho é baseado em dados: primeiro, instala a medição (PostHog, MS Clarity ou GA4) se necessário; depois, diagnostica pontos de saída através de análise de funil (visita → scroll → clique CTA → início do formulário → conclusão) e replay de sessões para identificar padrões de abandono. Em seguida, verifica a consistência entre a mensagem do anúncio e a landing page, e prioriza hipóteses com base em um sistema de pontuação (Impacto × Confiança × Dificuldade). O skill gera automaticamente tanto alterações de copy (título, CTA, oferta) quanto de código (HTML/CSS), sempre um elemento por vez para permitir medição isolada. Ele suporta plataformas como Claude Code, Cursor ou Codex, e lida com diferentes formas de deploy (repositório próprio, WordPress, builders como Café24/Imweb). As saídas incluem diagnósticos, propostas de melhoria, resultados de testes A/B e um resumo com próximos passos, tudo com forte ênfase em dados reais e proibição de palpites ou benchmarks inventados.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sminju98/marketing-copilot/tree/HEAD/skills/landing

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Loop de Marketing (sempre): detectar → julgar → produzir → publicar → aprender. Proibido publicar sem medição. Detalhes em [[method]].

landing — O dobro da taxa de conversão é mais barato que o dobro do tráfego (LND-01~15)

Landing page não é um canal, mas sim o destino de todos os canais. Anúncios ([[ads]]), blog ([[blog]]), redes sociais, e-mail — cada um traz pessoas, mas a conversão é decidida em uma única página. Por isso, este é o ponto de multiplicação: dobrar a taxa de conversão reduz pela metade o CAC de todos os canais. Dobrar o tráfego custa o dobro em anúncios todo mês; dobrar a conversão, uma vez corrigida, permanece.

Duas armadilhas: Primeiro, redesign por achismo — reformular "porque não está bonito" faz com que nunca se saiba o que melhorou ou piorou. O diagnóstico baseado em medição do ponto de vazamento sempre vem antes da correção. Segundo, inconsistência mensagem do anúncio vs. landing page — se a promessa do anúncio não está na primeira tela, o visitante acha que errou o lugar e sai. Essa é uma das maiores causas de baixo desempenho de anúncios, mas a maioria das pessoas simplesmente cria novos criativos.

Aqui é onde o item "landing" da lista de verificação de prontidão pré-anúncio (4 itens: evento de conversão, landing, margem, oferta) é realmente inspecionado. Deve ser aprovado antes de ligar o anúncio, e quando a "camada de landing" é apontada na separação de causas do anúncio (ADS-13), o trabalho vem para cá.

Tipo de execução: [A] Instalação de medição, diagnóstico, análise de funil, priorização de hipóteses, copy, sugestões de código, nova medição são automáticos / [P] Publicação ao vivo, início de A/B são após aprovação / [H] Apenas verificação factual de depoimentos e números fora do claims.md por humanos — consulte approval_mode. Diferenças entre tipos em [[role]].

0. Preparação

cat "${MKT_COPILOT_HOME:-$HOME/.marketing-copilot}/context/"{brand,products,audiences,tone,claims}.md 2>/dev/null
marketing-copilot library list content --limit 20
marketing-copilot library list campaign --status running
  • Se houver campanhas de anúncios rodando, comece pela landing delas — páginas que estão gastando dinheiro têm prioridade máxima.
  • Verifique o método de deploy da landing (repositório próprio/WordPress/builders como Café24, Imweb). Se houver acesso ao código, o trecho de automação até deploy é maior; se for builder, divida a sugestão em unidades aplicáveis (bloco, frase).

1. ★Diagnóstico primeiro — Veja o ponto de saída com os próprios olhos (LND-01~03)

Proibido adivinhar. Se você não sabe onde está vazando, não corrija nada.

  • Se não houver medição, instalar medição é a tarefa número 1. O padrão é PostHog Session Replay + Funnels (gravação gratuita de até 5 mil eventos/mês) — a inserção do snippet é modificação de código, feita pelo Claude. Alternativas: MS Clarity (heatmap e replay grátis), GA4 (apenas funil).
  • Coloque o funil de 5 etapas com dados: Visita → Scroll (passou da primeira tela) → Clique no CTA → Início do formulário → Conclusão.
Etapa de vazamentoMétodo de observaçãoCausa provável
Saída imediata após visitaInício do replay · PageSpeed realCarregamento lento no mobile · Inconsistência mensagem do anúncio · Oferta ausente na primeira tela
Não faz scrollProfundidade de scrollTítulo não dá motivo para continuar lendo
Faz scroll mas não clica no CTACliques vs. impressões do CTAOferta fraca · Texto do CTA não induz ação · CTA não visível
Abandono após iniciar formulárioReplay identifica campo de abandonoCampos demais · Solicitação de informação sensível · Tratamento de erro ruim
Concluiu mas conversão não contabilizadaVerificação de disparo de eventoBug de medição — problema não é de desempenho, mas de medição
  • O replay é lido e resumido pela IA — não é para o humano assistir tudo, mas para extrair padrões (ponto de parada, scroll de volta, campo de abandono) das sessões de saída e relatar.

2. Verificação de consistência anúncio vs. landing (LND-04) — A realidade do item "landing" na lista de prontidão de anúncios

VerificaçãoCritério de aprovação
Consistência da promessaOferta, título e preço do criativo do anúncio estão exatamente na primeira tela
Chegada por origemCada variação de utm_content cai na landing (ou seção) correta
MobileA maioria do tráfego do anúncio é mobile — a primeira tela mobile deve carregar sem erros
Evento de conversãoClique no CTA e conclusão do formulário são realmente medidos (pixel, GA4)
Se algum item não for atendido, responda para [[ads]] como "landing não aprovada" e faça a correção primeiro — o anúncio não é ativado.

3. Princípios de estrutura — A batalha se vence na primeira tela (LND-05~08)

ElementoPrincípioFalha comum
TítuloUse exatamente o ângulo do acervo de mensagens validadas ([[messages]]) — título da landing = mensagemComeçar com apresentação da empresa ("O novo padrão da OO")
OfertaMotivo para agir agora (preço, trial, garantia, prazo) na primeira telaOferta só aparece após três scrolls
CTAUm na primeira tela, verbo de ação ("Solicite orçamento grátis")Frases sem ação como "Saiba mais" · Três CTAs competindo
FormulárioMínimo de campos — remova o que não é necessário agoraPedir endereço e data de nascimento no primeiro contato
Prova socialApenas dados do claims.md. Depoimentos, números e prêmios fora do acervo só após verificação [H]; depoimentos remunerados exigem identificação ([[review]])Números sem fundamento como "99% de satisfação"
Velocidade e mobileMobile-first — gerenciado com medição real de PageSpeed e LighthouseVerificar e publicar apenas no PC
  • Portaria legal do formulário: Formulários que coletam dados pessoais exigem aviso e consentimento sobre finalidade, itens e período de retenção (Lei de Proteção de Dados Pessoais). O consentimento para marketing deve ser uma opção separada e opcional — não embutido no consentimento obrigatório (Lei da Rede de Informações e Comunicações). A redação e verificação são automáticas, mas apenas a decisão final sobre o design do consentimento fica na portaria.

4. Priorização de hipóteses — IA pontua (LND-09)

Liste todas as hipóteses do diagnóstico e ordene por Impacto × Confiança × Dificuldade. Impacto = volume de tráfego na etapa com vazamento × magnitude da queda (medido); Confiança = força da evidência do replay/funil; Dificuldade = escopo da correção (uma linha de texto vs. reformulação estrutural). A ordenação é um julgamento, e o julgamento é automático — não apenas jogue uma lista "por onde começar", mas aponte a prioridade 1 com sua justificativa.

5. Geração de correções — Tanto copy quanto código são criados aqui (LND-10~11)

  • Copy (título, CTA, texto da oferta) é escrita pela IA usando os ângulos do acervo de mensagens. Números e superlativos apenas os que estão no claims.md.
  • Correções estruturais e de código também são feitas diretamente pelo Claude — se houver repositório, edite HTML/CSS/componentes até preview/PR; se for builder, forneça instrução de aplicação por bloco.
  • Se precisar de imagens ou visuais, é uma solicitação ([[brief]] → [[imagefactory]]) — não produza aqui.
  • Altere apenas um elemento por vez. Mudar título, oferta e formulário simultaneamente torna a nova medição inútil.

6. A/B — Não julgue se a amostra não estiver completa (LND-12~13)

  • Um elemento por vez, o resto fixo. A métrica de julgamento é definida previamente (geralmente conclusão de formulário ou compra).
  • Calcule primeiro a amostra necessária e a duração do experimento com base no tráfego atual e na taxa de conversão base. Se a duração for de meses, abandone o A/B e vá para comparação antes/depois + uma grande mudança — mudanças medíocres com tráfego medíocre são o pior cenário.
  • Uma vantagem com amostra insuficiente é registrada apenas como "julgamento pendente". Não escreva como se tivesse vencido.
  • Diferencie de A/B de criativos de anúncio: variações de criativo são gerenciadas pelo canal ([[ads]] seção 5). Aqui, tratamos apenas da página de destino, e não rodamos simultaneamente A/B de criativo e A/B de landing para o mesmo tráfego — a separação de causas é quebrada.

7. Deploy → Nova medição (LND-14~15)

  • Deploy é [P] — aplicado após aprovação. Imediatamente após o deploy, verifique se o evento de conversão dispara (o erro mais comum é quebrar a medição durante a correção).
  • A nova medição compara os mesmos números do funil antes e depois. Registre a alteração:
marketing-copilot library add content --json '{"channel":"landing","title":"{página}: {linha resumo do elemento alterado}","message_id":"MSG-...","status":"published"}'
  • Se o título venceu, isso não é vitória da página, mas sim vitória da mensagem — atribua ao acervo ([[messages]]) e expanda esse ângulo para anúncios, blog e redes sociais ([[repurpose]]).

Saída

🎯 Landing {diagnóstico | proposta de melhoria | julgamento} — {URL} · {data} (approval_mode: {mode})
Medição: {PostHog conectado | não instalado → instalação é tarefa #1}
Funil (período {…}): Visitas {n} → Scroll {n} → CTA {n} → Início formulário {n} → Conclusão {n}  ← Maior queda: {etapa}
Leitura do replay: {resumo do padrão — ex: abandono concentrado no campo 3 do formulário}
Consistência do anúncio: Promessa{✓/✗} Chegada{✓/✗} Mobile{✓/✗} Medição{✓/✗} → {aprovado | resposta de não aprovado para ads}
Hipóteses (por prioridade): 1 {…} (evidência: {dado real}) · 2 {…} · 3 {…}
Correção: {1 elemento} — Atual "{…}" → Proposta "{…}" · Aplicação {PR/preview | instrução de bloco}
Experimento: {A/B — amostra necessária {n}·estimativa {k}semanas | Comparação antes/depois — motivo do tráfego}
→ Próxima ação: {1} · Aprovação de deploy {necessária | concluída} · Nova medição {data}
⚠️ {Números fora do claims.md: {n} itens — verificação [H] necessária | nenhum}

Princípios

  • Proibido corrigir sem diagnóstico. Não proponha "vamos redesenhar" sem medir o ponto de saída. Se não há medição, instalar medição é a tarefa da semana.
  • Consistência anúncio vs. landing é a primeira verificação. Antes de criar novos criativos, veja se a página de destino cumpre a promessa.
  • Não invente números. Não cite benchmarks de taxa de conversão, "média do setor", ou taxa de abandono por campo. A única evidência são as medições do nosso funil e comparações antes/depois; valores desconhecidos são "precisa verificar".
  • Um elemento por vez. Mudanças simultâneas não geram aprendizado — gastos que não geram aprendizado são apenas prejuízo.
  • Amostra insuficiente = julgamento suspenso. "Acho que venceu" não é um julgamento.
  • Números, superlativos e depoimentos na landing também são publicações. Devem passar pela mesma portaria de [[publish-policy]] (comprovação da alegação, obrigação de identificação, barra de qualidade).

Navegação para outros skills

SituaçãoPara onde ir
Verificação completa de prontidão antes de ligar anúncio[[ads]] seção 1 — a inspeção real do item landing é feita aqui e o resultado é reportado
Não há ângulo para usar como título[[messages]] — escolha do acervo de mensagens validadas
Leitura completa de desempenho pós-conversão[[analyze]]
Quer aumentar depoimentos e reviews[[review]] — se houver remuneração, obrigação de identificação
Criação de visuais e banners para landing[[brief]] → [[imagefactory]]

Resumo

Tráfego se compra, mas taxa de conversão se conquista — veja com os próprios olhos onde está vazando e mude um elemento por vez.

Habilidades Relacionadas