EN
↑↓ navegar Enter abrir Esc cerrar
SEO & Datos Enriquecidos

Generador de Schema JSON-LD

Genera marcado estructurado para rich results de Google: FAQ, Artículo, Organización, Producto y más.

Procesamiento en tu navegador: tus datos estructurados se generan localmente. Ningún texto ni URL introducida se envía ni se almacena en nuestros servidores.
Revisión Técnica de Estándar · Última revisión: 29 de agosto de 2026Fuentes oficiales: Schema.org· Google Search Central
Datos del Esquema
Marcado JSON-LD

Guía Técnica Completa de Schema.org, JSON-LD y Datos Estructurados

Los datos estructurados son un formato estandarizado para clasificar y etiquetar el contenido de las páginas web, permitiendo que los rastreadores de motores de búsqueda (Googlebot, Bingbot), sistemas de inteligencia artificial y asistentes de voz comprendan las entidades y sus relaciones sin ambigüedad.

Aunque los buscadores cuentan con avanzados modelos de procesamiento del lenguaje natural (PLN), el marcado semántico mediante el vocabulario Schema.org codificado en JSON-LD declara de forma explícita qué representa el contenido (un artículo, una organización, un producto o un autor), eliminando conjeturas probabilísticas.

1. ¿Qué son los Datos Estructurados y el Vocabulario Schema.org?

Los datos estructurados son información organizada bajo un esquema común que aporta señales inequívocas sobre el significado de una página. El estándar universal de la web es Schema.org, una iniciativa colaborativa fundada en 2011 por Google, Microsoft (Bing), Yahoo y Yandex.

  • Taxonomía Universal: Schema.org incluye miles de Tipos (clases como Article, FAQPage, Product, LocalBusiness) y sus correspondientes Propiedades (atributos como headline, datePublished, author, offers).
  • Integración en Knowledge Graphs: Permite a los buscadores vincular tus páginas a sus grafos de conocimiento, consolidando la autoridad de marca, perfiles de autor y relaciones semánticas.

2. ¿Qué es JSON-LD y en qué se Diferencia de Schema.org?

Es fundamental no confundir vocabulario y formato:

  • Schema.org (El Vocabulario): Es el diccionario semántico que define el significado de los conceptos y sus atributos.
  • JSON-LD (La Sintaxis): Significa JavaScript Object Notation for Linked Data. Es el formato de serialización estándar del W3C para escribir datos vinculados en notación JSON limpia.
  • JSON-LD frente a Microdatos y RDFa: Los formatos antiguos (Microdatos y RDFa) obligaban a intercalar atributos dentro de las etiquetas HTML visuales (itemscope, itemprop), ensuciando el código y rompiéndose con facilidad al cambiar el diseño. JSON-LD aísla toda la información en un bloque independiente de script.

3. ¿Por qué y Cuándo Utilizar JSON-LD en tu Web?

Google declara formalmente a JSON-LD como su formato preferido para datos estructurados por múltiples motivos técnicos:

  • Independencia del Diseño: Puedes modificar libremente el HTML y el CSS de tu página sin riesgo de dañar el marcado semántico.
  • Generación Dinámica Sencilla: Es muy fácil de construir en el servidor mediante arrays de PHP (usando json_encode()) o inyectar mediante gestores de etiquetas y frameworks JavaScript.
  • Optimización para Motores de IA: Los nuevos motores de búsqueda generativa (Google AI Overviews, Perplexity, ChatGPT) analizan los bloques JSON-LD para extraer datos fácticos verificados con alta precisión.

4. Tipos de Schema Principales en la Web Moderna

Según el tipo de página y contenido, conviene aplicar distintos esquemas:

  • Article / BlogPosting: Para artículos de blog, noticias y tutoriales. Propiedades clave: headline, image, author, datePublished, dateModified, publisher.
  • Product: Para fichas de producto en tiendas online, indicando precio, moneda, disponibilidad (InStock/OutOfStock) y valoraciones de clientes.
  • Organization y Brand: Establece la identidad corporativa, logotipo oficial, URL de la empresa y perfiles en redes sociales.
  • LocalBusiness: Define negocios físicos, tiendas o clínicas, incluyendo dirección, horarios, coordenadas geográficas y teléfono.
  • BreadcrumbList: Representa la jerarquía de navegación y migas de pan, mejorando la visualización en los resultados de búsqueda.
  • FAQPage: Agrupa preguntas frecuentes con sus respuestas oficiales para un tema concreto.

5. Propiedades Obligatorias y Recomendadas

La documentación de motores de búsqueda divide los campos en dos niveles:

  • Propiedades Obligatorias: Campos sin los cuales el marcado es considerado inválido o incompleto (ej. headline e image en un Article; o acceptedAnswer con su text en una Question de FAQ).
  • Propiedades Recomendadas: Campos opcionales que enriquecen el contexto y aumentan la probabilidad de activar funciones visuales avanzadas (ej. dateModified, author.url, publisher.logo).

6. Principio de Paridad: Datos Visibles vs. Marcado Semántico

Las directrices de Google prohíben estrictamente el contenido engañoso u oculto. Todo dato declarado en el JSON-LD debe ser visible para los usuarios humanos en esa misma página.

  • Prácticas Prohibidas: Incluir preguntas de FAQ que no figuran en el texto visible, inventar valoraciones con estrellas falsas, declarar precios inferiores a los reales o insertar FAQs genéricas en páginas no relacionadas.
  • Riesgo de Acciones Manuales: Infringir las políticas de datos estructurados puede resultar en una sanción manual en Google Search Console, desactivando todos los fragmentos enriquecidos del dominio.

7. Errores Habituales de Sintaxis y Mantenimiento

Al generar o editar código JSON-LD, evita estos errores comunes:

  • Errores de Sintaxis: Comas sobrantes al final de arrays (,}), comillas dobles sin escapar dentro de textos o saltos de línea sin codificar.
  • Mayúsculas y Minúsculas: Escribir tipos o propiedades en minúsculas incorrectas (ej. @type: "faqpage" en vez de @type: "FAQPage").
  • Entidades Huérfanas: Declarar múltiples objetos sin enlazarlos adecuadamente mediante propiedades anidadas como mainEntity o publisher.
  • Desactualización: Olvidar actualizar la propiedad dateModified tras cambios editoriales importantes. Puedes verificar tu código en tiempo real con nuestro Validador de Schema JSON-LD.

8. Buscadores, Resultados Enriquecidos y Realismo SEO

Es esencial comprender el impacto real de los datos estructurados en el posicionamiento:

  • Sin Garantía Automática de Ranking: Implementar Schema no es un factor de ranking directo que garantice la primera posición. Su función principal es mejorar la comprensión algorítmica y habilitar la elegibilidad para resultados enriquecidos.
  • Criterio Algorítmico de Google: Aunque el marcado sea 100% válido, los algoritmos deciden si muestran o no fragmentos enriquecidos según la intención del usuario, la autoridad del dominio y el tipo de dispositivo.

Ejemplo Práctico

Ejemplo 1: Fragmento JSON-LD para FAQPage
Entrada: Pregunta: "¿Qué es Schema JSON-LD?" | Respuesta: "Un formato de datos estructurados recomendado por Google."
Resultado generado: {"@context":"https://schema.org","@type":"FAQPage","mainEntity":[{"@type":"Question","name":"¿Qué es Schema JSON-LD?","acceptedAnswer":{"@type":"Answer","text":"Un formato de datos estructurados recomendado por Google."}}]}

Estructura una pregunta y su respuesta aceptada bajo el tipo FAQPage. Observa el anidamiento 1:1 entre Question y acceptedAnswer.

Ejemplo 2: Fragmento JSON-LD para BlogPosting / Article
Entrada: Título: "Cómo Optimizar Core Web Vitals" | Autor: "Equipo SEO" | Fecha: "2026-08-29"
Resultado generado: {"@context":"https://schema.org","@type":"BlogPosting","headline":"Cómo Optimizar Core Web Vitals","author":[{"@type":"Person","name":"Equipo SEO"}],"datePublished":"2026-08-29"}

Declara los metadatos esenciales del artículo incluyendo titular, entidad de autor y fecha en formato ISO 8601.

Cómo Generar Marcado Schema JSON-LD en 4 Pasos

1

1. Selecciona el Tipo de Schema

Elige entre Preguntas Frecuentes (FAQPage) o Artículo de Blog (Article / BlogPosting) en el desplegable de opciones.

2

2. Rellena los Campos del Formulario

Introduce tus preguntas y respuestas en el panel FAQ, o indica el título, URL, autor, editor y fecha en el panel de artículo.

3

3. Revisa el Código JSON-LD en Vivo

Comprueba cómo se construye automáticamente el bloque de marcado en el panel de salida derecho.

4

4. Copia, Valida y Pega en el Head

Pulsa en "Copiar", comprueba el marcado en un validador de Schema y pega el fragmento dentro de la sección head de tu web.

Preguntas Frecuentes sobre Schema JSON-LD

¿Qué es JSON-LD y por qué es el formato recomendado por Google para datos estructurados?

JSON-LD (JavaScript Object Notation for Linked Data) es un estándar del W3C para serializar datos estructurados y vinculados. Google lo recomienda oficialmente como formato preferente porque se integra dentro de una etiqueta independiente de script, desacoplando completamente la semántica para motores de búsqueda del diseño visual HTML y evitando rupturas en el maquetado.

¿Cuál es la diferencia exacta entre Schema.org y JSON-LD?

Schema.org es el vocabulario semántico universal (el diccionario que define entidades como Article, Product, Organization y sus propiedades), mientras que JSON-LD es la sintaxis o formato de codificación utilizado para escribir ese vocabulario. Schema.org define el "qué significa" la información; JSON-LD define el "cómo se escribe" en el código.

¿Añadir marcado Schema garantiza resultados enriquecidos o mejores posiciones en Google?

No. Los datos estructurados facilitan a los motores de búsqueda la comprensión exacta del contenido y sus relaciones, pero no garantizan posiciones superiores ni la aparición automática de fragmentos enriquecidos (rich snippets). Los algoritmos de Google deciden si muestran elementos enriquecidos en función de la calidad del sitio, la intención de búsqueda y el cumplimiento de sus directrices.

¿Dónde se debe colocar la etiqueta de script JSON-LD en el código HTML?

Aunque técnicamente JSON-LD puede ubicarse en cualquier parte del documento HTML, la práctica estándar y recomendada es insertar el bloque de script dentro de la sección head de la página. También puede colocarse al final del body si se genera mediante gestores de etiquetas o scripts dinámicos.

¿Puede Google penalizar un sitio si el Schema no coincide con el texto visible?

Sí. Las directrices de calidad de Google exigen de forma estricta que todos los datos declarados en el marcado JSON-LD sean visibles y accesibles para los usuarios que visitan la página. Declarar información oculta, falsa, desactualizada o inexistente en la URL infringe las políticas contra spam y puede provocar una acción manual o la pérdida de visibilidad de fragmentos enriquecidos.

¿Cuáles son los errores sintácticos y de implementación más habituales en Schema?

Los fallos más comunes son errores de sintaxis JSON (comas sobrantes al final de arrays, comillas dobles sin escapar dentro de textos, llaves sin cerrar), tipografía incorrecta en tipos o propiedades (ejemplo: `@type: "faqpage"` en minúsculas en vez de `"FAQPage"`), ausencia de propiedades obligatorias (como `acceptedAnswer` en preguntas o `headline` en artículos) e imágenes no válidas.

¿Cuál es la directriz actual de Google respecto al marcado FAQPage?

En las directrices actuales de Google, los resultados enriquecidos visuales de FAQ se muestran de forma prioritaria en sitios institucionales, sanitarios y gubernamentales de alta autoridad. No obstante, implementar FAQPage sigue siendo muy beneficioso porque estructura las respuestas para motores de IA generativa, asistentes de voz y modelos LLM que rastrean la web.

¿Cómo puedo validar el marcado generado antes de publicarlo en mi web?

Una vez copiado el código generado, puedes comprobarlo en nuestro Validador de Schema JSON-LD, en la Prueba de Resultados Enriquecidos de Google (Rich Results Test) y en el Validador de Schema.org. Estas herramientas verifican la sintaxis JSON, detectan campos obligatorios ausentes y comprueban la idoneidad semántica del marcado.

Compartir esta herramienta

Ayuda a otras personas compartiendo esta herramienta gratuita.