Validador de datos estructurados
Pega el código fuente HTML de una página o un fragmento JSON-LD para encontrar todos los elementos de datos estructurados, ver a qué resultado enriquecido de Google apunta cada uno y obtener una lista clara de errores de sintaxis, propiedades obligatorias que faltan y campos recomendados.
Última actualización:
Las comprobaciones se ejecutan en tu navegador según los tipos de schema.org y las propiedades obligatorias y recomendadas documentadas por la Búsqueda de Google. Pasarlas aquí no garantiza que Google muestre un resultado enriquecido.
Cómo usar Validador de datos estructurados
- Copia el código fuente de la página (Ver código fuente o Ctrl+U en tu navegador) o solo el script JSON-LD, y pégalo en el cuadro. También puedes abrir un archivo .html guardado.
- Lee el resumen: número de elementos encontrados, errores, avisos y qué tipos de resultados enriquecidos se detectaron.
- Corrige primero los errores: un JSON no válido o la falta de propiedades obligatorias hacen que el elemento no pueda optar a resultados enriquecidos.
- Añade las propiedades recomendadas que aparecen como avisos cuando tengas los datos; mejoran cómo puede aparecer el resultado.
- Vuelve a comprobar mientras editas: con Comprobar mientras escribo activado, los resultados se actualizan al instante. Copia el informe o el JSON-LD cuando termines.
Propiedades obligatorias de Google de un vistazo
| Tipo | Resultado enriquecido | Obligatorias | Recomendadas clave |
|---|---|---|---|
| Product | Fragmento de producto, ficha de comerciante | name + una de offers, review, aggregateRating | image, brand, sku, gtin, description |
| Offer | (dentro de Product) | price, priceCurrency | availability, url, priceValidUntil |
| Article, NewsArticle, BlogPosting | Artículo | ninguna | headline, image, datePublished, dateModified, author |
| BreadcrumbList | Ruta de navegación | itemListElement con position, name, item (excepto el último) | ninguna |
| Event | Evento | name, startDate, location | endDate, eventStatus, image, offers, organizer |
| Recipe | Receta | name, image | recipeIngredient, recipeInstructions, totalTime, nutrition.calories |
| LocalBusiness (y subtipos) | Negocio local | name, address | telephone, geo, openingHoursSpecification, url |
| JobPosting | Oferta de empleo | title, description, datePosted, hiringOrganization, jobLocation | baseSalary, employmentType, validThrough |
| VideoObject | Vídeo | name, thumbnailUrl, uploadDate | contentUrl o embedUrl, duration, description |
| AggregateRating | Fragmento de reseña (estrellas) | ratingValue + ratingCount o reviewCount | bestRating, worstRating |
Basado en la documentación sobre datos estructurados de Google Search Central. Google actualiza estos requisitos de vez en cuando, así que usa la tabla como lista de comprobación, no como garantía.
Formatos de valores que suelen dar problemas
| Propiedad | Incorrecto | Correcto |
|---|---|---|
Fechas (datePublished, startDate…) | 14 de marzo de 2025, 14/03/2025 | 2025-03-14 o 2025-03-14T19:30:00-05:00 |
Duraciones (cookTime, duration…) | 10 minutos, 1:30 | PT10M, PT1H30M |
price | $89.99, 1,299.00, 89,99 | 89.99, 1299.00 |
priceCurrency | $, usd, Dólares | USD (ISO 4217) |
availability | En stock | https://schema.org/InStock |
URL (image, url, logo) | /images/photo.jpg | https://www.example.com/images/photo.jpg |
| Nombres de tipos y propiedades | "@type": "product", "Name" | "@type": "Product", "name" (distingue mayúsculas y minúsculas) |
¿JSON-LD, microdatos o RDFa?
JSON-LD es un bloque <script type="application/ld+json"> independiente, fácil de generar y mantener sin tocar el HTML visible, y es el formato que recomienda Google. Los microdatos añaden los atributos itemscope, itemtype e itemprop a elementos HTML existentes, lo que mantiene el marcado junto al contenido visible pero hace más difíciles de editar las plantillas. RDFa usa los atributos vocab, typeof y property de forma similar. Google admite los tres; puedes mezclarlos en una página, pero evita describir el mismo elemento dos veces en formatos distintos. Usa Copiar como JSON-LD arriba para convertir los elementos de microdatos en un bloque JSON-LD.
Preguntas frecuentes
¿Qué son los datos estructurados?
Los datos estructurados son información legible por máquinas que se añade a una página web, normalmente como JSON-LD en una etiqueta script, y que describe el contenido de la página con tipos de schema.org como Product, Article, Recipe o Event. Los buscadores los usan para entender la página y pueden mostrar resultados enriquecidos como valoraciones con estrellas, precios o rutas de navegación.
¿Qué formatos admite este validador?
JSON-LD (el formato recomendado por Google), microdatos (atributos itemscope, itemtype e itemprop) y RDFa básico (atributos typeof y property). Pega una página HTML completa, una sola etiqueta script o JSON sin procesar que empiece por { o [.
¿Qué diferencia hay entre un error y un aviso?
Los errores son problemas que hacen que el marcado no sea válido o no pueda optar a su resultado enriquecido, como un JSON roto, una propiedad obligatoria que falta o un precio escrito como $19.99. Los avisos son propiedades recomendadas que faltan o valores dudosos: el elemento puede seguir siendo apto, pero añadirlas da más información a los buscadores.
¿Es lo mismo que la Prueba de resultados enriquecidos de Google?
No. Comprueba tu marcado frente a schema.org y las propiedades obligatorias y recomendadas documentadas por Google, completamente en tu navegador, así que funciona con páginas sin publicar y fragmentos pegados. La prueba de Google también renderiza la página en vivo y aplica sus políticas, así que úsala como comprobación final antes de publicar.
¿Por qué mi marcado de preguntas frecuentes válido no aparece en Google?
Desde agosto de 2023, Google muestra resultados enriquecidos de preguntas frecuentes solo para sitios web gubernamentales y de salud conocidos y con autoridad, y dejó de mostrar los resultados enriquecidos de instrucciones (How-to) en septiembre de 2023. El marcado puede seguir siendo válido, y esta herramienta te lo indica, pero no generará un resultado enriquecido en la mayoría de los sitios.
¿Puede obtener una URL directamente?
No. Los navegadores impiden que las páginas web lean el HTML de otros sitios (CORS), y esta herramienta no envía nada a ningún servidor. Abre la página, consulta su código fuente y pega el HTML aquí, o guarda la página y abre el archivo .html.
¿Unos datos estructurados válidos garantizan resultados enriquecidos?
No. Un marcado válido y completo hace que la página sea apta, pero Google decide si muestra un resultado enriquecido según la calidad del contenido, sus políticas y la consulta de búsqueda. El marcado también debe describir contenido visible en la página.
¿Se prueban todas las herramientas de FreeToolCabin para comprobar su calidad y precisión?
Sí. Cada herramienta del sitio pasa pruebas automáticas en navegadores reales para comprobar que el resultado es correcto y que no hay errores. Si encuentras un fallo o tienes una sugerencia, escríbenos a [email protected] y lo revisaremos.