Saltar al contenido

Comprobador de datos estructurados

Respuesta breve

Comprueba el JSON-LD de una página: que cada bloque se lea, los tipos de schema.org que declara, campos básicos como @context y @type, y si hay Organization, WebSite y BreadcrumbList.

Lo que no hace: Comprueba que el JSON-LD se lee, sus tipos y algunos campos básicos, no cada propiedad obligatoria de cada resultado enriquecido; no lee microdatos, RDFa ni marcado añadido por scripts.

Gratis · Sin registro · Se ejecuta en tu navegador
100% en tu navegador — tu contenido nunca sale de tu dispositivo.

Qué hace

Extrae cada bloque JSON-LD de su página e informa en dos partes. Validez del JSON-LD: si cada bloque es JSON válido y qué tipos de schema.org declara (Organization, Product, Article, etc.). Entidades y campos obligatorios: si cada entidad tiene @context y @type, si una Organization tiene nombre (name) y un WebSite una dirección (url), y qué entidades principales (Organization, WebSite, BreadcrumbList, Article, Product, LocalBusiness) declara la página. La puntuación es la media de las dos partes.

Por qué importa

Los datos estructurados describen una página de una forma que los motores de búsqueda pueden leer, y Google los utiliza para resultados enriquecidos como precios de productos, estrellas de reseñas y migas de pan. Un bloque JSON-LD que no se interpreta correctamente se ignora por completo, y una actualización de CMS o plugin puede romper todas las páginas que comparten una plantilla. Comprobar el marcado después de cada lanzamiento detecta esto a tiempo.

Cómo funciona

  1. Introduzca la URL de una página o pegue su HTML

  2. Extraemos cada bloque JSON-LD del HTML, incluidas las entidades dentro de un @graph

  3. Comprobamos que cada bloque se lee y que cada entidad tiene @context, @type y sus campos básicos

  4. Obtiene los tipos encontrados, los errores y qué entidades principales están presentes o faltan

Ejemplo de entrada y salida

ENTRADA
url: https://rankproof.eu/tools
SALIDA
Validez del JSON-LD                       100/100
  bloques JSON-LD: 1 · tipos de schema.org: 5
  bloques no válidos: 0                    OK
  tipos encontrados: Organization, SoftwareApplication,
    WebSite, CollectionPage, ItemList

Entidades y campos obligatorios             92/100
  tipos de entidad: 5 · errores: 0 · avisos: 0
  Organization, WebSite                    presentes
  BreadcrumbList                           falta
  Article, Product, LocalBusiness          faltan

Puntuación: 96/100 — 2 de 2 partes en buen estado

Cómo leer el resultado

Bloques JSON-LD (1 en el ejemplo)
Cuántos bloques <script type="application/ld+json"> contiene el HTML. Un bloque con un @graph vale tanto como varios bloques separados; el número sobre todo te dice dónde mirar cuando algo falla.
Tipos encontrados (5)
Los tipos de schema.org declarados al inicio de cada bloque o dentro de su @graph: en el ejemplo Organization, SoftwareApplication, WebSite, CollectionPage e ItemList. Los tipos anidados dentro de una propiedad, como una dirección dentro de una Organization, no se listan aparte.
Bloques no válidos (0)
Bloques que no son JSON válido. Una sola coma de más o unas comillas sin escapar hacen que los buscadores ignoren todo el bloque, así que cualquier error aquí es lo primero que hay que corregir.
Entidades y campos obligatorios (92/100)
La segunda parte lee cada entidad, también las de un @graph: cada una necesita @context y @type, una Organization un nombre (name) y un WebSite una url; los errores y avisos se listan uno por línea. También muestra qué entidades principales declara la página. En el ejemplo están Organization y WebSite; de las que faltan, solo BreadcrumbList baja la parte, porque Article, Product y LocalBusiness describen tipos de página que /tools no es.
Puntuación (96/100)
La media de las dos partes, 100 y 92. La línea de resumen cuenta las partes en buen estado y solo es verde cuando lo están ambas; una página sin ningún JSON-LD obtiene 0 en las dos.
Lo que no significa aprobar
Un JSON válido con los campos básicos es el primer paso. Que el marcado pueda obtener un resultado enriquecido depende de las propiedades obligatorias de cada tipo y de las directrices de Google, que comprueban la prueba de resultados enriquecidos y los informes de mejoras de Search Console.

Quién lo usa

  • SEO técnico

    Antes del lanzamiento, confirma que los bloques Article, Product y BreadcrumbList de cada plantilla se interpretan sin errores.

  • Desarrollador/a de e-commerce

    Comprueba una plantilla de producto tras cada actualización de la plataforma para detectar marcado Product roto.

  • Responsable de contenido

    Confirma que el marcado Article de tus artículos principales se sigue interpretando después de una actualización de tema o plugin.

Problemas frecuentes y cómo solucionarlos

  1. Un bloque no se puede analizar

    Busca una coma tras la última propiedad, unas comillas sin escapar dentro de un valor o una variable de plantilla que no imprimió nada. Pega el bloque en un validador de JSON para encontrar la línea y corrige la plantilla que lo genera, así se arreglan todas las páginas a la vez.

    {
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Example Ltd",
  "url": "https://example.com"
}

  2. La página no tiene datos estructurados

    Empieza por lo que describe todo el sitio —un nodo Organization (o Person) y otro WebSite en la plantilla del sitio— y añade después el tipo que corresponde a cada página: Article para artículos, Product para fichas de producto, BreadcrumbList donde se muestran migas de pan.

    <script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@graph": [
    { "@type": "Organization", "@id": "https://example.com/#org", "name": "Example Ltd", "url": "https://example.com" },
    { "@type": "WebSite", "url": "https://example.com", "publisher": { "@id": "https://example.com/#org" } }
  ]
}
</script>

  3. El marcado FAQ o HowTo no da resultado enriquecido

    FAQPage y HowTo siguen siendo tipos válidos de schema.org, pero Google ya no muestra resultados FAQ ni HowTo en la búsqueda. Mantén el marcado solo si otra cosa lo usa y no esperes de él una ficha más rica.

  4. El marcado dice más de lo que muestra la página

    Las directrices de Google exigen que los datos estructurados describan contenido visible para los visitantes. Valoraciones, precios o eventos que solo están en el marcado pueden provocar una acción manual, así que genera el JSON-LD a partir de los mismos datos que muestra la página.

  5. El marcado lo añade un script

    La herramienta lee el HTML tal como se entrega, así que el JSON-LD insertado con JavaScript no se cuenta. Google puede leer JSON-LD inyectado, pero otros buscadores y herramientas quizá no; lo más seguro es imprimirlo en el HTML del servidor.

  6. Falta BreadcrumbList

    Añada BreadcrumbList en las páginas que muestran una ruta de navegación, generada a partir de la misma ruta que ve el visitante, para que marcado y página no se contradigan. Google puede usarlo para mostrar dónde está la página en su sitio en lugar de la URL sin más.

Preguntas frecuentes

¿Comprueba la idoneidad para resultados enriquecidos?
No. Comprueba que cada bloque se lee, lista sus tipos y revisa algunos campos básicos (@context, @type, el nombre de una Organization, la url de un WebSite). Cada resultado enriquecido tiene sus propias propiedades obligatorias; compruébelas con la prueba de resultados enriquecidos de Google.
¿Debería usar JSON-LD, microdatos o RDFa?
Google admite los tres y recomienda JSON-LD, que es el más fácil de añadir y mantener. Esta herramienta solo lee JSON-LD.
¿Qué tipos aún pueden obtener resultados enriquecidos?
Google enumera los tipos admitidos en su galería de búsqueda, por ejemplo Article, Product, Breadcrumb, Event, Local business, Recipe y Review snippet. Los resultados enriquecidos de FAQ y HowTo ya no se muestran en la Búsqueda de Google.
¿Ve el marcado añadido mediante JavaScript?
No. Lee el HTML tal como se entrega, así que el JSON-LD que añaden los scripts después no se incluye.
¿Por qué busca Organization y WebSite?
Dicen quién publica el sitio y cómo se llama. Google usa los datos estructurados WebSite, junto con otras señales, para elegir el nombre del sitio que muestra en los resultados, y el marcado Organization para detalles como el logotipo. Van en la plantilla del sitio, así que un solo cambio cubre todas las páginas.

Fuentes

La documentación en la que se basan esta herramienta y las explicaciones de esta página.

Herramientas gratuitas sobre este tema

Guías sobre este tema

Datos de estudio sobre este tema

Herramientas relacionadas en Análisis SEO

Ver todas las herramientas de Análisis SEO