Esquema JSON-LD explicado: cómo estructurar el conocimiento de tu marca para la IA

Los sistemas de IA como ChatGPT y Claude rastrean miles de millones de páginas web e intentan comprender qué hace cada marca, a quién sirven y cuándo son relevantes. Pero el HTML por sí solo es ambiguo: ¿es "Apple" la fruta o la empresa tecnológica? ¿Es "499 $" un precio, una estadística o simplemente texto? El marcado de esquema JSON-LD es la solución: datos estructurados que indican explícitamente a los sistemas de IA qué es su marca, qué ofrece y cómo se relaciona con el mundo.

Esquema JSON-LD explicado: cómo estructurar el conocimiento de tu marca para la IA

Publicado el

Autor

Jakon Langemark

Síguenos

LinkedIn

Esquema JSON-LD explicado: cómo estructurar el conocimiento de tu marca para la IA

Los sistemas de IA como ChatGPT y Claude rastrean miles de millones de páginas web e intentan comprender qué hace cada marca, a quién sirven y cuándo son relevantes. Pero el HTML por sí solo es ambiguo: ¿es "Apple" la fruta o la empresa tecnológica? ¿Es "499 $" un precio, una estadística o simplemente texto? El marcado de esquemas JSON-LD es la solución: datos estructurados que indican de forma explícita a los sistemas de IA qué es tu marca, qué ofreces y cómo te relacionas con el mundo.

Esta guía te ofrece una implementación concreta de JSON-LD para la visibilidad en la IA.

¿Qué es JSON-LD y por qué es importante?

JSON-LD significa "JavaScript Object Notation for Linked Data" (Notación de Objetos JavaScript para Datos Vinculados). Es un formato para incrustar datos estructurados y legibles por máquinas en tus páginas web.

Para la IA, esto significa:

  • Ausencia de ambigüedad: la IA sabe exactamente qué significan los datos

  • Contexto: la IA comprende las relaciones entre las entidades

  • Citas: la IA puede citarte correctamente con precisión fáctica

Ejemplo de la diferencia:

HTML (ambiguo):

<p>Entregamos software a hospitales en Dinamarca desde 2015.</p>
<p>Entregamos software a hospitales en Dinamarca desde 2015.</p>
<p>Entregamos software a hospitales en Dinamarca desde 2015.</p>

La IA debe adivinar: ¿es "2015" el año de fundación? ¿Son los "hospitales" tus clientes o tu área de enfoque?

JSON-LD (explícito):

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "HealthTech AS",
  "foundingDate": "2015",
  "areaServed": "DK",
  "customerType": "Hospital"
}
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "HealthTech AS",
  "foundingDate": "2015",
  "areaServed": "DK",
  "customerType": "Hospital"
}
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "HealthTech AS",
  "foundingDate": "2015",
  "areaServed": "DK",
  "customerType": "Hospital"
}

Ahora la IA sabe exactamente qué significa cada fragmento de datos.

Estructura básica de JSON-LD

Todos los bloques JSON-LD se colocan en <head> o al final de <body>:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "NombreTipo",
  "propiedad": "valor"
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "NombreTipo",
  "propiedad": "valor"
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "NombreTipo",
  "propiedad": "valor"
}
</script>

Componentes:

  • @context – Define el vocabulario (siempre "https://schema.org")

  • @type – ¿Qué es esta entidad? (Organización, Producto, Persona, etc.)

  • propiedad: valor – Atributos específicos

Esquema de Organización: la identidad principal de tu marca

Este es el esquema más importante para la visibilidad de la marca.

Esquema de Organización mínimo

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nombre de tu empresa",
  "url": "https://tusitioweb.com",
  "logo": "https://tusitioweb.com/logo.png",
  "description": "Hacemos X para Y"
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nombre de tu empresa",
  "url": "https://tusitioweb.com",
  "logo": "https://tusitioweb.com/logo.png",
  "description": "Hacemos X para Y"
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nombre de tu empresa",
  "url": "https://tusitioweb.com",
  "logo": "https://tusitioweb.com/logo.png",
  "description": "Hacemos X para Y"
}
</script>

Esquema de Organización completo

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nordic SaaS Solutions",
  "alternateName": "NordicSaaS",
  "url": "https://nordicsaas.dk",
  "logo": {
    "@type": "ImageObject",
    "url": "https://nordicsaas.dk/logo.png",
    "width": 600,
    "height": 60
  },
  "description": "Entregamos software CRM empresarial a empresas B2B escandinavas con 50-500 empleados.",
  "foundingDate": "2018",
  "founders": [
    {
      "@type": "Person",
      "name": "Jane Doe",
      "jobTitle": "CEO"
    }
  ],
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Nørregade 10",
    "addressLocality": "Copenhague",
    "postalCode": "1165",
    "addressCountry": "DK"
  },
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+45-12-34-56-78",
    "contactType": "Soporte al cliente",
    "areaServed": "DK",
    "availableLanguage": ["Danés", "Inglés"]
  },
  "sameAs": [
    "https://www.linkedin.com/company/nordicsaas",
    "https://twitter.com/nordicsaas",
    "https://www.crunchbase.com/organization/nordicsaas"
  ],
  "numberOfEmployees": {
    "@type": "QuantitativeValue",
    "value": 25
  },
  "slogan": "CRM diseñado para empresas nórdicas"
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nordic SaaS Solutions",
  "alternateName": "NordicSaaS",
  "url": "https://nordicsaas.dk",
  "logo": {
    "@type": "ImageObject",
    "url": "https://nordicsaas.dk/logo.png",
    "width": 600,
    "height": 60
  },
  "description": "Entregamos software CRM empresarial a empresas B2B escandinavas con 50-500 empleados.",
  "foundingDate": "2018",
  "founders": [
    {
      "@type": "Person",
      "name": "Jane Doe",
      "jobTitle": "CEO"
    }
  ],
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Nørregade 10",
    "addressLocality": "Copenhague",
    "postalCode": "1165",
    "addressCountry": "DK"
  },
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+45-12-34-56-78",
    "contactType": "Soporte al cliente",
    "areaServed": "DK",
    "availableLanguage": ["Danés", "Inglés"]
  },
  "sameAs": [
    "https://www.linkedin.com/company/nordicsaas",
    "https://twitter.com/nordicsaas",
    "https://www.crunchbase.com/organization/nordicsaas"
  ],
  "numberOfEmployees": {
    "@type": "QuantitativeValue",
    "value": 25
  },
  "slogan": "CRM diseñado para empresas nórdicas"
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nordic SaaS Solutions",
  "alternateName": "NordicSaaS",
  "url": "https://nordicsaas.dk",
  "logo": {
    "@type": "ImageObject",
    "url": "https://nordicsaas.dk/logo.png",
    "width": 600,
    "height": 60
  },
  "description": "Entregamos software CRM empresarial a empresas B2B escandinavas con 50-500 empleados.",
  "foundingDate": "2018",
  "founders": [
    {
      "@type": "Person",
      "name": "Jane Doe",
      "jobTitle": "CEO"
    }
  ],
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Nørregade 10",
    "addressLocality": "Copenhague",
    "postalCode": "1165",
    "addressCountry": "DK"
  },
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+45-12-34-56-78",
    "contactType": "Soporte al cliente",
    "areaServed": "DK",
    "availableLanguage": ["Danés", "Inglés"]
  },
  "sameAs": [
    "https://www.linkedin.com/company/nordicsaas",
    "https://twitter.com/nordicsaas",
    "https://www.crunchbase.com/organization/nordicsaas"
  ],
  "numberOfEmployees": {
    "@type": "QuantitativeValue",
    "value": 25
  },
  "slogan": "CRM diseñado para empresas nórdicas"
}
</script>

¿Qué campos importan más para la IA?

  1. description (descripción) – ¿Qué haces? ¿Para quién?

  2. sameAs (mismoAs) – Los enlaces a LinkedIn, Crunchbase y Twitter refuerzan la autoridad

  3. contactPoint (puntoDeContacto) – Te hace localizable

  4. address (dirección) – Contexto geográfico

Esquema de Producto: haz que tus productos sean citables

Si la IA va a recomendar tu producto, necesita saber qué es, cuánto cuesta y para quién es.

Producto de comercio electrónico

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ErgoDesk Pro",
  "description": "Escritorio regulable en altura con cargador inalámbrico integrado y función de memoria. Ideal para oficinas en casa y pequeñas empresas.",
  "brand": {
    "@type": "Brand",
    "name": "ErgoFurniture"
  },
  "image": "https://ergofurniture.dk/images/ergodesk-pro.jpg",
  "sku": "ERG-DESK-PRO-01",
  "offers": {
    "@type": "Offer",
    "url": "https://ergofurniture.dk/products/ergodesk-pro",
    "priceCurrency": "DKK",
    "price": "4999.00",
    "priceValidUntil": "2024-12-31",
    "availability": "https://schema.org/InStock",
    "seller": {
      "@type": "Organization",
      "name": "ErgoFurniture"
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "143"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ErgoDesk Pro",
  "description": "Escritorio regulable en altura con cargador inalámbrico integrado y función de memoria. Ideal para oficinas en casa y pequeñas empresas.",
  "brand": {
    "@type": "Brand",
    "name": "ErgoFurniture"
  },
  "image": "https://ergofurniture.dk/images/ergodesk-pro.jpg",
  "sku": "ERG-DESK-PRO-01",
  "offers": {
    "@type": "Offer",
    "url": "https://ergofurniture.dk/products/ergodesk-pro",
    "priceCurrency": "DKK",
    "price": "4999.00",
    "priceValidUntil": "2024-12-31",
    "availability": "https://schema.org/InStock",
    "seller": {
      "@type": "Organization",
      "name": "ErgoFurniture"
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "143"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ErgoDesk Pro",
  "description": "Escritorio regulable en altura con cargador inalámbrico integrado y función de memoria. Ideal para oficinas en casa y pequeñas empresas.",
  "brand": {
    "@type": "Brand",
    "name": "ErgoFurniture"
  },
  "image": "https://ergofurniture.dk/images/ergodesk-pro.jpg",
  "sku": "ERG-DESK-PRO-01",
  "offers": {
    "@type": "Offer",
    "url": "https://ergofurniture.dk/products/ergodesk-pro",
    "priceCurrency": "DKK",
    "price": "4999.00",
    "priceValidUntil": "2024-12-31",
    "availability": "https://schema.org/InStock",
    "seller": {
      "@type": "Organization",
      "name": "ErgoFurniture"
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "143"
  }
}
</script>

Producto SaaS

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "TaskFlow",
  "applicationCategory": "BusinessApplication",
  "description": "Software de gestión de proyectos para agencias de marketing. Gestiona proyectos de clientes, partes de horas y facturación.",
  "operatingSystem": "Basado en web",
  "offers": {
    "@type": "Offer",
    "price": "299.00",
    "priceCurrency": "DKK",
    "priceSpecification": {
      "@type": "UnitPriceSpecification",
      "price": "299.00",
      "priceCurrency": "DKK",
      "billingDuration": "P1M",
      "billingIncrement": 1
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.5",
    "ratingCount": "89"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "TaskFlow",
  "applicationCategory": "BusinessApplication",
  "description": "Software de gestión de proyectos para agencias de marketing. Gestiona proyectos de clientes, partes de horas y facturación.",
  "operatingSystem": "Basado en web",
  "offers": {
    "@type": "Offer",
    "price": "299.00",
    "priceCurrency": "DKK",
    "priceSpecification": {
      "@type": "UnitPriceSpecification",
      "price": "299.00",
      "priceCurrency": "DKK",
      "billingDuration": "P1M",
      "billingIncrement": 1
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.5",
    "ratingCount": "89"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "TaskFlow",
  "applicationCategory": "BusinessApplication",
  "description": "Software de gestión de proyectos para agencias de marketing. Gestiona proyectos de clientes, partes de horas y facturación.",
  "operatingSystem": "Basado en web",
  "offers": {
    "@type": "Offer",
    "price": "299.00",
    "priceCurrency": "DKK",
    "priceSpecification": {
      "@type": "UnitPriceSpecification",
      "price": "299.00",
      "priceCurrency": "DKK",
      "billingDuration": "P1M",
      "billingIncrement": 1
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.5",
    "ratingCount": "89"
  }
}
</script>

La IA ahora puede responder:

"Para la gestión de proyectos en agencias de marketing recomiendo TaskFlow. Cuesta 299 DKK/mes y tiene una valoración de 4,5/5 basada en 89 opiniones."

Esquema de Servicio: para empresas basadas en servicios

Si vendes servicios (consultoría, agencia, SaaS), utiliza el esquema de Servicio.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Service",
  "serviceType": "Consultoría SEO",
  "provider": {
    "@type": "Organization",
    "name": "Nordic SEO Agency"
  },
  "areaServed": {
    "@type": "Country",
    "name": "Dinamarca"
  },
  "hasOfferCatalog": {
    "@type": "OfferCatalog",
    "name": "Servicios SEO",
    "itemListElement": [
      {
        "@type": "Offer",
        "itemOffered": {
          "@type": "Service",
          "name": "Auditoría SEO técnica",
          "description": "Análisis exhaustivo de rastreabilidad e indexación"
        }
      },
      {
        "@type": "Offer",
        "itemOffered": {
          "@type": "Service",
          "name": "Estrategia de contenido",
          "description": "Investigación de palabras clave y planificación de contenido"
        }
      }
    ]
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Service",
  "serviceType": "Consultoría SEO",
  "provider": {
    "@type": "Organization",
    "name": "Nordic SEO Agency"
  },
  "areaServed": {
    "@type": "Country",
    "name": "Dinamarca"
  },
  "hasOfferCatalog": {
    "@type": "OfferCatalog",
    "name": "Servicios SEO",
    "itemListElement": [
      {
        "@type": "Offer",
        "itemOffered": {
          "@type": "Service",
          "name": "Auditoría SEO técnica",
          "description": "Análisis exhaustivo de rastreabilidad e indexación"
        }
      },
      {
        "@type": "Offer",
        "itemOffered": {
          "@type": "Service",
          "name": "Estrategia de contenido",
          "description": "Investigación de palabras clave y planificación de contenido"
        }
      }
    ]
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Service",
  "serviceType": "Consultoría SEO",
  "provider": {
    "@type": "Organization",
    "name": "Nordic SEO Agency"
  },
  "areaServed": {
    "@type": "Country",
    "name": "Dinamarca"
  },
  "hasOfferCatalog": {
    "@type": "OfferCatalog",
    "name": "Servicios SEO",
    "itemListElement": [
      {
        "@type": "Offer",
        "itemOffered": {
          "@type": "Service",
          "name": "Auditoría SEO técnica",
          "description": "Análisis exhaustivo de rastreabilidad e indexación"
        }
      },
      {
        "@type": "Offer",
        "itemOffered": {
          "@type": "Service",
          "name": "Estrategia de contenido",
          "description": "Investigación de palabras clave y planificación de contenido"
        }
      }
    ]
  }
}
</script>

Esquema de Artículo: para publicaciones de blog y contenido

Los sistemas de IA suelen citar publicaciones de blog. Haz que sean citables con el esquema de Artículo.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Cómo optimizar tu sitio web para la visibilidad en la IA",
  "description": "Una guía completa para hacer que tu marca sea visible en ChatGPT, Claude y Perplexity.",
  "image": "https://tusitioweb.com/images/ai-visibility-guide.jpg",
  "author": {
    "@type": "Person",
    "name": "Jane Doe",
    "url": "https://tusitioweb.com/authors/jane-doe",
    "jobTitle": "Especialista en SEO",
    "sameAs": [
      "https://linkedin.com/in/janedoe",
      "https://twitter.com/janedoe"
    ]
  },
  "publisher": {
    "@type": "Organization",
    "name": "Nordic SaaS Solutions",
    "logo": {
      "@type": "ImageObject",
      "url": "https://nordicsaas.dk/logo.png"
    }
  },
  "datePublished": "2024-01-15",
  "dateModified": "2024-01-20",
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://tusitioweb.com/blog/ai-visibility-guide"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Cómo optimizar tu sitio web para la visibilidad en la IA",
  "description": "Una guía completa para hacer que tu marca sea visible en ChatGPT, Claude y Perplexity.",
  "image": "https://tusitioweb.com/images/ai-visibility-guide.jpg",
  "author": {
    "@type": "Person",
    "name": "Jane Doe",
    "url": "https://tusitioweb.com/authors/jane-doe",
    "jobTitle": "Especialista en SEO",
    "sameAs": [
      "https://linkedin.com/in/janedoe",
      "https://twitter.com/janedoe"
    ]
  },
  "publisher": {
    "@type": "Organization",
    "name": "Nordic SaaS Solutions",
    "logo": {
      "@type": "ImageObject",
      "url": "https://nordicsaas.dk/logo.png"
    }
  },
  "datePublished": "2024-01-15",
  "dateModified": "2024-01-20",
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://tusitioweb.com/blog/ai-visibility-guide"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Cómo optimizar tu sitio web para la visibilidad en la IA",
  "description": "Una guía completa para hacer que tu marca sea visible en ChatGPT, Claude y Perplexity.",
  "image": "https://tusitioweb.com/images/ai-visibility-guide.jpg",
  "author": {
    "@type": "Person",
    "name": "Jane Doe",
    "url": "https://tusitioweb.com/authors/jane-doe",
    "jobTitle": "Especialista en SEO",
    "sameAs": [
      "https://linkedin.com/in/janedoe",
      "https://twitter.com/janedoe"
    ]
  },
  "publisher": {
    "@type": "Organization",
    "name": "Nordic SaaS Solutions",
    "logo": {
      "@type": "ImageObject",
      "url": "https://nordicsaas.dk/logo.png"
    }
  },
  "datePublished": "2024-01-15",
  "dateModified": "2024-01-20",
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://tusitioweb.com/blog/ai-visibility-guide"
  }
}
</script>

Por qué es importante:

  • La IA puede citar al autor correctamente

  • La fecha de publicación muestra la frescura de la información

  • El editor establece la autoridad

Esquema de Página de Preguntas Frecuentes (FAQPage): haz que tus preguntas frecuentes sean directamente citables

Esta es una mina de oro para la visibilidad en la IA.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "¿Cuánto cuesta TaskFlow?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "TaskFlow cuesta 299 DKK/mes por usuario con un mínimo de 3 usuarios. También ofrecemos un plan Enterprise a 199 DKK/usuario para equipos de más de 20 personas."
      }
    },
    {
      "@type": "Question",
      "name": "¿Qué integraciones admite TaskFlow?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "TaskFlow se integra con Slack, Google Calendar, Trello, Asana y todos los principales sistemas de contabilidad, incluidos Dinero y Billy."
      }
    },
    {
      "@type": "Question",
      "name": "¿Es TaskFlow adecuado para equipos remotos?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sí, TaskFlow está diseñado para equipos que priorizan el trabajo en remoto. Incluye control de tiempo, comunicación asíncrona y videoconferencia integrada."
      }
    }
  ]
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "¿Cuánto cuesta TaskFlow?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "TaskFlow cuesta 299 DKK/mes por usuario con un mínimo de 3 usuarios. También ofrecemos un plan Enterprise a 199 DKK/usuario para equipos de más de 20 personas."
      }
    },
    {
      "@type": "Question",
      "name": "¿Qué integraciones admite TaskFlow?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "TaskFlow se integra con Slack, Google Calendar, Trello, Asana y todos los principales sistemas de contabilidad, incluidos Dinero y Billy."
      }
    },
    {
      "@type": "Question",
      "name": "¿Es TaskFlow adecuado para equipos remotos?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sí, TaskFlow está diseñado para equipos que priorizan el trabajo en remoto. Incluye control de tiempo, comunicación asíncrona y videoconferencia integrada."
      }
    }
  ]
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "¿Cuánto cuesta TaskFlow?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "TaskFlow cuesta 299 DKK/mes por usuario con un mínimo de 3 usuarios. También ofrecemos un plan Enterprise a 199 DKK/usuario para equipos de más de 20 personas."
      }
    },
    {
      "@type": "Question",
      "name": "¿Qué integraciones admite TaskFlow?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "TaskFlow se integra con Slack, Google Calendar, Trello, Asana y todos los principales sistemas de contabilidad, incluidos Dinero y Billy."
      }
    },
    {
      "@type": "Question",
      "name": "¿Es TaskFlow adecuado para equipos remotos?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sí, TaskFlow está diseñado para equipos que priorizan el trabajo en remoto. Incluye control de tiempo, comunicación asíncrona y videoconferencia integrada."
      }
    }
  ]
}
</script>

Resultado: cuando alguien pregunte "¿Cuánto cuesta TaskFlow?", la IA podrá citarte directamente con precios precisos.

Esquema de Instrucciones (HowTo): para guías y tutoriales

Si creas tutoriales o contenido explicativo, utiliza el esquema HowTo.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "Cómo implementar JSON-LD en tu sitio web",
  "description": "Una guía paso a paso para añadir datos estructurados a tu sitio web.",
  "totalTime": "PT30M",
  "step": [
    {
      "@type": "HowToStep",
      "name": "Identifica qué esquemas necesitas",
      "text": "Determina si tu sitio web se basa principalmente en Organización, Producto, Artículo o Servicio.",
      "position": 1
    },
    {
      "@type": "HowToStep",
      "name": "Crea el bloque JSON-LD",
      "text": "Añade una etiqueta <script type='application/ld+json'> en tu sección <head>.",
      "position": 2
    },
    {
      "@type": "HowToStep",
      "name": "Valida con la prueba de resultados enriquecidos de Google",
      "text": "Prueba tu implementación en https://search.google.com/test/rich-results",
      "position": 3
    }
  ]
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "Cómo implementar JSON-LD en tu sitio web",
  "description": "Una guía paso a paso para añadir datos estructurados a tu sitio web.",
  "totalTime": "PT30M",
  "step": [
    {
      "@type": "HowToStep",
      "name": "Identifica qué esquemas necesitas",
      "text": "Determina si tu sitio web se basa principalmente en Organización, Producto, Artículo o Servicio.",
      "position": 1
    },
    {
      "@type": "HowToStep",
      "name": "Crea el bloque JSON-LD",
      "text": "Añade una etiqueta <script type='application/ld+json'> en tu sección <head>.",
      "position": 2
    },
    {
      "@type": "HowToStep",
      "name": "Valida con la prueba de resultados enriquecidos de Google",
      "text": "Prueba tu implementación en https://search.google.com/test/rich-results",
      "position": 3
    }
  ]
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "Cómo implementar JSON-LD en tu sitio web",
  "description": "Una guía paso a paso para añadir datos estructurados a tu sitio web.",
  "totalTime": "PT30M",
  "step": [
    {
      "@type": "HowToStep",
      "name": "Identifica qué esquemas necesitas",
      "text": "Determina si tu sitio web se basa principalmente en Organización, Producto, Artículo o Servicio.",
      "position": 1
    },
    {
      "@type": "HowToStep",
      "name": "Crea el bloque JSON-LD",
      "text": "Añade una etiqueta <script type='application/ld+json'> en tu sección <head>.",
      "position": 2
    },
    {
      "@type": "HowToStep",
      "name": "Valida con la prueba de resultados enriquecidos de Google",
      "text": "Prueba tu implementación en https://search.google.com/test/rich-results",
      "position": 3
    }
  ]
}
</script>

Esquema de Reseñas y Valoraciones: prueba social

Las reseñas ayudan a la IA a evaluar la credibilidad.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ErgoDesk Pro",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "143",
    "bestRating": "5",
    "worstRating": "1"
  },
  "review": [
    {
      "@type": "Review",
      "author": {
        "@type": "Person",
        "name": "Lars Nielsen"
      },
      "datePublished": "2024-01-10",
      "reviewBody": "Escritorio fantástico. El motor es silencioso y la función de memoria funciona perfectamente. Muy recomendable para oficinas en casa.",
      "reviewRating": {
        "@type": "Rating",
        "ratingValue": "5",
        "bestRating": "5"
      }
    }
  ]
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ErgoDesk Pro",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "143",
    "bestRating": "5",
    "worstRating": "1"
  },
  "review": [
    {
      "@type": "Review",
      "author": {
        "@type": "Person",
        "name": "Lars Nielsen"
      },
      "datePublished": "2024-01-10",
      "reviewBody": "Escritorio fantástico. El motor es silencioso y la función de memoria funciona perfectamente. Muy recomendable para oficinas en casa.",
      "reviewRating": {
        "@type": "Rating",
        "ratingValue": "5",
        "bestRating": "5"
      }
    }
  ]
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ErgoDesk Pro",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "143",
    "bestRating": "5",
    "worstRating": "1"
  },
  "review": [
    {
      "@type": "Review",
      "author": {
        "@type": "Person",
        "name": "Lars Nielsen"
      },
      "datePublished": "2024-01-10",
      "reviewBody": "Escritorio fantástico. El motor es silencioso y la función de memoria funciona perfectamente. Muy recomendable para oficinas en casa.",
      "reviewRating": {
        "@type": "Rating",
        "ratingValue": "5",
        "bestRating": "5"
      }
    }
  ]
}
</script>

Avanzado: entidades anidadas y relacionadas

Puedes conectar múltiples esquemas para crear un contexto más rico.

Organización con Personas

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nordic SaaS Solutions",
  "employee": [
    {
      "@type": "Person",
      "name": "Jane Doe",
      "jobTitle": "CEO",
      "sameAs": "https://linkedin.com/in/janedoe"
    },
    {
      "@type": "Person",
      "name": "John Smith",
      "jobTitle": "CTO",
      "sameAs": "https://linkedin.com/in/johnsmith"
    }
  ],
  "founder": {
    "@type": "Person",
    "name": "Jane Doe"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nordic SaaS Solutions",
  "employee": [
    {
      "@type": "Person",
      "name": "Jane Doe",
      "jobTitle": "CEO",
      "sameAs": "https://linkedin.com/in/janedoe"
    },
    {
      "@type": "Person",
      "name": "John Smith",
      "jobTitle": "CTO",
      "sameAs": "https://linkedin.com/in/johnsmith"
    }
  ],
  "founder": {
    "@type": "Person",
    "name": "Jane Doe"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nordic SaaS Solutions",
  "employee": [
    {
      "@type": "Person",
      "name": "Jane Doe",
      "jobTitle": "CEO",
      "sameAs": "https://linkedin.com/in/janedoe"
    },
    {
      "@type": "Person",
      "name": "John Smith",
      "jobTitle": "CTO",
      "sameAs": "https://linkedin.com/in/johnsmith"
    }
  ],
  "founder": {
    "@type": "Person",
    "name": "Jane Doe"
  }
}
</script>

Producto con Marca y Fabricante

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ErgoChair Pro",
  "brand": {
    "@type": "Brand",
    "name": "ErgoFurniture",
    "logo": "https://ergofurniture.dk/logo.png"
  },
  "manufacturer": {
    "@type": "Organization",
    "name": "Nordic Manufacturing AS",
    "address": {
      "@type": "PostalAddress",
      "addressCountry": "NO"
    }
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ErgoChair Pro",
  "brand": {
    "@type": "Brand",
    "name": "ErgoFurniture",
    "logo": "https://ergofurniture.dk/logo.png"
  },
  "manufacturer": {
    "@type": "Organization",
    "name": "Nordic Manufacturing AS",
    "address": {
      "@type": "PostalAddress",
      "addressCountry": "NO"
    }
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ErgoChair Pro",
  "brand": {
    "@type": "Brand",
    "name": "ErgoFurniture",
    "logo": "https://ergofurniture.dk/logo.png"
  },
  "manufacturer": {
    "@type": "Organization",
    "name": "Nordic Manufacturing AS",
    "address": {
      "@type": "PostalAddress",
      "addressCountry": "NO"
    }
  }
}
</script>

Mejores prácticas de implementación

1. Coloca JSON-LD en <head> o al final de <body>

Ubicación recomendada:

<!DOCTYPE html>
<html>
<head>
  <title>Mi página</title>
  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "Organization",
    "name": "Mi empresa"
  }
  </script>
</head>
<body>
  <!-- Contenido -->
</body>
</html>
<!DOCTYPE html>
<html>
<head>
  <title>Mi página</title>
  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "Organization",
    "name": "Mi empresa"
  }
  </script>
</head>
<body>
  <!-- Contenido -->
</body>
</html>
<!DOCTYPE html>
<html>
<head>
  <title>Mi página</title>
  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "Organization",
    "name": "Mi empresa"
  }
  </script>
</head>
<body>
  <!-- Contenido -->
</body>
</html>

2. Utiliza solo un @context por bloque

Incorrecto:

{
  "@context": "https://schema.org",
  "@context": "https://example.com",  // ¡Duplicado!
  "@type": "Organization"
}
{
  "@context": "https://schema.org",
  "@context": "https://example.com",  // ¡Duplicado!
  "@type": "Organization"
}
{
  "@context": "https://schema.org",
  "@context": "https://example.com",  // ¡Duplicado!
  "@type": "Organization"
}

Correcto:

{
  "@context": "https://schema.org",
  "@type": "Organization"
}
{
  "@context": "https://schema.org",
  "@type": "Organization"
}
{
  "@context": "https://schema.org",
  "@type": "Organization"
}

3. Evita las fechas codificadas de forma fija (hardcoded)

Utiliza fechas dinámicas para dateModified y lastmod:

"dateModified": "<?php echo date('Y-m-d');
"dateModified": "<?php echo date('Y-m-d');
"dateModified": "<?php echo date('Y-m-d');
"dateModified": f"{datetime.now().strftime('%Y-%m-%d')}"
"dateModified": f"{datetime.now().strftime('%Y-%m-%d')}"
"dateModified": f"{datetime.now().strftime('%Y-%m-%d')}"

4. Incluye únicamente información fáctica

Evita exageraciones o adornos de marketing:

Mal:

"description": "¡El mejor producto del mundo, el más innovador y revolucionario!"
"description": "¡El mejor producto del mundo, el más innovador y revolucionario!"
"description": "¡El mejor producto del mundo, el más innovador y revolucionario!"

Bien:

"description": "Software de gestión de proyectos para agencias de marketing con control de tiempo y facturación integrados."
"description": "Software de gestión de proyectos para agencias de marketing con control de tiempo y facturación integrados."
"description": "Software de gestión de proyectos para agencias de marketing con control de tiempo y facturación integrados."

5. Utiliza sameAs para conectar perfiles externos

"sameAs": [
  "https://www.linkedin.com/company/tuempresa",
  "https://twitter.com/tuempresa",
  "https://www.crunchbase.com/organization/tuempresa",
  "https://es.wikipedia.org/wiki/TuEmpresa"
]
"sameAs": [
  "https://www.linkedin.com/company/tuempresa",
  "https://twitter.com/tuempresa",
  "https://www.crunchbase.com/organization/tuempresa",
  "https://es.wikipedia.org/wiki/TuEmpresa"
]
"sameAs": [
  "https://www.linkedin.com/company/tuempresa",
  "https://twitter.com/tuempresa",
  "https://www.crunchbase.com/organization/tuempresa",
  "https://es.wikipedia.org/wiki/TuEmpresa"
]

La IA utiliza estos enlaces para contrastar la información y establecer autoridad.

Pruebas y validación

Prueba de resultados enriquecidos de Google

  1. Ve a https://search.google.com/test/rich-results

  2. Introduce tu URL o pega el JSON-LD directamente

  3. Comprueba si hay errores o advertencias

Validador de Schema.org

  1. Ve a https://validator.schema.org/

  2. Pega tu JSON-LD

  3. Verifica que sea un esquema válido

JSON Lint (comprobación de sintaxis)

  1. Ve a https://jsonlint.com/

  2. Pega tu JSON-LD

  3. Comprueba si hay errores de sintaxis (comas o corchetes faltantes, etc.)

Prueba manual con navegador

# Ver el código fuente y buscar "application/ld+json"
curl https://tusitioweb.com/ | grep -A 20 "application/ld+json"
# Ver el código fuente y buscar "application/ld+json"
curl https://tusitioweb.com/ | grep -A 20 "application/ld+json"
# Ver el código fuente y buscar "application/ld+json"
curl https://tusitioweb.com/ | grep -A 20 "application/ld+json"

Errores comunes y soluciones

Error

Síntoma

Solución

Coma faltante

Error de análisis de JSON

Utiliza JSON Lint para encontrar el error

@type incorrecto

Advertencias en los validadores

Comprueba los tipos de schema.org

URL relativas

Advertencias

Utiliza siempre URL absolutas (https://...)

@context duplicado

Errores de análisis

Un @context por bloque

Problemas con comillas escapadas

El JSON no se analiza

Utiliza \" para las comillas dentro de las cadenas

Demasiados datos anidados

Ilegible para la IA

Mantén los esquemas simples y enfocados

Lista de verificación de la implementación

Utiliza esta lista de verificación para implementar JSON-LD:

  1. Identifica el tipo de esquema principal – ¿Organización, Producto, Servicio o Artículo?

  2. Implementa el esquema de Organización – En la página de inicio

  3. Añade esquemas de Producto/Servicio – En las páginas relevantes

  4. Implementa el esquema de Artículo – En todas las publicaciones del blog

  5. Crea el esquema de FAQPage – En las páginas de preguntas frecuentes

  6. Añade esquemas de Reseñas – Si tienes opiniones de clientes

  7. Anida entidades relacionadas – Conecta esquemas donde sea relevante

  8. Prueba con validadores – Resultados enriquecidos de Google + Schema.org

  9. Verifica la sintaxis de JSON – Utiliza JSON Lint

  10. Monitorea tras la implementación – Comprueba que se muestre correctamente en el código fuente

Conclusión

El marcado de esquemas JSON-LD es la forma más directa de comunicarse con los sistemas de IA. Mientras que el HTML es ambiguo y requiere interpretación, el JSON-LD es explícito y claro. Suele llevar entre 2 y 4 horas implementar esquemas básicos en un sitio web, pero el efecto en la visibilidad para la IA es muy significativo.

Comienza con el esquema de Organización en tu página de inicio, añade esquemas de Producto/Servicio en las páginas relevantes y continúa desde ahí con los esquemas de Artículo y Preguntas Frecuentes. Realiza siempre pruebas con validadores y actualiza los datos cuando tu marca cambie.

Recuerda: JSON-LD no sirve solo para el SEO, sino que es la base de cómo la IA comprende y representa tu marca.

‹ Pequeños detalles que afectan a la credibilidad técnica

¿Es este el fin de la USP? ›