Validador de datos estructurados JSON-LD
Pega HTML o JSON-LD en bruto para validar datos estructurados FAQPage, BreadcrumbList y Article. Detecta al instante propiedades obligatorias faltantes y errores comunes de los resultados enriquecidos de Google.
Qué es el Validador de datos estructurados JSON-LD
JSON-LD es un formato de marcado que le indica a Google, de forma legible por máquinas, qué es realmente un fragmento de contenido de la página: una FAQ, un artículo, una ruta de navegación, etc. Se escribe como JSON dentro de una etiqueta <script type="application/ld+json">, de modo que añade datos estructurados sin tocar en absoluto el HTML visible. Cuando se implementa correctamente, puede habilitar Resultados Enriquecidos en la búsqueda, como fragmentos de FAQ desplegables o rutas de navegación, que suelen mejorar la tasa de clics incluso sin ningún cambio en el posicionamiento.
Esta herramienta extrae automáticamente los bloques <script> del HTML pegado (o acepta JSON-LD en bruto directamente) y comprueba cada entidad FAQPage, BreadcrumbList y de tipo Article (Article / NewsArticle / BlogPosting) frente a las propiedades obligatorias que define Schema.org. También señala los errores clásicos que rompen silenciosamente los Resultados Enriquecidos de Google, como que acceptedAnswer.text sea un objeto en lugar de una cadena de texto simple, o que los valores de position no sean secuenciales. Ejecutar esta comprobación antes de publicar, o justo después de una corrección, detecta los problemas antes de tener que esperar a verlos más tarde en Search Console.
Cómo usar el Validador de datos estructurados JSON-LD
- Consigue el código HTML o el JSON-LD de tu página Sirve tanto el HTML completo obtenido con "Ver código fuente de la página" como solo el contenido de una etiqueta <script>.
- Pégalo en el cuadro de entrada, u obténlo desde una URL Puedes pegar el texto directamente, o, si la página ya está publicada, introducir su URL para obtenerlo automáticamente.
- Revisa las entidades detectadas y sus resultados Si la entrada contiene varios bloques <script> o varias entidades @type, cada una se lista y se valida por separado.
- Corrige cualquier propiedad marcada como "Falta" o "Aviso" Cada propiedad aparece como OK, Aviso o Falta, así que puedes ir directamente al punto correspondiente en tu JSON-LD original y corregirlo.
- Vuelve a validar tras corregir, antes de publicar Pega de nuevo el JSON-LD corregido y confirma que todas las propiedades muestran OK antes de aplicar el cambio en producción.
Consejos para aprovecharla mejor
- En FAQPage, acceptedAnswer.text siempre debe ser una cadena de texto simple. Si colocas ahí un objeto o un array, los resultados enriquecidos de Google no podrán interpretarlo.
- En BreadcrumbList, mantén position como una secuencia que empiece en 1. Los huecos o duplicados impiden que se reconozca como una ruta de navegación válida.
- Mantén el headline de Article en unos 110 caracteres o menos, que es la guía aproximada de Google; los titulares más largos pueden truncarse en los resultados de búsqueda.
- Puedes pegar una página HTML completa: la herramienta extrae automáticamente el contenido de cualquier bloque <script type="application/ld+json">. Pegar solo el JSON en bruto también funciona.
- Si una página tiene varios bloques de datos estructurados, mantener cada uno en su propia etiqueta <script> facilita su mantenimiento y depuración.
Cuándo resulta útil esta herramienta
Comprobar el marcado FAQPage antes de publicarlo
Detecta errores clásicos, como un acceptedAnswer.text mal estructurado, que impiden silenciosamente que aparezca el fragmento enriquecido de FAQ, antes de publicar.
Auditar las migas de pan tras una reestructuración del sitio
Cuando cambian las categorías o las URL, confirma de una sola vez que los valores de position de BreadcrumbList siguen en el orden correcto.
Revisar el esquema Article de una entrada de blog
Comprueba rápidamente si el headline es demasiado largo o si faltan author, datePublished o image, las propiedades recomendadas para páginas de tipo artículo.
Investigar un error señalado por la Prueba de Resultados Enriquecidos
Cuando la herramienta oficial de Google reporta un error, delimita primero aquí exactamente qué propiedad falla y luego corrige el origen.
Glosario
- JSON-LD
- Una especificación para escribir datos estructurados en formato JSON. Se incrusta como un bloque independiente dentro de una etiqueta <script type="application/ld+json">, de modo que se puede añadir información orientada a los buscadores sin modificar el diseño HTML existente.
- Schema.org
- Un vocabulario compartido para datos estructurados, mantenido conjuntamente por Google, Microsoft, Yahoo y otros. Define tipos (@type), como FAQPage o Article, y las propiedades que admite cada uno.
- FAQPage
- Un tipo de Schema.org para indicarle a Google una lista de preguntas y respuestas. Su mainEntity contiene un array de entidades Question, cada una de las cuales requiere un name (el texto de la pregunta) y acceptedAnswer.text (el texto de la respuesta).
- BreadcrumbList
- Un tipo de Schema.org que representa una ruta de navegación: la posición de la página dentro de la jerarquía de un sitio. Su itemListElement contiene un array de entidades ListItem, cada una con position, name e item obligatorios.
- Resultados Enriquecidos
- Resultados de búsqueda mejorados que muestran más que un simple título y descripción, como un fragmento de FAQ desplegable o una ruta de navegación, y que requieren datos estructurados correctamente implementados para aparecer.
- Propiedad obligatoria
- Una propiedad que Google necesita para mostrar un determinado Resultado Enriquecido; si falta, el Resultado Enriquecido simplemente no aparecerá. Una propiedad recomendada, en cambio, no es estrictamente obligatoria, pero mejora cómo se muestra el resultado.
- Google Search Console
- La herramienta oficial de Google para supervisar el rendimiento en buscadores y el estado de indexación de un sitio. Sus informes de Mejoras muestran cómo está interpretando Google realmente los datos estructurados de tus páginas publicadas.
Preguntas frecuentes
A propósito — Por qué JSON-LD sustituyó a Microdata y RDFa
JSON-LD (JSON for Linking Data) se originó como un formato de datos enlazados estandarizado por un grupo comunitario del W3C a principios de la década de 2010. A diferencia de las notaciones más antiguas de datos estructurados, Microdata y RDFa, que incrustan el marcado directamente en los atributos de los elementos HTML, JSON-LD vive por completo dentro de una etiqueta <script> como un bloque independiente de JSON. Esto significa que los datos estructurados pueden añadirse, editarse o eliminarse sin tocar en absoluto el diseño HTML circundante. Google empezó a favorecer JSON-LD como formato recomendado hacia 2015, y su documentación actual de resultados enriquecidos está escrita casi por completo pensando en la sintaxis de JSON-LD.
Las propias secciones de preguntas frecuentes de este sitio funcionan igual: los autores escriben cada pregunta y respuesta una sola vez, y un bloque JSON-LD de tipo FAQPage se genera automáticamente en segundo plano. No hace falta escribir el mismo contenido dos veces, una para el acordeón legible por humanos y otra para el esquema legible por máquinas, por lo que ambos nunca se desincronizan como suele ocurrir con el marcado duplicado manualmente.
Incluso un JSON sintácticamente válido puede fallar en los resultados enriquecidos si le falta una propiedad que exige Schema.org, o una propiedad que Google recomienda. Campos profundamente anidados como acceptedAnswer.text son un lugar clásico donde se comete un error de estructura. Ejecutar una comprobación como esta antes de publicar detecta esos errores antes de que aparezcan más tarde en el informe de mejoras de Search Console.