Manual de Usuario, Documentación Técnica & Laboratorio

01. ¿Qué es Baloa Structure Auditor SEO?

Baloa Structure Auditor SEO es un sistema integral de auditoría técnica que evalúa la salud estructural, semántica y citabilidad de las páginas web en WordPress.

A diferencia de las herramientas SEO tradicionales que se limitan a contar palabras clave en un texto o forzar meta campos estáticos, Baloa analiza la arquitectura del Document Object Model (DOM), la sintaxis de datos estructurados Schema.org JSON-LD, el cumplimiento de directrices para motores de búsqueda tradicionales (Google, Bing) y, de forma pionera, la capacidad de comprensión y citabilidad por parte de los nuevos motores de Inteligencia Artificial (Answer Engine Optimization / Generative Engine Optimization - AEO/GEO), tales como ChatGPT, Perplexity, Claude y Google Gemini.

¿Qué problema resuelve?

• Diagnostica y previene deficiencias de estructura: Detecta encabezados ausentes o desordenados (H1 múltiple, saltos de nivel H2 a H4), enlaces rotos, imágenes sin atributo alternativo accesible y metadatos incompletos.
• Evalúa señales de citabilidad y estructura para IA: Evalúa si tus textos están estructurados en fragmentos sintetizables (chunkability), si cuentas con archivos de contexto como llms.txt (especificación emergente para LLMs), si tus datos corporativos son consistentes y si tus esquemas JSON-LD están limpios de errores sintácticos.
• Agiliza los tiempos de resolución: Proporciona soluciones asistidas en 1-clic (Auto-Fix) para los problemas que admiten corrección automática y guías paso a paso ilustradas para los que requieren cambios directos en el editor o plantilla.

02. Acceso y Ubicación en el Panel de WordPress

Una vez instalado y activado el plugin en WordPress, no tendrás que navegar por menús ocultos ni configuraciones complejas.

Ubicación de Baloa en el menú de administración de WordPress

¿Dónde estoy?

En la barra lateral izquierda del panel de administración de WordPress (wp-admin).

¿Qué estoy viendo?

El menú principal de Baloa SEO destacado con el icono de lupa (dashicons-search). Al hacer clic o pasar el cursor, se despliegan tres accesos directos:

1. SEO Auditor (admin.php?page=baloa-structure-auditor-seo): El espacio de trabajo unificado donde se ejecutan los análisis, se revisan los resultados y se resuelven los problemas.
2. Glosario (admin.php?page=baloa-glossary): Base enciclopédica con definiciones oficiales, estándares W3C/Schema.org y directrices de buenas prácticas.
3. Control de Cambios (admin.php?page=baloa-reversion — Baloa PRO): Registro de auditoría (Audit Ledger) donde puedes inspeccionar o revertir cualquier mejora aplicada automáticamente.

¿Qué debo hacer ahora?

Haz clic en Baloa SEO o en SEO Auditor. Accederás inmediatamente a la interfaz principal del auditor.

03. Tu Primer Análisis Paso a Paso

Al entrar en el plugin, verás la barra superior lista para iniciar la auditoría.

Panel superior para ingresar la URL a analizar

Procedimiento operativo:

Paso 1 — Localizar el campo de URL

En la barra superior (Topbar), encontrarás un campo de texto con el marcador de posición https://tudominio.com/slug/.

Paso 2 — Introducir la URL a auditar

• ¿Qué URL debes escribir? Introduce la URL pública y completa de la entrada, página corporativa o producto que deseas evaluar (por ejemplo: https://wordpress.org o cualquier URL de tu sitio).
• Regla de seguridad (SSRF): La URL debe ser accesible vía HTTP/HTTPS público. Por seguridad, el sistema bloquea peticiones dirigidas a IPs privadas o loopback locales (127.0.0.1, localhost).

Paso 3 — Iniciar la auditoría

Haz clic en el botón azul Analizar.

Paso 4 — Observar el escaneo modular interactivo

En milisegundos se desplegará el Modal de Escaneo Modular Corporativo:

Modal de progreso del escaneo modular de Baloa

¿Qué estoy viendo en el modal de escaneo?

• Barra de Progreso y Porcentaje: El indicador numérico (0% a 100%) avanza en tiempo real conforme concluye cada evaluación.
• Contador de Módulos: Muestra la relación de módulos completados (ejemplo: 6 / 10 módulos).
• Lista de Módulos en Tiempo Real: Cada pilar muestra su estado:

- Espera (punto gris): En cola de procesamiento.

- Evaluando (spinner giratorio): Inspeccionando las reglas del DOM y metadatos.

- ✓ [Puntuación] (check verde): Módulo finalizado con éxito mostrando su calificación parcial (ej. ✓ 67, ✓ 100).

- Diferido (icono de retorno): Si una comprobación externa experimenta latencia de red, Baloa la traslada a segundo plano para no bloquear la experiencia del usuario.

• Pie del Modal: Recordatorio de resiliencia: “Tolerancia a fallos: módulos con demora se procesan en diferido sin detener el escaneo.”

Paso 5 — Cierre y carga automática de resultados

Al alcanzar el 100%, el modal se cierra con una suave animación y la vista se actualiza automáticamente en el Resumen general.

04. Anatomía del Dashboard y Hero Principal

Una vez concluido el análisis, te encuentras en la vista Resumen (activeModule === 'resumen').

Vista anotada del Hero principal del Dashboard con llamadas de referencia

(Versión limpia sin anotaciones:)

Vista del Hero principal del Dashboard

Desglose de Elementos Anotados:

• [1] Puntuación Global Hexagonal (62 / 100) y Badge de Estado (Bueno): Indicador central ponderado que resume la calidad técnica y semántica de toda la página evaluada. (Nota: Las métricas numéricas mostradas en las capturas —score 62, 38 problemas, etc.— corresponden a la auditoría específica realizada durante esa sesión de prueba y sirven únicamente como referencia visual ilustrativa).
• [2] Diagnóstico Rápido de AI Readiness: Texto editorial que interpreta la capacidad del contenido para ser extraído por modelos de lenguaje:

“Tienes una buena base, pero existen optimizaciones clave que limitan cómo los sistemas de IA comprenden y citan tu contenido.”

• [3] Botón de Acción Directa (Ver 38 problemas encontrados →): Acceso directo con un solo clic al workspace de resolución de problemas.
• [4] Tres Tarjetas de Impacto en Columna Derecha:

- Problemas críticos (! 3 Críticos): Defectos estructurales o de marcado que requieren atención prioritaria.

- Advertencias (▲ 34 Advertencias): Oportunidades de mejora importantes en semántica y metadatos.

- Áreas auditadas (✓ 72 Áreas auditadas): Total de comprobaciones técnicas superadas con éxito.

• [5] Sub-tarjeta de Salud General del Sitio: Visualización complementaria con desglose porcentual y semáforo de estado.

05. Interpretación de la Puntuación Global y Semáforos

Interpretación Visual de la Puntuación en el Panel Global:

La interfaz principal de Baloa utiliza una escala visual de semáforos para orientar al usuario sobre el estado general del documento evaluado:

06. Las Tres Tarjetas de Impacto

Ubicadas a la derecha del Hero Card:

1. Problemas Críticos (Rojo / Icono de Alerta):

Filtra inmediatamente la lista para atender las incidencias que representan mayores impedimentos para el rastreo, la accesibilidad o la semántica del documento.

2. Advertencias (Ámbar / Icono de Advertencia):

Filtra las sugerencias que optimizan la visibilidad, consistencia y citabilidad.

3. Áreas Auditadas (Verde / Icono de Portapapeles):

Muestra el total de comprobaciones técnicas aprobadas, reflejando qué directivas cumplen satisfactoriamente las reglas auditadas.

07. Acciones Prioritarias: Mejora tu AI Readiness

Al desplazarte hacia abajo en el Resumen, encontrarás el bloque de mayor valor operacional diario:

Sección de Acciones Prioritarias en el Dashboard

¿Qué estoy viendo?

• Encabezado: Badge celeste “Acciones Prioritarias” y título “Mejora tu AI Readiness”.
• Botón “Ver todos los problemas (38) →”: Indica la cantidad total de incidencias pendientes.
• Tarjetas de Problemas Destacados: El algoritmo de Baloa selecciona automáticamente los 3 problemas con mejor ratio esfuerzo/impacto:

- Badge ✨ AutoFix Disponible: Indica que se puede solucionar automáticamente sin tocar código.

- Badge de Impacto +2 pts est.: Estimación del incremento potencial en la puntuación tras subsanar la incidencia.

- Módulo al que pertenece (ej. Citabilidad & AEO, Visibilidad IA).

- Título y resumen conciso de la acción recomendada.

08. La Cuadrícula de los 10 Módulos Principales

Debajo de las acciones prioritarias se despliega la cuadrícula con los 10 pilares técnicos auditados:

Cuadrícula con las tarjetas de los 10 módulos principales

Anatomía de cada tarjeta modular:

1. Icono Temático: Identifica la disciplina técnica (herramienta, etiqueta, enlace, imagen, código, etc.).
2. Nombre del Módulo: Ej. Estructura HTML, Meta Tags & Social, Schema & Entidades.
3. Descripción Funcional: Resumen de lo que evalúa (ej. “Jerarquía de encabezados, semántica y DOM”).
4. Badge de Puntuación Parcial: Calificación de 0 a 100 con el color del semáforo.
5. Barra de Progreso: Indicador visual proporcional al score.
6. Interactividad: Al hacer clic sobre cualquier tarjeta, accedes inmediatamente a la pantalla profunda de ese módulo.

09. Cómo Navegar por el Centro de Problemas

Haz clic en Problemas en la barra lateral izquierda o en el botón Ver problemas del Hero. Llegarás al workspace de resolución:

Workspace anotado de Resolver problemas con lista y panel de diagnóstico

(Versión limpia sin anotaciones:)

Workspace de Resolver problemas

Desglose de Elementos Anotados:

• [1] Stepper de Flujo de Resolución de 4 Pasos: Barra interactiva que guía el ciclo de vida de cada incidencia (1 Detectar, 2 Revisar, 3 Solucionar, 4 Verificar) junto al botón Reescanear.
• [2] Barra de Filtros por Severidad: Botones de alternancia rápida para segmentar incidencias (valores de la sesión de prueba capturada: Todos 38 | Críticos 4 | Advertencias 34 | ✨ AutoFix 13) junto al campo de búsqueda interactivo “Buscar problema...”.
• [3] Lista Master de Problemas Detectados: Tarjetas con el nombre de cada hallazgo, módulo de pertenencia, badge de severidad, prioridad y etiqueta de acción (AutoFix / Fix Experto).
• [4] Cabecera del Panel de Diagnóstico (Paso 2):

- Badge de paso: PASO 2: DIAGNÓSTICO.

- Título del problema seleccionado (ej. “Etiquetado semántico secundario”).

- Estimación de impacto: +1 pts est..

- Estado de la URL: 🛡️ SOLO LECTURA — URL EXTERNA (o editable localmente).

• [5] Bloques de Explicación Técnica y Previsualización:

- 🔍 Qué ocurre en tu página: Diagnóstico empírico del fallo en el DOM.

- 🤖 Por qué importa para la IA & AEO: Justificación contextual para motores y modelos de lenguaje.

- Vista previa en Google SERP: Simulación visual orientativa del resultado.

10. El Stepper Interactivo de 4 Pasos

El stepper superior representa la metodología secuencial de resolución de Baloa:

┌──────────────┐      ┌──────────────┐      ┌──────────────┐      ┌──────────────┐
            │ 1. Detectar  │ ───> │  2. Revisar  │ ───> │3. Solucionar │ ───> │ 4. Verificar │
            └──────────────┘      └──────────────┘      └──────────────┘      └──────────────┘

1. Paso 1 — Detectar: Baloa analiza el código HTML y extrae la evidencia del problema.
2. Paso 2 — Revisar: El usuario analiza el diagnóstico, comprende la causa técnica y consulta el medidor visual.
3. Paso 3 — Solucionar: Se aplica la corrección mediante Auto-Fix en 1-clic o se sigue la guía de corrección manual.
4. Paso 4 — Verificar: Se ejecuta un nuevo análisis para verificar si la condición fue resuelta; si la comprobación es satisfactoria, la tarjeta se retira de la lista activa y la puntuación se recalcula según el nuevo estado auditado.

11. Cómo Leer un Problema (Paso 2: Diagnóstico Detallado)

Al hacer clic en cualquier problema de la lista izquierda, la columna derecha se transforma en la ficha de diagnóstico:

Ficha de diagnóstico de un problema con medidor visual y bloques de explicación

Elementos visuales clave:

1. Medidor Gauge de Puntuación: Visualiza la puntuación actual frente a la potencial tras resolver la incidencia.
2. Página Afectada: Enlace que indica la ruta exacta del documento donde se detectó el fallo.
3. Diagnóstico Contextual: Explica sin tecnicismos innecesarios qué elemento HTML o atributo está ausente o mal formulado.
4. Botón de Transición: Botón destacado Pasar a Solucionar (Paso 3) → para avanzar hacia la resolución.

12. Medidores Visuales y Simuladores Contextuales

Dependiendo del tipo de problema seleccionado, Baloa renderiza componentes visuales dedicados:

• Medidor Dinámico de Longitud: Para títulos y descripciones, muestra una barra con zonas verde, amarilla y roja según el conteo de caracteres.
• Simulador SERP de Google: Previsualiza una aproximación visual de cómo se mostraría el fragmento en móvil y escritorio.
• Simulador de Fragmentos AEO: Muestra cómo los asistentes de IA podrían sintetizar el bloque de texto relevante.

13. Auto-Fix: Corrección Asistida en 1-Clic (Baloa PRO)

Al hacer clic en Pasar a Solucionar (Paso 3), si el problema es automatizable, se muestra la pantalla de ejecución:

Panel anotado de Solucionar en el Paso 3 con llamadas de referencia

(Versión limpia sin anotaciones:)

Panel de ejecución de Auto-Fix en el Paso 3

Desglose de Elementos Anotados:

• [1] Badge de Paso y Severidad: PASO 3: SOLUCIONAR y badge de nivel (ADVERTENCIA o CRÍTICO).
• [2] Métricas de Impacto:

- SEO Impacto: Medio / Alto.

- AI Readiness: Baja / Media / Alta.

- Tiempo est.: ⏱ 5m (o 1m con Auto-Fix).

• [3] Acción Recomendada: Síntesis clara de la modificación técnica que se debe aplicar.
• [4] Contenedor de Ejecución / Guía Paso a Paso:

- Si la URL pertenece al WordPress local: Muestra el botón ✨ Aplicar AutoFix ahora.

- Si la URL es externa: Muestra el aviso de seguridad:

“AutoFix no puede modificar esta URL por seguridad. Baloa solo puede aplicar cambios en el WordPress donde está instalado.”

- Si una suite SEO externa está activa (Yoast, Rank Math, SEOPress, etc.): AutoFix delega los metadatos a dicha suite para evitar duplicidades.

- Botón 📖 Cargar Guía de Solución Paso a Paso para ver instrucciones detalladas.

- Botón ↗ Abrir en WordPress para ir directamente al editor nativo.

• [5] Botones de Navegación del Flujo:

- ← Volver al Diagnóstico (Paso 2)

- ✓ Verificar corrección (Paso 4) →

- Siguiente problema →

¿Cómo funciona Auto-Fix internamente?

Auto-Fix NO modifica de forma destructiva tus archivos PHP ni el código fuente del tema activo. Opera mediante filtros en tiempo de ejecución de WordPress (runtime hooks):

• Intercepta hooks nativos estándar como wp_head, the_content o robots_txt.
• Inyecta la metaetiqueta requerida, ajusta atributos en el flujo de salida o genera esquemas JSON-LD.
• Registra la acción en el sistema (Audit Ledger gestionado en wp_options y metadatos del post), permitiendo revertir la modificación en cualquier momento con un solo clic.

14. Fix Manual: Modificación Directa sin Errores de Software

Panel de solución para problemas que requieren intervención manual con guía paso a paso

Procedimiento para resolver un Fix Manual:

1. En el Paso 3, haz clic en 📖 Cargar Guía de Solución Paso a Paso.
2. Lee el plan estructurado de 3 pasos:

- Paso 1 (Localizar): Abre la entrada o página correspondiente en el editor de WordPress (Gutenberg) o los ajustes de tu tema.

- Paso 2 (Implementar): Aplica la modificación indicada en el contenido (ej. ajustar la jerarquía de encabezados H2/H3, añadir el texto alternativo ALT a una imagen o actualizar la meta descripción o extracto).

- Paso 3 (Validar): Guarda los cambios en WordPress y pulsa en Verificar.

3. Haz clic en ↗ Abrir en WordPress para saltar directamente a la pantalla de edición de la entrada.

15. Verificación y Cierre de Problemas (Paso 4)

Una vez aplicada la corrección (vía Auto-Fix o manualmente en el editor):

1. Haz clic en el botón verde: ✓ Verificar corrección (Paso 4) → (o pulsa Reescanear en la barra superior).
2. Baloa re-analiza el HTML público de la página en tiempo real.
3. Si el problema ha sido resuelto:

- La tarjeta desaparece automáticamente de la lista de pendientes.

- El contador de problemas disminuye y aumenta el de Áreas auditadas.

- La puntuación del módulo y la Puntuación Global se recalculan reflejando la mejora si la verificación confirma la corrección.

4. Pulsa en Siguiente problema → para continuar con la optimización.

---

16. Módulo 1: Estructura HTML (html)

Pantalla completa del módulo de Estructura HTML

Hero card del módulo de Estructura HTML

Desglose del Hero del Módulo (Valores Reales Verificados):

Indicadores evaluados por el módulo:

• H1 Único: Valida que exista exactamente una etiqueta <h1> representativa del tema central de la página (Verde = 1 H1; Rojo = 0 o más de 1).
• Saltos de Nivel: Detecta discontinuidades en la jerarquía (ej. pasar de <h2> a <h4> sin un <h3> intermedio).
• Etiquetado Semántico: Comprueba el uso de etiquetas estructurales HTML5 (<main>, <header>, <footer>, <nav>, <article>, <aside>).
• Profundidad del DOM: Alerta si la anidación de contenedores (<div>) supera los 32 niveles, lo que degrada el rendimiento de renderizado.

¿Dónde puedo encontrar este elemento?

• En el Editor de WordPress (Gutenberg):

Abre la entrada o página, haz clic en el icono de Vista de Esquema (las tres líneas escalonadas en la barra superior izquierda). Verás el árbol jerárquico de títulos; asegúrate de que el título principal sea H1 y los subtítulos sigan un orden numérico estricto (H2, H3).

• En la Página Pública:

Es la estructura visible de títulos, subtítulos y bloques que organizan el texto para los lectores.

• En el Código HTML (Inspector F12):

Presiona F12 en el navegador, abre la pestaña Elementos (Elements) y usa Ctrl + F para buscar <h1, <h2 o <main.

17. Módulo 2: Meta Tags & Social (metatags)

Pantalla completa del módulo de Meta Tags & Social

Hero card del módulo de Meta Tags & Social

Desglose del Hero del Módulo (Valores Reales Verificados):

Indicadores evaluados por el módulo:

• Longitud del Meta Title: Heurística orientativa recomendada entre 50 y 60 caracteres (el analizador evalúa un rango funcional de 30 a 60 caracteres para evitar títulos truncados o insuficientes; Google evalúa el espacio en píxeles y no exige un recuento exacto de caracteres).
• Longitud de Meta Description: Heurística práctica recomendada entre 120 y 155 caracteres (el analizador evalúa de 70 a 155 caracteres para optimizar su despliegue en los fragmentos de búsqueda).
• URL Canónica (canonical): Presencia de la etiqueta <link rel="canonical">.
• Open Graph (Facebook/LinkedIn): Etiquetas og:title, og:description, og:image y og:url.
• Twitter Cards: Etiquetas twitter:card, twitter:title e imagen asociada.

¿Dónde puedo encontrar este elemento?

• En el Editor de WordPress:

En la barra lateral derecha de ajustes del documento de Gutenberg, en la sección Extracto (Excerpt) para la descripción, o en los metaboxes de tu plugin SEO activo (Yoast, Rank Math o SEOPress).

• En la Página Pública:

No es visible en el cuerpo del texto; es el título que aparece en la pestaña del navegador y la tarjeta que se genera al compartir el enlace en WhatsApp o redes sociales.

• En el Código HTML (Inspector F12):

Abre el inspector (F12), despliega la etiqueta <head> en la parte superior del código y busca <title> y <meta name="description">.

18. Módulo 3: Enlaces Internos y Salientes (links)

Pantalla completa del módulo de Enlaces

Hero card del módulo de Enlaces

Desglose del Hero del Módulo (Valores Reales Verificados):

Indicadores evaluados por el módulo:

• Enlaces Rotos (404): Detección de hipervínculos que apuntan a páginas caídas.
• Ratio Interno / Externo: Proporción de enlaces que distribuyen autoridad dentro del propio dominio frente a enlaces salientes.
• Textos Ancla Genéricos: Alertas sobre anclas poco descriptivas como “haz clic aquí” o “leer más”.
• Seguridad de Enlaces Salientes: Uso de rel="noopener noreferrer" en enlaces que abren en nueva pestaña (target="_blank").

¿Dónde puedo encontrar este elemento?

• En el Editor de WordPress:

Selecciona cualquier texto con hipervínculo en Gutenberg y haz clic en el icono de enlace para editar la URL, activar la apertura en nueva pestaña o marcarlo como nofollow.

• En la Página Pública:

Todos los enlaces subrayados o con color distintivo a lo largo del contenido.

• En el Código HTML (Inspector F12):

Busca etiquetas <a href="..."> e inspecciona sus atributos href, rel y target.

19. Módulo 4: Imágenes y Atributos Alt (images)

Pantalla completa del módulo de Imágenes

Hero card del módulo de Imágenes

Desglose del Hero del Módulo (Valores Reales Verificados):

Indicadores evaluados por el módulo:

• Texto Alternativo (alt): Necesario en imágenes informativas para transmitir su significado a tecnologías de asistencia y motores de búsqueda. Las imágenes meramente decorativas pueden utilizar de forma válida un atributo alt="" vacío para ser omitidas por lectores de pantalla. Baloa detecta etiquetas <img> sin atributo alt y textos alternativos vacíos o mejorables; en Baloa PRO, AutoFix asiste completando el atributo únicamente cuando este se encuentra ausente.
• Dimensiones Explícitas: Presencia de atributos width y height para reducir cambios inesperados de diseño (CLS).
• Carga Diferida (loading="lazy"): Comprueba que las imágenes fuera de la pantalla inicial apliquen carga diferida para favorecer el rendimiento inicial.
• Formatos de Nueva Generación: Detección de formatos WebP o AVIF frente a JPEG/PNG pesados.

¿Dónde puedo encontrar este elemento?

• En el Editor de WordPress:

Haz clic en cualquier bloque de Imagen en Gutenberg y mira el panel lateral derecho: en el campo Texto alternativo (alt) escribe una descripción precisa de lo que muestra la imagen. También puedes definirlo globalmente en Medios → Biblioteca.

• En la Página Pública:

Cualquier imagen, fotografía, infografía o logotipo insertado en el contenido.

• En el Código HTML (Inspector F12):

Busca <img e inspecciona los atributos alt="...", width="...", height="..." y loading="lazy".

20. Módulo 5: Schema Markup y JSON-LD (schema)

Pantalla completa del módulo de Schema & Entidades

Hero card del módulo de Schema & Entidades

Desglose del Hero del Módulo (Valores Reales Verificados):

Indicadores evaluados por el módulo:

• Presencia de JSON-LD: Detección de bloques <script type="application/ld+json">.
• Validación de Sintaxis: Comprobación de que el JSON no tenga comas sobrantes ni caracteres no escapados.
• Tipos de Esquema Relevantes: Reconocimiento de entidades (Organization, Article, BreadcrumbList, FAQPage, Product).
• Grafo Semántico Unificado: Integración mediante @graph para conectar la autoría, el sitio y el contenido.
• Entidades Semánticas y Nicho: Representación del mapa radial de autoridad temática que contrasta las entidades presentes frente a las esperadas para el nicho detectado.

¿Dónde puedo encontrar este elemento?

• En el Editor de WordPress:

Se gestiona de forma nativa a través de temas modernos compatibles o mediante plugins de SEO (sección Datos Estructurados / Schema).

• En la Página Pública:

Es invisible a simple vista para el usuario humano; los datos estructurados proporcionan información explícita que puede ser interpretada por buscadores, herramientas de análisis y sistemas que procesan especificaciones de Schema.org.

• En el Código HTML (Inspector F12):

Abre el inspector (F12), pulsa Ctrl + F y busca application/ld+json. Verás el bloque de código estructurado.

21. Módulo 6: Legibilidad y Análisis de Contenido (readability)

Pantalla completa del módulo de Legibilidad & UX

Hero card del módulo de Legibilidad & UX

Desglose del Hero del Módulo (Valores Reales Verificados):

Indicadores evaluados por el módulo:

• Índice de Facilidad de Lectura: Flesch Reading Ease adaptado a español (Flesch-Szigriszt).
• Longitud de Párrafos: Alerta cuando los párrafos superan las 150 palabras sin descansos visuales.
• Longitud Media de Oraciones: Recomienda mantener oraciones por debajo de 20-25 palabras.
• Uso de Listas y Negritas: Evalúa la presencia de viñetas y resaltados para facilitar la lectura diagonal (skimming).

¿Dónde puedo encontrar este elemento?

• En el Editor de WordPress:

Es el propio texto de los bloques de Párrafo y Lista en Gutenberg.

• En la Página Pública:

Es el contenido textual visible que consumen tus lectores.

• En el Código HTML (Inspector F12):

Etiquetas <p>, <ul>, <ol> y <strong>.

22. Módulo 7: Citabilidad y AEO (aeo)

Pantalla completa del módulo de Citabilidad & AEO

Hero card del módulo de Citabilidad & AEO

Desglose del Hero del Módulo (Valores Reales Verificados):

Indicadores evaluados por el módulo:

• Definiciones Directas: Presencia de respuestas concisas (30-40 palabras) inmediatamente debajo de subtítulos en forma de pregunta.
• Fragmentabilidad (Chunkability): Contenido dividido en secciones lógicas independientes fáciles de procesar por un LLM.
• Bloques FAQ estructurados: Preguntas y respuestas con marcado Schema o listas de definición.
• Densidad de Hechos y Datos: Inclusión de cifras, porcentajes y fuentes que favorecen la extracción y citación de datos por sistemas de respuesta.

¿Dónde puedo encontrar este elemento?

• En el Editor de WordPress:

Redacta bloques de encabezado en forma de pregunta (ej. ## ¿Cómo funciona el Auto-Fix?) seguidos inmediatamente de un párrafo con la respuesta directa antes de profundizar en los detalles.

• En la Página Pública:

Secciones de preguntas frecuentes, tablas comparativas y resúmenes ejecutivos.

• En el Código HTML (Inspector F12):

Encabezados <h2>/<h3> seguidos de párrafos con oraciones declarativas concisas.

23. Módulo 8: Preparación para LLMs y llms.txt (llms)

Pantalla completa del módulo de Visibilidad IA y LLMs.txt

Desglose del Hero del Módulo (Valores Reales Verificados):

Indicadores evaluados por el módulo:

• Presencia de /llms.txt y /llms-full.txt: Comprueba la disponibilidad del manifiesto en formato Markdown (especificación comunitaria emergente para orientar a rastreadores de IA sobre el mapa de contenidos del sitio).
• Directivas en robots.txt para Agentes de IA: Comprobación de que no se esté bloqueando inadvertidamente a rastreadores como GPTBot, ClaudeBot o PerplexityBot mediante reglas restrictivas globales (Disallow: /).
• Marcado Semántico Secundario: Presencia de etiquetas que delimitan el contenido real frente a barras laterales y menús.

¿Dónde puedo encontrar este elemento?

• En WordPress / Servidor:

En la raíz de tu dominio público: accesible vía https://tudominio.com/llms.txt y https://tudominio.com/robots.txt. Con Baloa PRO, estas respuestas se sirven dinámicamente mediante el hook nativo init de WordPress, sin requerir la creación de archivos estáticos físicos en el servidor.

• En el Código HTML (Inspector F12):

Etiquetas semánticas <article>, <section> y directivas meta robots.

24. Módulo 9: Confianza y E-E-A-T (eeat)

Pantalla completa del módulo de Confianza & E-E-A-T

Desglose del Hero del Módulo (Valores Reales Verificados):

Indicadores evaluados por el módulo:

• Identificación del Autor: Nombre del autor visible y enlazado a su biografía o perfil profesional.
• Fechas de Publicación y Modificación: Etiquetas visibles y metadatos con la última fecha de actualización.
• Páginas Institucionales Obligatorias: Enlaces en el pie de página hacia Aviso Legal, Política de Privacidad, Términos y Contacto.
• Citas y Fuentes Externas: Vínculos hacia fuentes de referencia o documentación que respalden los datos presentados.

¿Dónde puedo encontrar este elemento?

• En el Editor de WordPress:

Asigna el autor correcto en la barra lateral de Gutenberg y asegúrate de que tu tema renderice la caja de autor al final del artículo. En Menús / Pie de página, añade los enlaces a tus páginas legales.

• En la Página Pública:

Caja de autor, fecha en el encabezado del artículo y enlaces en el footer del sitio.

• En el Código HTML (Inspector F12):

Etiquetas semánticas <time datetime="...">, clases como .author-bio o .vcard, y atributos rel="author".

25. Módulo 10: Core Web Vitals y Rendimiento (cwv)

Pantalla completa del módulo de Rendimiento y Core Web Vitals

Desglose del Hero del Módulo (Valores Reales Verificados):

Indicadores evaluados por el módulo:

Métricas oficiales Core Web Vitals:

• LCP (Largest Contentful Paint): Tiempo transcurrido hasta que el elemento de contenido principal es visible (Verde < 2.5 s).
• INP (Interaction to Next Paint): Evalúa la rapidez de respuesta de la página ante interacciones del usuario (Verde < 200 ms).
• CLS (Cumulative Layout Shift): Mide la estabilidad visual y la ausencia de desplazamientos inesperados durante la carga (Verde < 0.1).

Métricas complementarias de diagnóstico y rendimiento:

• TTFB (Time to First Byte): Métrica complementaria que cuantifica el tiempo que tarda el servidor en enviar el primer byte (Verde < 800 ms; no constituye un Core Web Vital de Google, pero es una métrica técnica base de infraestructura y servidor).
• FCP (First Contentful Paint): Tiempo hasta el renderizado del primer fragmento de contenido visual.
• Recursos que Bloquean el Render: Detección de hojas de estilo o scripts en el <head> que retrasan el renderizado inicial si carecen de atributos defer o async.

¿Dónde puedo encontrar este elemento?

• En WordPress:

Plugins de optimización y caché (como LiteSpeed Cache, WP Rocket) o en los ajustes de encolado de scripts de tu tema activo.

• En la Página Pública:

La velocidad percibida al abrir la página y la ausencia de parpadeos o saltos de diseño mientras carga.

• En el Código HTML (Inspector F12):

Pestaña Red (Network) y pestaña Lighthouse en las herramientas de desarrollo de Chrome/Edge.

26. Centro de Optimización

Al hacer clic en Centro de Optimización en la barra lateral (activeModule === 'optimizar'):

Centro de Optimización de Baloa

Funcionalidades integradas:

1. Explorador Sitemap: Acceso rápido para escanear lotes completos de URLs a partir de un archivo XML.
2. Recomendaciones IA: Consultoría especializada con agentes de inteligencia artificial (BYOK).
3. Control de Cambios: Panel de auditoría, inspección y rollback de mejoras aplicadas.
4. Glosario Técnico: Base enciclopédica de consulta de estándares W3C y buenas prácticas.

27. Explorador Sitemap y Escaneo Masivo por Lotes

Pantalla del Explorador de Sitemap y análisis por lotes

Procedimiento operativo paso a paso:

1. En el campo de texto, introduce la URL del mapa del sitio (ej. https://tudominio.com/wp-sitemap.xml).
2. Haz clic en el botón 🔍 Descubrir Páginas.
3. El sistema procesará el XML y listará todas las URLs detectadas con casillas de selección individual y casilla maestra.
4. Selecciona las páginas deseadas y pulsa en ⚡ Iniciar Análisis Masivo.
5. Baloa auditará secuencialmente cada página en segundo plano, indicando el score obtenido y los problemas detectados en cada una.
6. Permite descargar los resultados consolidados del lote en formato CSV mediante el botón Exportar Resultados (CSV), así como generar informes de auditoría técnica en formato imprimible o PDF para páginas individuales desde el motor de reportes.

28. Recomendaciones del Grupo de Expertos IA (Modelo BYOK)

Panel de recomendaciones con el Grupo de Expertos IA

¿Qué es el modelo BYOK (Bring Your Own Key)?

Baloa protege la soberanía de tus datos: no envía tu información a servidores intermediarios ni almacena tus claves de API de forma remota. Puedes configurar directamente tus credenciales oficiales según los proveedores compatibles integrados en Baloa PRO:

• OpenAI: Integración para modelos de la familia GPT-4o.
• Anthropic: Integración para la familia Claude (Claude 3.5 Sonnet).
• Google Gemini: Integración para modelos Gemini (Gemini 1.5 Pro).

Perfiles de expertos especializados:

• 🎨 Consultor UI-UX: Análisis de diseño visual, contraste y ritmo de lectura.
• 📈 Especialista SEO-GEO-AEO: Recomendaciones estratégicas sobre estructura, marcado y citabilidad ante motores de búsqueda y modelos generativos.
• ⚙️ WP Architect: Buenas prácticas de código, funciones PHP y optimización para WordPress.

29. Control de Cambios y Reversión (Audit Ledger)

Panel de Control de Cambios y Reversión de Mejoras

¿Qué estoy viendo?

• Tarjetas de Estado: Conteo de páginas con metadatos inyectados, anulaciones globales activas y correcciones estructurales.
• Tabla de Auditoría (Ledger): Registro cronológico pormenorizado de cada Auto-Fix ejecutado (fecha, tipo de optimización, valor inyectado y URL afectada).
• Acciones de Reversión Segura:

- Botón Revertir (Individual): Deshace una optimización específica en esa página sin alterar el resto.

- Botón Purgar Todo (Global): Elimina todas las modificaciones, reglas y metadatos gestionados por Baloa registrados en el sistema, restableciendo la configuración del plugin de forma limpia sin alterar datos de otros plugins ni el contenido nativo de WordPress.

30. Glosario Técnico Integrado

Glosario Técnico de Baloa

Características de la base de conocimiento:

• Decenas de conceptos técnicos ordenados alfabéticamente y filtrables por categorías (Estructura, Metadatos, Enlaces, Imágenes, Schema, Rendimiento, IA & AEO).
• Cada término incluye:

- Definición rigurosa.

- Justificación de su relevancia para la visibilidad técnica, semántica y accesibilidad.

- Ejemplos prácticos de Buenas Prácticas (Good) y Errores Frecuentes (Bad).

- Enlaces a la especificación estándar oficial (W3C, Schema.org, Google Developers).

31. Activación de Licencia PRO y Opciones Generales

Página de Configuración de Licencia y opciones de API

Procedimiento para activar Baloa PRO:

1. Dirígete a Baloa SEO → Configuración (admin.php?page=baloa-settings), pestaña 🎫 Licencia.
2. Localiza la sección Licencia de Producto.
3. Introduce tu clave en el campo Clave de Licencia PRO.
4. Haz clic en el botón Activar (o puedes pulsar Probar Conexión para verificar previamente la conectividad con el servidor de licencias).
5. Una vez validada, el badge indicará el estado ✓ PRO ACTIVO (o notificará si la licencia está LICENCIA INACTIVA, LICENCIA EXPIRADA o LICENCIA EN OTRO DOMINIO) y se habilitarán de inmediato las funcionalidades PRO: Auto-Fix asistido, Control de Cambios (Audit Ledger), Explorador Sitemap por lotes y Exportación de Informes.

32. Matriz Comparativa Free vs PRO

VII. Metodología Operativa de 10 Pasos

Sigue este ciclo de 10 pasos para auditar y optimizar cualquier contenido con Baloa:

[1. Entrar y escribir URL] ──> [2. Pulsar Analizar] ──> [3. Esperar 100% Escaneo]
                         │
                         ▼
            [4. Evaluar Score Global]  ──> [5. Ir a Problemas]   ──> [6. Filtrar Críticos]
                         │
                         ▼
            [7. Abrir problema]        ──> [8. Aplicar AutoFix o seguir Guía Manual]
                         │
                         ▼
            [9. Pulsar Verificar]     ──> [10. Validar resolución y nuevo Score]

1. Entrar al plugin: Accede a Baloa SEO en el panel de WordPress.
2. Introducir la URL: Escribe la dirección de la página a auditar en la barra superior.
3. Pulsar Analizar: Espera unos segundos a que el modal modular alcance el 100%.
4. Revisar el Score: Observa el puntaje global y los módulos más rezagados en la cuadrícula.
5. Entrar en Problemas: Pulsa en el botón Ver problemas o en la barra lateral.
6. Priorizar los Críticos: Haz clic en el chip Críticos para atender los problemas prioritarios.
7. Seleccionar un problema: Revisa el medidor visual y la explicación en el Paso 2 (Diagnóstico).
8. Pasar al Paso 3 (Solucionar):

- Si tiene Auto-Fix: Pulsa Aplicar AutoFix ahora.

- Si es Manual: Pulsa Cargar Guía de Solución Paso a Paso, abre el editor y aplica el cambio.

9. Verificar corrección (Paso 4): Pulsa el botón verde Verificar corrección para re-escanear.
10. Comprobar la mejora: Confirma que el problema ha sido retirado de la lista de pendientes y que la puntuación global o del módulo correspondiente se ha recalculado reflejando la resolución.

VIII. Glosario Esencial de Términos

• Score (Puntuación): Cuantificación matemática de 0 a 100 que refleja el grado de apego a los estándares técnicos y semánticos evaluados en la página.
• PASS (Aprobado): Verificación técnica que cumple satisfactoriamente la regla auditada; suma puntos al numerador del score.
• Warning (Advertencia): Deficiencia moderada que no bloquea la indexación pero merma la optimización técnica o citabilidad.
• Critical (Crítico): Error severo que compromete la indexación, visibilidad o accesibilidad (mayor deducción ponderada en el cálculo del score global).
• Auto-Fix: Funcionalidad de Baloa PRO que subsana el problema en tiempo de ejecución (runtime hooks) sin alterar los archivos físicos PHP del servidor.
• Fix Manual: Procedimiento donde el usuario realiza el ajuste directamente en el editor de WordPress o en la plantilla.
• AEO (Answer Engine Optimization): Optimización orientada a estructurar y dar claridad semántica a los contenidos para facilitar su extracción por motores de respuesta directa impulsados por IA (ChatGPT, Perplexity, Claude, etc.).
• GEO (Generative Engine Optimization): Estrategia técnica y editorial orientada a optimizar señales semánticas y relevancia contextual para resúmenes sintéticos generados por modelos de lenguaje.
• Schema JSON-LD: Marcado de datos estructurados en formato JavaScript Object Notation recomendado oficialmente por Google y Schema.org.
• E-E-A-T: Siglas en inglés de Experience, Expertise, Authoritativeness, and Trustworthiness (Experiencia, Conocimiento, Autoridad y Fiabilidad).
• Core Web Vitals (CWV): Conjunto de métricas oficiales de Google que miden la velocidad de carga (LCP), interactividad (INP) y estabilidad visual (CLS).
• llms.txt: Propuesta de especificación emergente servida dinámicamente que ofrece a los rastreadores y modelos de lenguaje un índice en texto Markdown estructurado para un consumo eficiente del contenido esencial del sitio.
• Profundidad del DOM (DOM Depth): Cantidad de niveles de etiquetas HTML anidadas; un DOM excesivamente profundo degrada el rendimiento de renderizado.

IX. Preguntas Frecuentes y Solución de Problemas (FAQ)

X. Matriz Oficial de Verificación de Capturas

Conforme a la directiva de verificación empírica de la Fase 2, la siguiente matriz detalla todas las capturas de pantalla tomadas directamente de la interfaz en vivo de Baloa Structure Auditor SEO:

Manual Oficial de Usuario — Baloa Structure Auditor SEO (v3.0.9 Core Free & Addon PRO).

Desarrollado y verificado en el ecosistema WordPress de TecniCoelho / Dynamic-Themes.