Cism-Ch/aioseo-verification

Guia de Verificação AIOSEO & Geração de Conteúdo

Este guia define os padrões de redação para fichas de produtos WordPress, alinhados com os algoritmos TruSEO do AIOSEO e os princípios de conversão Big Tech.

---

📋 CHECKLIST DE VERIFICAÇÃO AIOSEO (TruSEO)

1. Análise do Título & Meta

• SEO Title Length: Entre 50 e 60 caracteres. A palavra-chave principal deve estar no início.
• Meta Description Length: Entre 155 e 160 caracteres. Deve incluir a USP (Unique Selling Proposition) e uma chamada para ação (CTA).

2. Estrutura do Conteúdo (Seguir os Templates)

• Content Length: Mínimo 500 palavras (texto visível) para uma descrição longa (margem de segurança de produção, limite rigoroso de 450).
• Subheading Distribution: Um título (H2) para cada bloco.
• Short Description TAGS: Deve incluir uma conclusão em itálico via a tag <em>.
• HTML Hygiene: Não usar <div> ou estilos CSS personalizados nas descrições curtas (SEO WordPress).
• Internal Links: Pelo menos 1 link para um acessório ou categoria pai.
• External Links: Pelo menos 1 link para uma fonte de autoridade (ex: ficha do fabricante) ou teste independente.
• Images/Videos: Presença de mídias com atributos alt descritivos incluindo a palavra-chave.

3. Legibilidade (Fatores TruSEO)

• Paragraph Word Count (CRÍTICO - BLOQUEANTE):
  • Nota de cálculo: Contar apenas o texto visível (tags HTML removidas). O script validate_html_template.py é a autoridade para o cálculo do número de palavras. Alternativamente, o Agente realiza essa contagem durante sua autoauditoria.
  • Parágrafo introdutório: ≤ 100 palavras (apresentação factual do produto)
  • Todos os outros parágrafos: ≤ 60 palavras por parágrafo (flexível 45-60 conforme tamanho da tabela de especificações)
  • Seção "Ficha técnica resumida": O H2 + tabela adiciona cerca de 50-60 palavras ao total
  • Descrição longa total: 500-650 palavras (Visar 500 palavras mínimo de segurança - RIGOROSO - Proibido ficar abaixo de 450 ou ultrapassar 650)
  • Verificação do cálculo: Contar TODAS as palavras visíveis, incluindo H2 "Ficha técnica" e conteúdo da tabela (exceto tags)
• Paragraphs Length: Nenhum parágrafo deve exceder 60 palavras (introdutório máximo 100). Ajustar conforme tabela.
• Sentences Length (CRÍTICO - BLOQUEANTE): No máximo 25% das frases podem exceder 20 palavras (alvo: ≤20%). Priorizar frases de 12 a 18 palavras. A IA Redatora divide sistematicamente toda frase que atinge 18 palavras com um ponto.
• Sentence Structure (Vigilância): Descrições técnicas complexas devem ser divididas em duas frases distintas, em vez de usar vírgulas excessivas.
• Passive Voice: Máximo de 10% de frases na voz passiva. Priorizar a voz ativa (ex: "O processador acelera" em vez de "O desempenho é acelerado por").
• Transition Words (por FRASE, não por parágrafo): Pelo menos 30% das frases devem conter uma palavra de transição (zona ideal 30-70%). O AIOSEO procura transições em qualquer lugar da frase, não apenas no início. Limitar transições no início do parágrafo a no máximo 4 em 7 para evitar um estilo muito pesado. Validado por audit_aioseo_sentences.py.
• Consecutive Sentences: Nunca começar 3 frases consecutivas com a mesma palavra.
• Flesch Reading Ease: Pontuação alvo entre 60 e 70 (Legibilidade "Padrão").

4. Qualidade Gramatical e Tom (CRÍTICO)

• Gramática Padrão: Usar SOMENTE o português padrão correto. Sem construções rebuscadas, sintaxe artificial ou tom "robótico".
• Artigos & Determinantes: Sempre usar os artigos corretos (o, a, os, as, um, uma, uns, umas) antes dos substantivos para produzir frases gramaticalmente corretas.
• Fluidez Natural: O texto deve ser lido naturalmente. Evitar repetições de estruturas de frases (ex: "Ele dispõe de... Ele possui... Ele está equipado...").
• Sem Verborragia: Evitar frases muito descritivas ou linguagem floreada. Priorizar clareza e concisão.
• Tom Factual: Escrever em tom direto e factual, inspirado em fichas técnicas profissionais (estilo Samsung/Apple).
• Sem Adjetivos Excessivos: Limitar superlativos e adjetivos enfáticos ("incrível", "revolucionário"). Preferir fatos mensuráveis.
• Correção Ortográfica: Verificar a ortografia de todas as palavras, especialmente termos técnicos e nomes de marcas.
• Consistência Temporal: Usar o presente do indicativo de maneira consistente para descrever as características do produto.

---

🔝 LISTA DE PALAVRAS DE TRANSIÇÃO (PARA TRUSEO)

Use estes termos de forma variada para manter a taxa de 30-70% por frase (não por parágrafo). O AIOSEO procura essas palavras em qualquer lugar da frase:

• Adição: Além disso, Outrossim, Também, Ademais, Igualmente, e, Bem como.
• Contraste / Oposição: No entanto, Todavia, Contudo, Por outro lado, Entretanto, Ao passo que, Embora.
• Causa / Justificativa: De fato, Pois, Dado que, Já que, Porque, Graças a.
• Consequência / Conclusão: Por conseguinte, Assim, Por isso, Logo, Em suma, Em conclusão, Resumindo, Finalmente.
• Tempo / Ordem: Primeiramente, Em seguida, Finalmente, Depois, Primeiro, Em segundo lugar, Em terceiro lugar, Num primeiro momento, Num segundo momento, Para concluir.
• Ilustração: Por exemplo, Especialmente, Em particular, Especificamente, Como.
• Alternativa: Quer... quer, Seja... seja, de um lado... do outro.

---

🤖 DIRETRIZES DE GERAÇÃO (Framework AIOSEO - Professional Copywriting)

ABORDAGEM: REDATOR PROFISSIONAL DE TECNOLOGIA

O sistema deve funcionar como um redator profissional que escreve conteúdo variado e natural baseado nas especificações técnicas verdadeiras.

Metodologia de Redação Profissional

✅ EXEMPLO DE ABORDAGEM CORRETA - Redação Natural:

Specs: {"processador": "MediaTek Helio G99", "bateria": "5500 mAh", "tela": "AMOLED 120Hz"}
Redação: "O Redmi Note 14 4G é equipado com o processador MediaTek Helio G99 fabricado em 6nm, 
oferecendo desempenho equilibrado para multitarefas e jogos leves. Sua bateria 
de 5500 mAh garante autonomia de mais de 12 horas em uso intensivo. A tela 
AMOLED de 6,67 polegadas com atualização de 120Hz torna cada interação mais fluida."

❌ ABORDAGEM INCORRETA - Substituição Rígida:

Template rígido: "O [PROCESSADOR] oferece [QUALIFICATIVO]."
Resultado: Texto repetitivo e pouco natural

Instruções para o Agente de IA

LIMITES RIGOROSOS DE CONTAGEM DE PALAVRAS A SEREM SEMPRE RESPEITADOS:

• Nota: O cálculo é feito no texto visível apenas (tags HTML excluídas).
• Parágrafo introdutório: MÁXIMO 100 palavras
• Todos os outros parágrafos: MÁXIMO 60 palavras por parágrafo
• Descrição longa total: 500-650 palavras (alvo de segurança para geração; o validador aceita o pacote a partir de 450 palavras por razões de compatibilidade, mas mirar 500 palavras evita qualquer rejeição).
• Validar ANTES da criação do arquivo - Falhar o checkpoint se ultrapassado

Durante a Fase 2 (LONG) e Fase 3 (SHORT):

1. Analisar as Especificações

   • Ler o arquivo specs-[variant].html completamente
   • Identificar as características-chave e diferenciadoras
   • Anotar os dados técnicos exatos (capacidades, modelos, tecnologias)
   • As Especificações devem corresponder e ser verdadeiras

2. Redigir Naturalmente

   • Escrever como um redator técnico profissional
   • Variar as estruturas das frases
   • Usar palavras de transição de forma natural
   • Explicar as especificações técnicas de forma acessível
   • Conectar as características técnicas aos benefícios reais

3. Padrões de Qualidade

   • Gramática: Português padrão impecável
   • Tom: Factual, profissional, estilo Samsung/Apple
   • Precisão: Todos os dados técnicos devem corresponder exatamente às especificações
   • Clareza: Frases curtas (≤20 palavras, divisão sistemática aos 18), parágrafos concisos
   • Natural: O texto deve ser lido fluentemente, não como um formulário preenchido

4. O que DEVE ser feito

   • ✅ Variar os inícios de frases
   • ✅ Usar sinônimos apropriados
   • ✅ Criar transições fluidas entre as seções
   • ✅ Explicar termos técnicos quando necessário
   • ✅ Manter um tom consistente e profissional
   • ✅ Usar adjetivos úteis e precisos

5. O que DEVE ser EVITADO

   • ❌ Inventar especificações ou aproximar números
   • ❌ Usar linguagem de marketing excessiva ou superlativos não justificados
   • ❌ Repetir as mesmas estruturas de frase
   • ❌ Escrever de forma verbosa ou complexa
   • ❌ Usar um tom artificial ou robótico
   • ❌ Excesso de adjetivos para não sobrecarregar desnecessariamente o texto

Restrições de redação (RIGOROSAS):

1. Comprimento: 500-650 palavras para LONG (alvo de segurança), <60 palavras teaser para SHORT
2. Estrutura HTML: Seguir a estrutura do template (H1, H2, parágrafos, listas)
3. Legibilidade TruSEO:
   • Frases curtas (≤20 palavras, máximo 25% podem exceder)
   • Parágrafos de 2 a 4 frases
   • Palavras de transição em 30-70% das frases (não dos parágrafos)
   • Voz ativa privilegiada
   • Variação dos inícios de frases
4. SEO:
   • Palavra-chave foco no H1, primeiro parágrafo, e em pelo menos um H2
   • SEO Title (50-60 car.) e Meta Description (155-160 car.)
5. Estilo: Tom factual, técnico mas acessível, estilo premium (Samsung/Apple)
6. Exatidão: TODOS os dados técnicos devem corresponder exatamente às especificações

---

🛠 FERRAMENTAS DE VALIDAÇÃO RÁPIDA

Ponto de verificação	Ferramenta / Método	Objetivo
Comprimento	wc -w ou contador online	> 450 palavras
Frases >20 palavras	audit_aioseo_sentences.py	≤ 25%
Voz Passiva	Analisador de texto	< 10%
Transição/frase	audit_aioseo_sentences.py	30-70%
Pontuação Flesch	Hemingway App / AIOSEO	60-70

---

📝 EXEMPLO DE ESTRUTURA OTIMIZADA

Sempre consultar os Templates.

---

🔑 GESTÃO DE PALAVRAS-CHAVE (KEYWORDS)

Em cada geração ou revisão, uma lista de palavras-chave deve ser anexada no final do documento como comentário HTML. Isso permite verificar rapidamente a densidade e a relevância sem impactar a renderização final.

Estrutura das Keywords a serem adicionadas:

1. Focus Keyword: A palavra-chave principal visada.
2. LSI Keywords (Latent Semantic Indexing): 5 a 8 termos semanticamente próximos (ex: características técnicas, sinônimos).

Consulte esta lista durante a integração no WordPress para preencher os campos correspondentes do AIOSEO.