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.

Consejos

  • 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.

Preguntas frecuentes

JSON-LD almacena los datos estructurados como JSON dentro de su propia etiqueta <script>, completamente separada del HTML visible. Microdata y RDFa, en cambio, incrustan el marcado directamente en los atributos HTML (como itemprop), lo que requiere modificar la estructura HTML existente. Google recomienda ahora JSON-LD, y su sencillez de implementación lo ha convertido en el formato dominante.

Los datos estructurados en sí no son un factor directo de posicionamiento. Sin embargo, un marcado FAQPage o BreadcrumbList correctamente implementado puede habilitar resultados enriquecidos, como fragmentos de FAQ desplegables o rutas de navegación en los resultados de búsqueda, lo que puede mejorar la tasa de clics (CTR) incluso sin cambiar el posicionamiento.

Schema.org exige que acceptedAnswer.text sea una cadena de texto simple. Si se establece por error como un objeto o un array (por ejemplo, una estructura anidada como { "value": "la respuesta" }), la Prueba de Resultados Enriquecidos de Google lo marcará como aviso o error.

Sí, es perfectamente correcto. FAQPage, BreadcrumbList, Article y otros tipos de esquema pueden escribirse cada uno en su propio bloque <script type="application/ld+json"> dentro de la misma página. Esta herramienta detecta y valida múltiples bloques y múltiples entidades a partir de una sola entrada.

Utiliza los informes de mejoras en Google Search Console, o la herramienta oficial de Google Prueba de Resultados Enriquecidos, sobre tu URL publicada en producción para ver exactamente cómo lo está interpretando Google. Esta herramienta es más útil como autocomprobación durante el borrador o justo después de aplicar una corrección, antes de publicar.
ツールくん

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.

→ Ver todas las curiosidades