Qué es JSON-LD y por qué importa para la visibilidad LLM

Cuando ChatGPT, Claude o Perplexity rastrean tu sitio web, no lo leen como un humano. Escanean el HTML buscando señales estructuradas — pistas legibles por máquina sobre qué es la página, quién la opera y qué cubre. La señal más importante es JSON-LD.

Qué es realmente JSON-LD

JSON-LD (JavaScript Object Notation for Linked Data) es un formato para incrustar datos estructurados en tu HTML. Usa el vocabulario de schema.org, el estándar compartido mantenido por Google, Microsoft, Yahoo y Yandex desde 2011.

En la práctica, JSON-LD es un tag <script> que colocas dentro del <head> de tu página:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Acme",
  "url": "https://acme.com"
}
</script>

Eso es todo. Un script tag por schema, dentro del head, invisible para los usuarios pero crítico para los crawlers.

Por qué a los LLMs les importa

Sin JSON-LD, un LLM tiene que adivinar de qué trata tu página analizando el HTML crudo. Con JSON-LD, el modelo lee una descripción precisa y tipada: "esto es una Organization llamada Acme, su URL es X, su logo es Y, y es el publisher de este WebSite."

Esa diferencia se acumula. Un modelo que cita tu negocio por nombre necesita saber tu nombre. Un modelo que recomienda una respuesta de FAQ necesita saber qué preguntas respondes. JSON-LD da esa información en su forma más limpia.

Los cuatro schemas que todo sitio debe tener

No necesitas todos los tipos de schema. Para el 90% de los sitios, estos cuatro cubren lo esencial:

1. Organization

Describe la empresa o marca detrás del sitio — nombre, URL, logo, descripción. Este es el schema que le permite a un LLM decir "Acme es una fintech fundada en México" en vez de adivinar.

2. WebSite

Describe el sitio en sí — nombre, URL, idioma. Suena redundante con Organization, pero es un tipo de schema diferente que algunos crawlers y motores de búsqueda buscan explícitamente.

3. BreadcrumbList

Muestra la jerarquía de navegación. Incluso un breadcrumb de una sola página (solo la entrada "Inicio") es suficiente para que la detección dispare en la mayoría de los crawlers, incluidos los enfocados en LLMs.

4. FAQPage

Convierte tu sección de FAQ en pares pregunta-respuesta citables. Si un usuario le hace a ChatGPT una pregunta que coincide con una de tus FAQs, el modelo puede citar tu respuesta directamente. Es uno de los schemas de mayor palanca que puedes agregar.

Dónde pegar los scripts

Los cuatro van dentro del <head> de la página correspondiente:

Organization y WebSite: en todas las páginas (mejor si se agregan en el layout del sitio)
BreadcrumbList: en todas las páginas (regenerado por página con la jerarquía correcta)
FAQPage: solo en páginas que realmente tienen una sección FAQ visible para el usuario

Puedes incluir múltiples schemas en un solo script usando @graph, o mantenerlos en tags <script> separados. Ambos funcionan. El Rich Results Test de Google es una forma rápida de verificar que tu markup parsea correctamente.

Errores comunes

Mentirle al schema. Si tu sitio no tiene realmente el FAQ listado en FAQPage, los crawlers lo notan y bajan tu confianza. Haz match entre schema y realidad.
Copiar-pegar sin personalizar. Un Organization genérico con "name": "Tu Empresa" no hace nada. Llena los valores reales.
Olvidar el logo. Organization sin URL de logo es más débil — el logo es cómo los LLMs identifican visualmente tu marca en tarjetas de respuesta.
URLs relativas. Todas las URLs en schemas deben ser absolutas (https://...), nunca relativas (/about).

La forma fácil de tener los cuatro

Si escribir JSON-LD desde cero se siente como tarea, pasa tu sitio por LLCrawler. El reporte incluye un kit de JSON-LD armado desde los datos reales de tu sitio — Organization con tu nombre y logo reales, WebSite con tu idioma, BreadcrumbList para tu homepage, y FAQPage si detectamos una sección de FAQ. Copia cada bloque, pega en tu <head>, listo.

JSON-LD no es infraestructura opcional para sitios que quieren ser citados por IA. Es el vocabulario básico. Sin él, eres invisible en la conversación.