¿Qué es JSON-LD?

JSON-LD (Notación de objetos JavaScript para datos enlazados) es el formato que los motores de búsqueda recomiendan para los datos estructurados. Una página añade un bloque <script type="application/ld+json"> que describe de qué trata la página, como un producto con su precio, un artículo con su autor o una organización con su logotipo, utilizando tipos y propiedades del vocabulario de schema.org. Google, Bing y otros motores de búsqueda leen estos bloques para mostrar resultados enriquecidos, como valoraciones con estrellas, precios, rutas de navegación y fichas de recetas.

Los errores en JSON-LD fallan silenciosamente. La página sigue cargándose, pero una coma faltante, un tipo escrito incorrectamente o un campo obligatorio ausente hacen que los motores de búsqueda ignoren el marcado o que la página pierda su resultado enriquecido.

Descripción de la herramienta

Esta herramienta obtiene el HTML de una página en el servidor, encuentra todos los bloques de script JSON-LD y comprueba cada uno en dos pasos. Primero comprueba el propio JSON-LD: que el JSON se pueda analizar, que cada elemento tenga un @context que apunte a schema.org y un @type, y que las palabras clave como @type y @id estén escritas y estructuradas correctamente. Después comprueba el contenido con el vocabulario de schema.org y las reglas de Google para resultados enriquecidos, e informa sobre tipos desconocidos, propiedades que no corresponden a un tipo y campos obligatorios o recomendados que faltan o tienen un formato incorrecto.

Características

  • Encuentra todos los bloques JSON-LD de una página activa, ya estén en <head> o <body>
  • Informa de los errores de sintaxis JSON con el mensaje del analizador
  • Comprueba @context, @type, @id, @graph y la escritura de las palabras clave
  • Marca los tipos y las propiedades de schema.org desconocidos que un tipo no admite
  • Comprueba los campos obligatorios y recomendados por Google para productos, ofertas, reseñas, valoraciones, recetas, ofertas de empleo, vídeos, rutas de navegación y mucho más
  • Muestra cada elemento de datos estructurados con su tipo y nombre
  • Muestra cada bloque como JSON con formato

Cómo funciona

La página se descarga sin seguir redirecciones y se leen como máximo sus primeros 3 MB. Cada bloque JSON-LD se analiza por separado, y los elementos dentro de un @graph se comprueban como elementos independientes. Las comprobaciones de schema.org utilizan una copia del vocabulario completo de schema.org, y las comprobaciones de Google para resultados enriquecidos utilizan el validador de datos estructurados de código abierto de Adobe.

Consejos

  • Los errores significan que es probable que los motores de búsqueda ignoren el elemento o que no obtenga un resultado enriquecido, así que corrígelos primero. Las advertencias suelen corresponder a campos recomendados, y añadirlos puede mejorar el aspecto del resultado.
  • Las palabras clave de JSON-LD distinguen entre mayúsculas y minúsculas: @type funciona, pero @Type no.
  • Utiliza URL absolutas para url, image y logo, y fechas ISO 8601 como 2026-09-25 o 2026-09-25T10:00:00+02:00.
  • La herramienta lee el HTML que devuelve el servidor. No encontrará el JSON-LD añadido posteriormente por JavaScript en el navegador.