GuíasPosicionamiento en IA

Tutorial: añadir datos estructurados (JSON‑LD) en Astro

Por el equipo de Banzai LabsActualizado el 2 min de lectura

<script type="application/ld+json">{ "@type": "Article", "headline": … }</script>ArtículoAutorFechaUn componente de Astro escribe el JSON-LD de cada página
El JSON-LD se escribe en la página; los motores leen en él el tipo, el autor y la fecha.

1. El componente

---
// src/components/JsonLd.astro
const { data } = Astro.props;
---
<script type="application/ld+json" set:html={JSON.stringify(data)} />

set:html evita que Astro escape las comillas del JSON.

2. Una página de artículo

---
import JsonLd from '../components/JsonLd.astro';
const article = {
  '@context': 'https://schema.org',
  '@type': 'Article',
  headline: 'Título de la guía',
  datePublished: '2026-11-12',
  author: { '@type': 'Organization', name: 'Tu empresa' },
};
---
<head>
  <JsonLd data={article} />
</head>

3. Qué tipo, dónde

Página Tipo
Portada Organization o LocalBusiness
Guía, artículo Article
Ficha de producto Product, con Offer
Todas BreadcrumbList
Preguntas y respuestas FAQPage

4. Comprobar

  1. 1El código fuenteEl bloque JSON-LD está presente y es válido.
  2. 2La prueba de resultados enriquecidosLa herramienta de Google señala los errores.
  3. 3Search ConsoleEl informe de mejoras, tras la indexación.

Por qué sirve a los motores de IA: Schema.org y motores de IA.

Preguntas frecuentes

¿Hace falta una librería?
No. Un objeto JavaScript y JSON.stringify bastan. Una librería de tipos puede ayudar a evitar errores en las propiedades.
¿Qué tipos poner primero?
Organization (o LocalBusiness) en la portada, Article en los contenidos, Product en las fichas de producto, BreadcrumbList en todas.
¿Deben verse los datos en la página?
Sí. El JSON-LD describe lo que muestra la página; anunciar otra cosa va contra las directrices de Google.

Para leer después

Todas las guías