ricneves-ai/flowgrammers-skills/social-media-analyzer

Analisador de Mídia Social

Análise de desempenho de campanhas com métricas de engajamento, cálculos de ROI e benchmarks de plataforma.

Sumário

• Fluxo de Trabalho de Análise
• Métricas de Engajamento
• Cálculo de ROI
• Benchmarks de Plataforma
• Ferramentas
• Exemplos

Fluxo de Trabalho de Análise

Analise o desempenho de campanhas de mídia social:

1. Validar completude dos dados de entrada (alcance > 0, datas válidas)
2. Calcular métricas de engajamento por post
3. Agregar métricas a nível de campanha
4. Calcular ROI se gasto com anúncios fornecido
5. Comparar com benchmarks de plataforma
6. Identificar os melhores e piores performers
7. Gerar recomendações
8. Validação: Taxa de engajamento < 100%, ROI corresponde aos dados de gasto

Requisitos de Entrada

Verificações de Validação de Dados

Antes da análise, verifique:

• [ ] Alcance > 0 para todos os posts (evitar divisão por zero)
• [ ] Contagens de engajamento são não negativas
• [ ] Intervalo de datas é válido (início < fim)
• [ ] Plataforma é reconhecida
• [ ] Gasto > 0 se ROI solicitado

Métricas de Engajamento

Cálculo da Taxa de Engajamento

Taxa de Engajamento = (Curtidas + Comentários + Compartilhamentos + Salvamentos) / Alcance × 100

Definições de Métricas

Categorias de Desempenho

Cálculo de ROI

Calcule o retorno sobre o gasto com anúncios:

1. Some o total de engajamentos entre posts
2. Calcule custo por engajamento (CPE)
3. Calcule custo por clique (CPC) se cliques disponíveis
4. Estime o valor do engajamento usando taxas de benchmark
5. Calcule porcentagem de ROI
6. Validação: ROI = (Valor - Gasto) / Gasto × 100

Fórmulas de ROI

Estimativas de Valor de Engajamento

Interpretação de ROI

Benchmarks de Plataforma

Taxa de Engajamento por Plataforma

CTR por Plataforma

CPC por Plataforma

Veja references/platform-benchmarks.md para dados completos de benchmark.

Ferramentas

Calcular Métricas

python scripts/calculate_metrics.py assets/sample_input.json

Calcula taxa de engajamento, CTR, taxa de alcance para cada post e totais da campanha.

Analisar Desempenho

python scripts/analyze_performance.py assets/sample_input.json

Gera análise completa de desempenho com ROI, benchmarks e recomendações.

A saída inclui:

• Métricas a nível de campanha
• Breakdown post por post
• Comparações de benchmark
• Top performers rankeados
• Recomendações acionáveis

Exemplos

Entrada de Exemplo

Veja assets/sample_input.json:

{
  "platform": "instagram",
  "total_spend": 2500,
  "posts": [
    {
      "post_id": "post_001",
      "content_type": "image",
      "likes": 342,
      "comments": 28,
      "shares": 15,
      "saves": 45,
      "reach": 5200,
      "impressions": 8500,
      "clicks": 120
    }
  ]
}

Saída de Exemplo

Veja assets/expected_output.json:

{
  "campaign_metrics": {
    "total_engagements": 1521,
    "avg_engagement_rate": 8.36,
    "ctr": 1.55
  },
  "roi_metrics": {
    "total_spend": 2500.0,
    "cost_per_engagement": 1.64,
    "roi_percentage": 660.5
  },
  "insights": {
    "overall_health": "excellent",
    "benchmark_comparison": {
      "engagement_status": "excellent",
      "engagement_benchmark": "1.22%",
      "engagement_actual": "8.36%"
    }
  }
}

Interpretação

A campanha de exemplo mostra:

• Taxa de engajamento 8,36% vs benchmark de 1,22% = Excelente (6,8x acima da média)
• CTR 1,55% vs benchmark de 0,22% = Excelente (7x acima da média)
• ROI 660% = Retorno excepcional sobre R$2.500 de gasto
• Recomendação: Escale o orçamento, replique elementos bem-sucedidos

Documentação de Referência

Benchmarks de Plataforma

references/platform-benchmarks.md contém:

• Benchmarks de taxa de engajamento por plataforma e setor
• Benchmarks de CTR para conteúdo orgânico e pago
• Benchmarks de custo (CPC, CPM, CPE)
• Desempenho de tipo de conteúdo por plataforma
• Horários e frequências ideais de postagem
• Fórmulas de cálculo de ROI

Gatilhos Proativos

• Taxa de engajamento abaixo da média da plataforma → Conteúdo não está ressoando. Analise os top performers para padrões.
• Crescimento de seguidores estagnado → Problema de distribuição ou frequência de conteúdo. Audite padrões de postagem.
• Muitas impressões, baixo engajamento → Alcance sem ressonância. Problema de qualidade do conteúdo.
• Concorrente com desempenho significativamente superior → Lacuna de conteúdo. Analise os posts bem-sucedidos deles.

Artefatos de Saída

Comunicação

Toda saída passa por verificação de qualidade:

• Autovalidação: atribuição de fonte, auditoria de suposições, pontuação de confiança
• Formato de saída: Conclusão → O quê (com confiança) → Por quê → Como Agir
• Apenas resultados. Cada descoberta marcada: 🟢 verificado, 🟡 médio, 🔴 assumido.

Skills Relacionadas

• social-content: Para criar posts sociais. Use esta skill para analisar desempenho.
• campaign-analytics: Para analytics multicanal incluindo social.
• content-strategy: Para planejar temas de conteúdo social.
• marketing-context: Fornece contexto de audiência para melhor análise.