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 su 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.

Esta guía le ofrece una implementación concreta de JSON-LD para la visibilidad de 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 sus páginas web.

Para la IA 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 citarlo 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" sus clientes o su á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 dato.

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": "TypeName",
  "property": "value"
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "TypeName",
  "property": "value"
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "TypeName",
  "property": "value"
}
</script>

Componentes:

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

  • @type – ¿Qué es esta entidad? (Organization, Product, Person, etc.)

  • property: value – Atributos específicos

Esquema de Organización: La identidad central de su marca

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

Esquema mínimo de organización

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

Esquema completo de organización

<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 un rango de 50 a 500 empleados.",
  "foundingDate": "2018",
  "founders": [
    {
      "@type": "Person",
      "name": "Jane Doe",
      "jobTitle": "CEO"
    }
  ],
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Nørregade 10",
    "addressLocality": "København",
    "postalCode": "1165",
    "addressCountry": "DK"
  },
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+45-12-34-56-78",
    "contactType": "Atención al Cliente",
    "areaServed": "DK",
    "availableLanguage": ["Danish", "English"]
  },
  "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 un rango de 50 a 500 empleados.",
  "foundingDate": "2018",
  "founders": [
    {
      "@type": "Person",
      "name": "Jane Doe",
      "jobTitle": "CEO"
    }
  ],
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Nørregade 10",
    "addressLocality": "København",
    "postalCode": "1165",
    "addressCountry": "DK"
  },
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+45-12-34-56-78",
    "contactType": "Atención al Cliente",
    "areaServed": "DK",
    "availableLanguage": ["Danish", "English"]
  },
  "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 un rango de 50 a 500 empleados.",
  "foundingDate": "2018",
  "founders": [
    {
      "@type": "Person",
      "name": "Jane Doe",
      "jobTitle": "CEO"
    }
  ],
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Nørregade 10",
    "addressLocality": "København",
    "postalCode": "1165",
    "addressCountry": "DK"
  },
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+45-12-34-56-78",
    "contactType": "Atención al Cliente",
    "areaServed": "DK",
    "availableLanguage": ["Danish", "English"]
  },
  "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 – ¿Qué hace? ¿Para quién?

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

  3. contactPoint – Hace que le puedan encontrar

  4. address – Contexto geográfico

Esquema de Producto: Haga que sus productos sean citables

Si la IA va a recomendar su 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, hojas 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, hojas 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, hojas 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 calificación de 4.5/5 basada en 89 opiniones."

Esquema de Servicio: Para empresas basadas en servicios

Si vende servicios (consultoría, agencia, SaaS), utilice el esquema Service.

<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": "Denmark"
  },
  "hasOfferCatalog": {
    "@type": "OfferCatalog",
    "name": "Servicios de 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": "Denmark"
  },
  "hasOfferCatalog": {
    "@type": "OfferCatalog",
    "name": "Servicios de 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": "Denmark"
  },
  "hasOfferCatalog": {
    "@type": "OfferCatalog",
    "name": "Servicios de 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 a menudo citan publicaciones de blog. Hágalas citables con el esquema Article.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Cómo optimizar su sitio web para la visibilidad de la IA",
  "description": "Una guía completa para hacer visible su marca en ChatGPT, Claude y Perplexity.",
  "image": "https://susitioweb.com/images/ai-visibility-guide.jpg",
  "author": {
    "@type": "Person",
    "name": "Jane Doe",
    "url": "https://susitioweb.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://susitioweb.com/blog/ai-visibility-guide"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Cómo optimizar su sitio web para la visibilidad de la IA",
  "description": "Una guía completa para hacer visible su marca en ChatGPT, Claude y Perplexity.",
  "image": "https://susitioweb.com/images/ai-visibility-guide.jpg",
  "author": {
    "@type": "Person",
    "name": "Jane Doe",
    "url": "https://susitioweb.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://susitioweb.com/blog/ai-visibility-guide"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Cómo optimizar su sitio web para la visibilidad de la IA",
  "description": "Una guía completa para hacer visible su marca en ChatGPT, Claude y Perplexity.",
  "image": "https://susitioweb.com/images/ai-visibility-guide.jpg",
  "author": {
    "@type": "Person",
    "name": "Jane Doe",
    "url": "https://susitioweb.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://susitioweb.com/blog/ai-visibility-guide"
  }
}
</script>

Por qué es importante:

  • La IA puede citar correctamente al autor

  • La fecha de publicación demuestra frescura

  • El editor establece la autoridad

Esquema de FAQPage: Haga que sus preguntas frecuentes sean citables directamente

Esto 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 los principales sistemas contables, incluidos Dinero y Billy."
      }
    },
    {
      "@type": "Question",
      "name": "¿Es TaskFlow adecuado para equipos remotos?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sí, TaskFlow está diseñado para equipos prioritariamente remotos. 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 los principales sistemas contables, incluidos Dinero y Billy."
      }
    },
    {
      "@type": "Question",
      "name": "¿Es TaskFlow adecuado para equipos remotos?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sí, TaskFlow está diseñado para equipos prioritariamente remotos. 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 los principales sistemas contables, incluidos Dinero y Billy."
      }
    },
    {
      "@type": "Question",
      "name": "¿Es TaskFlow adecuado para equipos remotos?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sí, TaskFlow está diseñado para equipos prioritariamente remotos. Incluye control de tiempo, comunicación asíncrona y videoconferencia integrada."
      }
    }
  ]
}
</script>

Resultado: Cuando alguien pregunta "¿Cuánto cuesta TaskFlow?", la IA puede citarle directamente con precios precisos.

Esquema de HowTo: Para guías y tutoriales

Si crea tutoriales o contenido instructivo, utilice el esquema HowTo.

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

Esquema de Reseña y Calificación: 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. Altamente recomendado 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. Altamente recomendado 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. Altamente recomendado para oficinas en casa.",
      "reviewRating": {
        "@type": "Rating",
        "ratingValue": "5",
        "bestRating": "5"
      }
    }
  ]
}
</script>

Avanzado: Entidades anidadas y relacionadas

Puede conectar múltiples esquemas para crear un contexto enriquecido.

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. Coloque 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. Utilice un solo @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. Evite fechas estáticas o hardcoded

Utilice 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. Incluya únicamente información objetiva

Evite exageraciones o adornos de marketing:

Malo:

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

Bueno:

"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. Utilice sameAs para conectar perfiles externos

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

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

Pruebas y validación

Prueba de resultados enriquecidos de Google

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

  2. Introduzca su URL o pegue el código JSON-LD directamente

  3. Compruebe si hay errores o advertencias

Validador de Schema.org

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

  2. Pegue su código JSON-LD

  3. Verifique que es un esquema válido

JSON Lint (comprobación de sintaxis)

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

  2. Pegue su código JSON-LD

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

Prueba manual con el navegador

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

Errores comunes y soluciones

Error

Síntoma

Solución

Coma faltante

Error de análisis de JSON

Use JSON Lint para encontrar el error

@type incorrecto

Advertencias en los validadores

Consulte los tipos de schema.org

URL relativas

Advertencias

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

@context duplicado

Errores de análisis

Un solo @context por bloque

Problemas con comillas escapadas

El JSON no se analiza

Use \" para comillas dentro de cadenas de texto

Excesivos datos anidados

Ilegible para la IA

Mantenga los esquemas simples y enfocados

Lista de verificación para la implementación

Utilice esta lista para implementar JSON-LD:

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

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

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

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

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

  6. Añada esquemas de Reseñas – Si tiene opiniones de clientes

  7. Anide entidades relacionadas – Conecte esquemas donde sea relevante

  8. Pruebe con validadores – Google Rich Results + Schema.org

  9. Verifique la sintaxis JSON – Utilice JSON Lint

  10. Supervise tras el despliegue – Compruebe que se muestre correctamente en el código fuente

Conclusión

El marcado de esquema 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, JSON-LD es explícito y claro. Normalmente se tarda de 2 a 4 horas en implementar los esquemas básicos en un sitio web, pero el efecto en la visibilidad ante la IA es muy significativo.

Comience con el esquema de Organización en su página de inicio, añada esquemas de Producto/Servicio en las páginas correspondientes y continúe desde ahí con los esquemas de Artículo y FAQ. Realice siempre pruebas con los validadores y actualice los datos cuando cambie su marca.

Recuerde: JSON-LD no es solo para el SEO, es la base de cómo la IA comprende y representa su marca.

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

¿Es este el fin de la USP? ›