conversion-ops

AI Conversion Ops

Preâmbulo (executado no início da skill)

# Verificação de versão (silenciosa se estiver atualizada)
python3 telemetry/version_check.py 2>/dev/null || true

# Opt-in de telemetria (apenas na primeira execução, depois lembra da sua escolha)
python3 telemetry/telemetry_init.py 2>/dev/null || true

Privacidade: Esta skill registra o uso localmente em ~/.ai-marketing-skills/analytics/. A telemetria remota é opt-in apenas. Nenhum código, caminho de arquivo ou conteúdo de repositório é coletado. Consulte telemetry/README.md.

---

Otimização da taxa de conversão baseada em IA: auditorias de landing pages, pontuação CRO, segmentação de pesquisas e geração de iscas digitais.

Quando Usar

• O usuário solicita uma auditoria de landing page ou análise CRO
• O usuário deseja pontuar uma página em várias dimensões de conversão
• O usuário precisa identificar gargalos de conversão em uma URL
• O usuário tem dados de pesquisa e deseja segmentar respondentes por ponto problemático
• O usuário deseja ideias de iscas digitais geradas a partir de respostas de pesquisa
• O usuário precisa de análise CRO em lote em várias URLs

Ferramentas

Auditoria CRO (cro_audit.py)

Busca uma landing page e a pontua em 8 dimensões de conversão. Não é necessário navegador headless.

# Auditoria de URL única
python cro_audit.py --url https://example.com/landing-page

# Modo lote — múltiplas URLs
python cro_audit.py --urls https://example.com/page1 https://example.com/page2

# URLs de um arquivo (uma por linha)
python cro_audit.py --file urls.txt

# Especificar setor para comparação com benchmark
python cro_audit.py --url https://example.com --industry saas

# Saída JSON
python cro_audit.py --url https://example.com --json

# Salvar relatório em arquivo
python cro_audit.py --url https://example.com --output report.json

Dimensões de pontuação (cada uma de 0 a 100):

1. Clareza do Título — A proposta de valor é óbvia em <5 segundos?
2. Visibilidade da CTA — As CTAs são proeminentes, contrastantes e estão acima da dobra?
3. Prova Social — Depoimentos, logotipos, estudos de caso, números?
4. Urgência — Escassez, prazos, ofertas limitadas?
5. Sinais de Confiança — Selos de segurança, garantias, privacidade, certificações?
6. Atrito do Formulário — Quantos campos? O formulário é intimidante?
7. Responsividade Móvel — Meta viewport, padrões responsivos, alvos de toque?
8. Indicadores de Velocidade da Página — Otimização de imagens, contagem de scripts, tamanho dos recursos?

Pontuação Geral CRO = Média ponderada em todas as 8 dimensões.

A saída inclui:

• Pontuação por dimensão com descobertas específicas
• Correções prioritárias classificadas por impacto
• Sugestões de antes/depois para cada problema
• Comparação com benchmark do setor
• Nota geral (A+ a F)

Setores suportados: saas, ecommerce, agency, finance, healthcare, education, b2b, general

Mecanismo de Pesquisa para Isca Digital (survey_lead_magnet.py)

Ingere dados CSV de pesquisa, agrupa respondentes por ponto problemático e gera briefs de isca digital para cada segmento.

# Uso básico — analisar CSV de pesquisa
python survey_lead_magnet.py --csv survey_responses.csv

# Especificar quais colunas contêm pontos problemáticos / desafios
python survey_lead_magnet.py --csv survey.csv --pain-columns "biggest_challenge" "top_frustration"

# Limitar número de segmentos
python survey_lead_magnet.py --csv survey.csv --top-segments 5

# Saída JSON
python survey_lead_magnet.py --csv survey.csv --json

# Salvar saída
python survey_lead_magnet.py --csv survey.csv --output lead_magnets.json

O que produz:

• Clusters de pontos problemáticos com contagens de respondentes
• Segmentos classificados por tamanho e potencial comercial
• Para cada segmento principal, um brief de isca digital:
  • Título, formato (guia/checklist/modelo/calculadora), gancho
  • Esboço de conteúdo (5–7 seções)
  • CTA alvo e canal de distribuição
  • Pontuação de potencial viral + pontuação de potencial de conversão
• Roteiro de implementação priorizado

Formato CSV: Perguntas como cabeçalhos de colunas, um respondente por linha. Funciona com exportação de qualquer ferramenta de pesquisa (Typeform, Google Forms, SurveyMonkey, etc.)

Configuração

Nenhuma chave de API é necessária. Ambas as ferramentas funcionam apenas com análise local.

Variáveis de ambiente opcionais:

Variável	Obrigatória	Descrição
USER_AGENT	Não	User agent personalizado para busca de páginas (padrão fornecido)
REQUEST_TIMEOUT	Não	Timeout HTTP em segundos (padrão: 15)

Fluxo de Trabalho Recomendado

1. Semanalmente: Execute cro_audit.py em suas principais landing pages para acompanhar as pontuações CRO ao longo do tempo
2. Pós-pesquisa: Execute survey_lead_magnet.py para transformar dados de pesquisa em estratégia de conteúdo
3. Pré-lançamento: Audite novas landing pages antes de direcionar tráfego pago
4. Mensalmente: Audite em lote as landing pages dos concorrentes para benchmarking

Dependências

pip install -r requirements.txt