Cism-Ch/aioseo-verification

Guía de Verificación AIOSEO y Generación de Contenido

Esta guía define los estándares de redacción para fichas de producto WordPress, alineados con los algoritmos TruSEO de AIOSEO y los principios de conversión Big Tech.

---

📋 LISTA DE VERIFICACIÓN AIOSEO (TruSEO)

1. Análisis del Título y Meta

• Longitud del SEO Title: Entre 50 y 60 caracteres. La palabra clave principal debe estar al inicio.
• Longitud de la Meta Description: Entre 155 y 160 caracteres. Debe incluir la USP (Unique Selling Proposition) y un llamado a la acción (CTA).

2. Estructura del Contenido (Seguir las Plantillas)

• Longitud del Contenido: Mínimo 500 palabras (texto visible) para una descripción larga (margen de seguridad de producción, umbral estricto de 450).
• Distribución de Subtítulos: Un título (H2) por cada bloque.
• Etiquetas de Descripción Corta: Debe incluir una conclusión en cursiva mediante la etiqueta <em>.
• Higiene HTML: No usar <div> ni estilos CSS personalizados en las descripciones cortas (SEO WordPress).
• Enlaces Internos: Al menos 1 enlace a un accesorio o categoría padre.
• Enlaces Externos: Al menos 1 enlace a una fuente de autoridad (ej. ficha del fabricante) o una prueba independiente.
• Imágenes/Videos: Presencia de medios con atributos alt descriptivos que incluyan la palabra clave.

3. Legibilidad (Factores TruSEO)

• Conteo de Palabras por Párrafo (CRÍTICO — BLOQUEANTE):
  • Nota de cálculo: Contar únicamente el texto visible (etiquetas HTML eliminadas). El script validate_html_template.py es la autoridad para el cálculo del número de palabras. Alternativamente, el Agente realiza este conteo durante su auto-auditoría.
  • Párrafo introductorio: ≤ 100 palabras (presentación factual del producto)
  • Todos los demás párrafos: ≤ 60 palabras por párrafo (flexible 45-60 según la longitud de la tabla de especificaciones)
  • Sección "Ficha técnica resumida": El H2 + tabla añade aproximadamente 50-60 palabras al total
  • Descripción larga total: 500-650 palabras (Apuntar a 500 palabras mínimo de seguridad — ESTRICTO — Prohibido bajar de 450 o superar 650)
  • Verificación del cálculo: Contar TODAS las palabras visibles, incluyendo H2 "Ficha técnica" y contenido de la tabla (sin etiquetas)
• Longitud de Párrafos: Ningún párrafo debe superar las 60 palabras (introductorio máximo 100). Ajustar según tabla.
• Longitud de Frases (CRÍTICO — BLOQUEANTE): Máximo 25% de las frases pueden superar las 20 palabras (objetivo: ≤20%). Privilegiar frases de 12-18 palabras. La IA Redactora divide sistemáticamente cualquier frase que alcance las 18 palabras con un punto.
• Estructura de la Frase (Vigilancia): Las descripciones técnicas complejas deben dividirse en dos frases distintas en lugar de usar comas excesivas.
• Voz Pasiva: Máximo 10% de frases en voz pasiva. Privilegiar la voz activa (ej.: "El procesador impulsa" en lugar de "Las actuaciones son impulsadas por").
• Palabras de Transición (por FRASE, no por párrafo): Al menos 30% de las frases deben contener una palabra de transición (zona óptima 30-70%). AIOSEO busca las transiciones en cualquier lugar de la frase, no solo al inicio. Limitar las transiciones al inicio del párrafo a un máximo de 4 de 7 para evitar un estilo demasiado pesado. Validado por audit_aioseo_sentences.py.
• Frases Consecutivas: Nunca comenzar 3 frases consecutivas con la misma palabra.
• Facilidad de Lectura Flesch: Puntuación objetivo entre 60 y 70 (Legibilidad "Estándar").

4. Calidad Gramatical y Tono (CRÍTICO)

• Gramática Estándar: Usar ÚNICAMENTE el español estándar correcto. No usar construcciones enrevesadas, sintaxis artificial o tono "robótico".
• Artículos y Determinantes: Usar siempre los artículos correctos (el, la, los, las, un, una, unos, unas) delante de los nombres para producir frases gramaticalmente correctas.
• Fluidez Nativa: El texto debe leerse de forma natural. Evitar repeticiones de estructuras de frases (ej.: "Dispone de... Posee... Está equipado con...").
• Sin Verborrea: Evitar frases demasiado descriptivas o lenguaje florido. Privilegiar la claridad y concisión.
• Tono Factual: Escribir en un tono directo y factual, inspirado en las fichas técnicas profesionales (estilo Samsung/Apple).
• Sin Adjetivos Excesivos: Limitar los superlativos y adjetivos enfáticos ("increíble", "revolucionario"). Preferir hechos medibles.
• Corrección Ortográfica: Verificar la ortografía de todas las palabras, especialmente términos técnicos y nombres de marca.
• Coherencia Temporal: Usar el presente de indicativo de manera coherente para describir las características del producto.

---

🔝 LISTA DE PALABRAS DE TRANSICIÓN (PARA TRUSEO)

Usa estos términos de manera variada para mantener la tasa del 30-70% por frase (no por párrafo). AIOSEO busca estas palabras en cualquier lugar de la frase:

• Adición: Además, Asimismo, Igualmente, También, Del mismo modo, y, Así como.
• Contraste / Oposición: Sin embargo, No obstante, A pesar de, En cambio, Por el contrario, Mientras que, Aunque.
• Causa / Justificación: En efecto, Porque, Ya que, Puesto que, Dado que, Gracias a.
• Consecuencia / Conclusión: Por lo tanto, Así que, Por consiguiente, En consecuencia, En resumen, En conclusión, En definitiva, Finalmente.
• Tiempo / Orden: Primero, Luego, Después, A continuación, En primer lugar, En segundo lugar, Por último, Para terminar.
• Ilustración: Por ejemplo, En particular, Especialmente, Concretamente, Como.
• Alternativa: Ya sea... o, Bien... bien, o... o.

---

🤖 DIRECTRICES DE GENERACIÓN (Framework AIOSEO - Professional Copywriting)

ENFOQUE: REDACCIÓN PROFESIONAL TÉCNICA

El sistema debe funcionar como un redactor profesional que escribe contenido variado y natural basado en las especificaciones técnicas reales.

Metodología de Redacción Profesional

✅ EJEMPLO DE ENFOQUE CORRECTO - Redacción Natural:

Especificaciones: {"procesador": "MediaTek Helio G99", "batería": "5500 mAh", "pantalla": "AMOLED 120Hz"}
Redacción: "El Redmi Note 14 4G incorpora el procesador MediaTek Helio G99 fabricado en 6 nm,
ofreciendo un rendimiento equilibrado para multitarea y juegos ligeros. Su batería
de 5500 mAh garantiza una autonomía de más de 12 horas en uso intensivo. La pantalla
AMOLED de 6.67 pulgadas con refresco de 120 Hz hace que cada interacción sea fluida."

❌ ENFOQUE INCORRECTO - Sustitución Rígida:

Plantilla rígida: "El [PROCESADOR] ofrece [CALIFICATIVO]."
Resultado: Texto repetitivo y poco natural

Instrucciones para el Agente IA

LÍMITES ESTRICTOS DE CONTEO DE PALABRAS A CUMPLIR SIEMPRE:

• Nota: El cálculo se realiza sobre el texto visible únicamente (etiquetas HTML excluidas).
• Párrafo introductorio: MÁXIMO 100 palabras
• Todos los demás párrafos: MÁXIMO 60 palabras por párrafo
• Descripción larga total: 500-650 palabras (objetivo de seguridad para la generación; el validador acepta el pack desde 450 palabras por razones de compatibilidad, pero apuntar a 500 palabras evita cualquier rechazo).
• A validar ANTES de la creación del archivo - Fallar el checkpoint si se supera

Durante la Fase 2 (LARGA) y Fase 3 (CORTA):

1. Analizar las Especificaciones

   • Leer el archivo specs-[variante].html completamente
   • Identificar las características clave y diferenciadoras
   • Anotar los datos técnicos exactos (capacidades, modelos, tecnologías)
   • Las especificaciones deben coincidir y ser reales

2. Redactar de Forma Natural

   • Escribir como un redactor técnico profesional
   • Variar las estructuras de las frases
   • Usar las palabras de transición de manera natural
   • Explicar las especificaciones técnicas de forma accesible
   • Conectar las características técnicas con los beneficios reales

3. Estándares de Calidad

   • Gramática: Español estándar impecable
   • Tono: Factual, profesional, estilo Samsung/Apple
   • Precisión: Todos los datos técnicos deben coincidir exactamente con las especificaciones
   • Claridad: Frases cortas (≤20 palabras, división sistemática a 18 palabras), párrafos concisos
   • Naturalidad: El texto debe leerse con fluidez, no como un formulario rellenado

4. Qué HACER

   • ✅ Variar los inicios de las frases
   • ✅ Usar sinónimos apropiados
   • ✅ Crear transiciones fluidas entre las secciones
   • ✅ Explicar los términos técnicos cuando sea necesario
   • ✅ Mantener un tono coherente y profesional
   • ✅ Usar adjetivos útiles y precisos

5. Qué EVITAR

   • ❌ Inventar especificaciones o aproximar cifras
   • ❌ Usar lenguaje marketing excesivo o superlativos injustificados
   • ❌ Repetir las mismas estructuras de frases
   • ❌ Escribir de manera verbosa o compleja
   • ❌ Usar un tono artificial o robótico
   • ❌ No abusar de los adjetivos para no sobrecargar innecesariamente el texto

Restricciones de Redacción (ESTRICTAS):

1. Longitud: 500-650 palabras para LARGA (objetivo de seguridad), <60 palabras teaser para CORTA
2. Estructura HTML: Seguir la estructura de la plantilla (H1, H2, párrafos, listas)
3. Legibilidad TruSEO:
   • Frases cortas (≤20 palabras, máximo 25% pueden superarlo)
   • Párrafos de 2-4 frases
   • Palabras de transición en 30-70% de las frases (no de los párrafos)
   • Voz activa privilegiada
   • Variación de inicios de frases
4. SEO:
   • Palabra clave de enfoque en H1, primer párrafo y al menos un H2
   • SEO Title (50-60 caracteres) y Meta Description (155-160 caracteres)
5. Estilo: Tono factual, técnico pero accesible, estilo premium (Samsung/Apple)
6. Exactitud: TODOS los datos técnicos deben coincidir exactamente con las especificaciones

---

🛠 HERRAMIENTAS DE VALIDACIÓN RÁPIDA

Punto de control	Herramienta / Método	Objetivo
Longitud	wc -w o contador en línea	> 450 palabras
Frases >20 palabras	audit_aioseo_sentences.py	≤ 25%
Voz Pasiva	Analizador de texto	< 10%
Transición/frase	audit_aioseo_sentences.py	30-70%
Puntuación Flesch	Hemingway App / AIOSEO	60-70

---

📝 EJEMPLO DE ESTRUCTURA OPTIMIZADA

Referirse siempre a las Plantillas.

🔑 GESTIÓN DE PALABRAS CLAVE (KEYWORDS)

Durante cada generación o revisión, se debe adjuntar una lista de palabras clave al final del documento como comentario HTML. Esto permite verificar rápidamente la densidad y relevancia sin afectar la visualización final.

Estructura de las Keywords a añadir:

1. Focus Keyword: La palabra clave principal objetivo.
2. LSI Keywords (Latent Semantic Indexing): 5 a 8 términos semánticamente cercanos (ej.: características técnicas, sinónimos).

Consulte esta lista durante la integración en WordPress para rellenar los campos correspondientes de AIOSEO.