blog-analyze

Analisador de Blog -- Auditoria de Qualidade e Pontuação

Pontua artigos de blog em uma escala de 0 a 100 em 5 categorias e fornece recomendações de melhoria priorizadas. Inclui análise de detecção de conteúdo IA. Funciona com arquivos locais ou URLs publicados.

Documentos de referência:

• references/quality-scoring.md -- checklist completo de pontuação
• references/eeat-signals.md -- critérios de avaliação E-E-A-T

Tratamento de Entrada

• Arquivo local: Leia o arquivo diretamente
• URL: Busque com WebFetch, extraia o conteúdo
• Diretório: Varra por arquivos de blog, audite todos (modo lote)
• Flags: --format json|table, --batch, --sort score

Processo de Pontuação

Passo 1: Extração de Conteúdo

Leia o artigo do blog e extraia:

• Frontmatter (título, descrição, data, lastUpdated, autor, tags)
• Estrutura de cabeçalhos (H1, H2, H3 com hierarquia)
• Contagem de parágrafos e contagem de palavras por parágrafo
• Estatísticas (qualquer alegação numérica com ou sem fontes)
• Imagens (quantidade, presença de texto alternativo, formato)
• Gráficos/SVGs (quantidade, diversidade de tipos)
• Links (internos, externos, quebrados)
• Presença de seção FAQ
• Marcação Schema (tipos presentes)
• Meta tags (título, descrição, OG tags, twitter cards)
• Comprimentos de frases para análise de burstiness
• Tokens de vocabulário para pontuação de diversidade

Passo 2: Pontuar Cada Categoria

Carregue references/quality-scoring.md para o checklist completo. Pontue cada:

Qualidade de Conteúdo (30 pontos)

Verificação	Pontos	Critérios de Aprovação
Profundidade/abrangência	7	Cobre o tópico completamente, sem lacunas importantes
Legibilidade (Flesch 60-70)	7	Flesch 60-70 ideal, 55-75 aceitável; Grade 7-8; Gunning Fog 7-8
Originalidade/marcadores de valor único	5	Dados originais, estudos de caso, experiência em primeira mão
Estrutura de frases e parágrafos	4	Média de frases 15-20 palavras, ≤25% acima de 20; parágrafos 40-80 palavras; H2 a cada 200-300 palavras
Elementos de engajamento	4	Caixa de resumo, chamadas, blocos de conteúdo variados. Aceito: "TL;DR", "Key Takeaways", "The Bottom Line", "What You'll Learn", "At a Glance", "In Brief"
Gramática/antipadrões	3	Voz passiva ≤10%, palavras-gatilho de IA ≤5/1K, palavras de transição 20-30%, prosa limpa

Faixas de Legibilidade (aplique por persona, ou use o padrão):

Público	Grade Flesch	Facilidade Flesch	Impacto na Pontuação
Consumidor	6-8	60-80	Pontos cheios se dentro da faixa
Profissional	8-10	50-60	Pontos cheios se dentro da faixa
Técnico	10-12	30-50	Pontos cheios se dentro da faixa
Padrão (sem persona)	7-8	60-70	Pontuação atual inalterada

A clareza de conteúdo é o fator nº 2 para probabilidade de citação por IA (+32,83% diferença de pontuação). O adulto americano médio lê no nível da 7ª-8ª série.

Otimização SEO (25 pontos)

Verificação	Pontos	Critérios de Aprovação
Hierarquia de cabeçalhos com palavras-chave	5	H1 -> H2 -> H3, sem pulos, palavra-chave em 2-3 cabeçalhos
Tag Title (40-60 caracteres, palavra-chave, palavra de poder)	4	Palavra-chave no início, sentimento positivo
Posicionamento/densidade de palavra-chave	4	Integração natural, sem enchimento, nas primeiras 100 palavras
Links internos (3-10 contextuais)	4	Texto âncora descritivo, bidirecional
Estrutura de URL	3	Curta, rica em palavras-chave, sem stop words, minúscula
Meta description (150-160 caracteres, com estatística)	3	Densa em fatos, inclui uma estatística
Links externos (tier 1-3)	2	3-8 links de saída para fontes autoritativas

Sinais E-E-A-T (15 pontos)

Verificação	Pontos	Critérios de Aprovação
Atribuição de autor (nomeado, com biografia)	4	Nome real, credenciais, não é discurso de vendas
Citações de fontes (tier 1-3, inline)	4	8+ estatísticas únicas, zero fabricadas
Indicadores de confiança	4	Página de contato, página sobre, política editorial
Sinais de experiência	3	"Quando testamos...", fotos/dados originais

Elementos Técnicos (15 pontos)

Verificação	Pontos	Critérios de Aprovação
Marcação Schema (3+ tipos = bônus)	4	BlogPosting + FAQ + Person mínimo
Otimização de imagens	3	AVIF/WebP, texto alternativo descritivo, lazy exceto LCP
Elementos de dados estruturados	2	Tabelas, listas, blocos de comparação
Sinais de velocidade de página	2	LCP < 2.5s, sem JS que bloqueia renderização
Amigabilidade para dispositivos móveis	2	Responsivo, alvos de toque 48px+
Meta tags OG/social	2	og:title, og:description, og:image, twitter:card

Prontidão para Citação por IA (15 pontos)

Verificação	Pontos	Critérios de Aprovação
Capacidade de citação em nível de passagem (120-180 palavras)	4	Seções autocontidas com estatística + fonte
Seções formatadas em Q&A	3	60-70% dos H2s como perguntas, FAQ presente
Clareza de entidade	3	Entidade de tópico inequívoca, terminologia consistente
Estrutura de conteúdo para extração	3	Resposta primeiro, tabelas com thead, formatos de comparação
Acessibilidade para rastreadores de IA	2	SSR/SSG, sem conteúdo bloqueado por JS

Passo 3: Detecção de Conteúdo IA

Analise o artigo quanto ao risco de conteúdo gerado por IA:

Pontuação de Burstiness (variância de comprimento de frases):

• Calcular o desvio padrão dos comprimentos das frases em todo o artigo
• Escrita humana: alta variância (frases curtas e incisivas + frases longas e complexas)
• Escrita IA: baixa variância (frases consistentemente de comprimento médio)
• Pontuação: escala de 0 a 10 (10 = burstiness muito humana)

Detecção de Frases Conhecidas de IA -- sinalizar ocorrências destas 17 frases:

1. "It's important to note"
2. "In today's digital landscape"
3. "Delve into"
4. "Navigating the complexities"
5. "Let's explore"
6. "Furthermore"
7. "In conclusion"
8. "It is worth mentioning"
9. "Embark on"
10. "Cutting-edge"
11. "Leverage" (como verbo, contexto não financeiro)
12. "Game-changer"
13. "Revolutionize"
14. "Streamline"
15. "Harness the power"
16. "Dive deep"
17. "Unlock the potential"
18. Travessões (—) - conte todas as instâncias, sinalize como padrão de escrita IA

Diversidade de Vocabulário (Relação Tipo-Token):

• Calcular palavras únicas / total de palavras
• Escrita humana: TTR tipicamente 0,4-0,6 para texto longo
• Escrita IA: TTR frequentemente abaixo de 0,35 (vocabulário repetitivo)

Avaliação de Risco de Conteúdo IA:

• Sinalizar se a probabilidade de IA > 50% com base nos sinais combinados
• Fornecer passagens específicas que acionaram a sinalização
• Recomendar humanização: anedotas pessoais, ritmo de frases variado, jargão de domínio

Passo 4: Determinar a Classificação

Pontuação	Classificação	Ação
90-100	Excepcional	Publique como está, conteúdo principal
80-89	Forte	Pequenas melhorias, pronto para publicação
70-79	Aceitável	Melhorias direcionadas necessárias
60-69	Abaixo do Padrão	Retrabalho significativo necessário
< 60	Reescrever	Problemas fundamentais, comece do esboço

Passo 5: Gerar Relatório

Formato de saída padrão (Markdown):

## Relatório de Qualidade do Blog: [Título]

**Pontuação: [X]/100** -- [Classificação]

### Detalhamento da Pontuação
| Categoria | Pontuação | Máx | Observações |
|-----------|-----------|-----|-------------|
| Qualidade de Conteúdo | X | 30 | [Resumo de 1 linha] |
| Otimização SEO | X | 25 | [Resumo de 1 linha] |
| Sinais E-E-A-T | X | 15 | [Resumo de 1 linha] |
| Elementos Técnicos | X | 15 | [Resumo de 1 linha] |
| Prontidão para Citação IA | X | 15 | [Resumo de 1 linha] |
| **Total** | **X** | **100** | |

### Risco de Conteúdo IA
- **Pontuação de Burstiness**: [X]/10 ([semelhante a humano / moderado / plano])
- **Frases de IA detectadas**: [N] ([lista de frases encontradas])
- **Diversidade de Vocabulário (TTR)**: [X] ([alto / aceitável / baixo])
- **Probabilidade de IA**: [X]% -- [Nenhuma preocupação / Revisão recomendada / Alto risco]
- **Passagens sinalizadas**: [citar seções planas ou formulaicas, se houver]

### Problemas Encontrados

#### Crítico (Deve Corrigir)
- [ ] [Problema com localização específica e correção]

#### Alta Prioridade
- [ ] [Problema com localização específica e correção]

#### Prioridade Média
- [ ] [Problema com localização específica e correção]

#### Baixa Prioridade
- [ ] [Problema com localização específica e correção]

### Estatísticas Rápidas
- Contagem de palavras: [N]
- Parágrafos: [N] (X acima de 150 palavras)
- Seções H2: [N] (X como perguntas, X com formatação resposta-primeiro)
- Estatísticas: [N] com fonte / [N] sem fonte
- Imagens: [N] (X com texto alternativo, formatos: ...)
- Gráficos: [N] (tipos: ...)
- Links internos: [N]
- Links externos: [N] (divisão por tier: ...)
- Tipos de Schema: [lista]
- Tags OG/sociais: [presente/ausente]

### Ações Recomendadas
1. [Correção de maior impacto -- itens críticos primeiro]
2. [Segundo maior impacto]
3. [Terceiro]

Execute `/blog rewrite <file>` para aplicar essas otimizações automaticamente.

Formatos de Exportação

Padrão: Relatório Markdown

Relatório detalhado padrão conforme mostrado acima.

Exportação JSON (--format json)

Saída legível por máquina para integração com CI/CD ou painéis:

{
  "file": "post.md",
  "title": "...",
  "score": 78,
  "rating": "Acceptable",
  "categories": {
    "content_quality": { "score": 22, "max": 30 },
    "seo_optimization": { "score": 18, "max": 25 },
    "eeat_signals": { "score": 12, "max": 15 },
    "technical_elements": { "score": 13, "max": 15 },
    "ai_citation_readiness": { "score": 13, "max": 15 }
  },
  "ai_detection": {
    "burstiness": 6.2,
    "ai_phrases_found": ["Furthermore", "Let's explore"],
    "ttr": 0.44,
    "ai_probability": 32
  },
  "issues": {
    "critical": [],
    "high": [],
    "medium": [],
    "low": []
  }
}

Exportação Tabela (--format table)

Resumo compacto para revisão rápida:

Arquivo          | Pontuação | Classificação | Conteúdo | SEO | EEAT | Técnico | Pront. IA | Risco IA
post.md          |        78 | Aceitável     |    22/30 | 18/25 | 12/15 |   13/15 |     13/15 |      32%

Modo Lote

Quando um diretório ou a flag --batch é fornecida, varra por arquivos de blog e produza uma tabela de resumo. Use --sort score para ordenar por pontuação (crescente por padrão).

## Resumo de Auditoria do Blog: [N] Artigos Analisados

| Arquivo   | Pontuação | Classificação | Conteúdo | SEO | EEAT | Técnico | Pront. IA | Risco IA | Principal Problema |
|-----------|-----------|---------------|----------|-----|------|---------|-----------|----------|--------------------|
| post-1.md |        85 | Forte         |    26/30 | 20/25 | 13/15 |   14/15 |     12/15 |      18% | Tags OG ausentes |
| post-2.md |        42 | Reescrever    |    10/30 |  8/25 |  5/15 |    9/15 |     10/15 |      71% | 12 estatísticas fabricadas |
| post-3.md |        71 | Aceitável     |    20/30 | 16/25 | 10/15 |   12/15 |     13/15 |      25% | Sem formato resposta-primeiro |

### Fila de Prioridade (Menor Pontuação Primeiro)
1. post-2.md (42) -- Reescrever completamente necessário, alto risco de conteúdo IA
2. post-3.md (71) -- Formatação resposta-primeiro + estatísticas necessárias
3. post-1.md (85) -- Adicionar tags OG, pequenas melhorias

Execute `/blog rewrite <file>` em cada um, começando pela pontuação mais baixa.