Control de regresiones en datos estructurados

Los datos estructurados fallan en silencio. Una actualización de un plugin se deja fuera una propiedad obligatoria, un editor deja un campo en blanco, y el resultado enriquecido desaparece mucho antes de que el informe de mejoras registre nada. Validar una URL a mano en el momento de construir no detecta nada de esto, porque el fallo viene de la variación de los datos a lo largo del catálogo y no de la plantilla que se probó.

El archivo de la habilidad

---
name: structured-data-regression-guard
description: Úsala cuando los resultados enriquecidos desaparezcan sin causa aparente, o después de cualquier cambio de CMS, plantilla, tema o plugin que toque el marcado de las páginas.
---

# Control de regresiones en datos estructurados

Los datos estructurados fallan en silencio. Una actualización de un plugin se deja fuera una propiedad obligatoria, un editor deja un campo en blanco, y el resultado enriquecido desaparece mucho antes de que el informe de mejoras registre nada. Validar una URL a mano en el momento de construir no detecta nada de esto, porque el fallo viene de la variación de los datos a lo largo del catálogo y no de la plantilla que se probó.

## Qué necesitas antes

- Una lista de las plantillas que emiten datos estructurados y el tipo de schema que emite cada una
- HTML renderizado, no el código de la plantilla, de al menos 20 URL por plantilla elegidas para incluir casos límite
- Los informes de mejoras de Search Console con los recuentos de errores y avisos por tipo
- La documentación actual de Google sobre propiedades obligatorias frente a recomendadas para los tipos de resultado que persigues

## Método

1. Extrae el JSON-LD del HTML renderizado y no del fichero de plantilla. Lo que se publica es lo que el CMS produjo una vez rellenados los campos, y los huecos están en el relleno, no en la plantilla.
2. Muestrea a propósito buscando ausencias: el artículo sin imagen, el que no tiene reseñas, el más barato y el más caro, uno sin stock, uno con un nombre desmesuradamente largo. Una muestra uniforme pasa la validación y no demuestra nada.
3. Valida contra las propiedades obligatorias del resultado enriquecido concreto que quieres, no contra schema.org en general. schema.org acepta muchísimas cosas que Google no va a mostrar jamás.
4. Confirma que los valores marcados coinciden con lo que el usuario puede ver en la página. Precios, valoraciones y disponibilidad que solo existen en el marcado son un riesgo de acción manual, y el desajuste suele venir de una caché obsoleta y no de que alguien lo hiciera a propósito.
5. Registra un recuento de línea base por plantilla y por tipo, y después repite la misma extracción tras cada cambio de plantilla, tema o plugin. La alerta es que el recuento baje, y salta semanas antes que Search Console.
6. Lee el informe de mejoras como una confirmación con retraso y no como el detector. Te dice qué ha procesado Google, cosa útil para dirimir discusiones e inútil como aviso temprano.
7. Cuando el marcado es válido y el resultado enriquecido sigue sin aparecer, párate antes de reescribir nada. Ser elegible no da derecho a nada, Google retira tipos de resultado por consulta y por sitio, y lo que hay que comprobar es si los competidores siguen mostrando ese tipo de resultado para las mismas consultas.

## Qué produce esto

Una línea base de datos estructurados por plantilla con la cobertura de propiedades obligatorias, un conjunto de muestra deliberadamente incómodo y una extracción repetible que avisa de las caídas de recuento tras cualquier cambio en el marcado.

## Dónde falla esto

- Validar la plantilla de forma aislada, con lo que pasa la validación mientras las páginas en producción fallan por los campos que nadie rellenó
- Marcar valores que la página no muestra, que es la causa más habitual de una acción manual por datos estructurados
- Añadir todas las propiedades que schema.org permite bajo la teoría de que más marcado posiciona mejor, lo que añade superficie de rotura y ninguna elegibilidad
- Reescribir un marcado válido porque desapareció un resultado enriquecido, cuando lo que se retiró fue el propio tipo de resultado para esas consultas

---

De la biblioteca de habilidades de QuQi - https://www.quqi.io/es/skills/structured-data-regression-guard

Qué necesitas antes

• Una lista de las plantillas que emiten datos estructurados y el tipo de schema que emite cada una
• HTML renderizado, no el código de la plantilla, de al menos 20 URL por plantilla elegidas para incluir casos límite
• Los informes de mejoras de Search Console con los recuentos de errores y avisos por tipo
• La documentación actual de Google sobre propiedades obligatorias frente a recomendadas para los tipos de resultado que persigues

Método

1. 01 Extrae el JSON-LD del HTML renderizado y no del fichero de plantilla. Lo que se publica es lo que el CMS produjo una vez rellenados los campos, y los huecos están en el relleno, no en la plantilla.
2. 02 Muestrea a propósito buscando ausencias: el artículo sin imagen, el que no tiene reseñas, el más barato y el más caro, uno sin stock, uno con un nombre desmesuradamente largo. Una muestra uniforme pasa la validación y no demuestra nada.
3. 03 Valida contra las propiedades obligatorias del resultado enriquecido concreto que quieres, no contra schema.org en general. schema.org acepta muchísimas cosas que Google no va a mostrar jamás.
4. 04 Confirma que los valores marcados coinciden con lo que el usuario puede ver en la página. Precios, valoraciones y disponibilidad que solo existen en el marcado son un riesgo de acción manual, y el desajuste suele venir de una caché obsoleta y no de que alguien lo hiciera a propósito.
5. 05 Registra un recuento de línea base por plantilla y por tipo, y después repite la misma extracción tras cada cambio de plantilla, tema o plugin. La alerta es que el recuento baje, y salta semanas antes que Search Console.
6. 06 Lee el informe de mejoras como una confirmación con retraso y no como el detector. Te dice qué ha procesado Google, cosa útil para dirimir discusiones e inútil como aviso temprano.
7. 07 Cuando el marcado es válido y el resultado enriquecido sigue sin aparecer, párate antes de reescribir nada. Ser elegible no da derecho a nada, Google retira tipos de resultado por consulta y por sitio, y lo que hay que comprobar es si los competidores siguen mostrando ese tipo de resultado para las mismas consultas.

Qué produce esto

Una línea base de datos estructurados por plantilla con la cobertura de propiedades obligatorias, un conjunto de muestra deliberadamente incómodo y una extracción repetible que avisa de las caídas de recuento tras cualquier cambio en el marcado.

Dónde falla esto

• Validar la plantilla de forma aislada, con lo que pasa la validación mientras las páginas en producción fallan por los campos que nadie rellenó
• Marcar valores que la página no muestra, que es la causa más habitual de una acción manual por datos estructurados
• Añadir todas las propiedades que schema.org permite bajo la teoría de que más marcado posiciona mejor, lo que añade superficie de rotura y ninguna elegibilidad
• Reescribir un marcado válido porque desapareció un resultado enriquecido, cuando lo que se retiró fue el propio tipo de resultado para esas consultas

Usa esta skill en tu propia IA

El archivo es markdown simple, con el nombre y el disparador en su frontmatter. Cuando un asistente sabe cargar skills por su cuenta, es ese frontmatter lo que lee para decidir que esta le aplica.

Más en SEO técnico