Implementación técnica

Tutorial JSON-LD @graph: Organization, Person y Article

Respuesta rápida

El @graph de Schema.org es la forma de declarar varias entidades relacionadas en un JSON-LD sin fragmentar la marca. En GEO, su trabajo es decir: este artículo lo firma esta persona, que trabaja para esta organización, que es la misma en todas las URLs.

Puntos clave
  • Un @graph con @id estables une home, about, autores y posts en un solo nodo de organización.
  • Botpass Labs recomienda https://dominio/#org y https://dominio/#persona como anclas, repetidas en todo el site.
  • El schema debe copiar el HTML: mismo nombre, mismas fechas, mismas FAQs.
  • Duplicar Organization con tres plugins crea tres entidades. Eso diluye GEO.
  • Validar con Rich Results y con curl al source, no solo con la extensión de Chrome.

Tutorial: @graph JSON-LD para una agencia B2B

Google recomienda JSON-LD.[1] Averi y otras fuentes del ecosistema asocian el marcado coherente a más citas.[2] Coherente es la palabra: un grafo mentiroso empeora confianza.

El grafo mínimo

Nodos:

  • Organization @id: https://botpasslabs.com/#org
  • WebSite @id: https://botpasslabs.com/#website con publisher → #org
  • Person @id: https://botpasslabs.com/#pablo-ruiz con worksFor → #org
  • BlogPosting en cada post con author y publisher apuntando a esos @id
  • sameAs en Organization: LinkedIn, y si existen Wikidata/Wikipedia/Crunchbase

Nunca inventes un segundo #org llamado «PerformanceMedia».

Campos Organization que sí importan

  • name canónico (Botpass Labs)
  • legalName (San Mateo Capital, S.L.) si lo publicáis
  • url, logo absoluto
  • foundingDate, address (Barcelona)
  • knowsAbout o makesOffer alineados a GEO/AEO (sin stuffing)
  • sameAs real

No rellenes aggregateRating inventado. Es el camino más corto a invalidar el marcado.

Checklist anti-fragmentación

  1. Un plugin de schema, no tres.
  2. El name del JSON = H1/footer.
  3. Fechas del Article = fechas visibles.
  4. FAQPage solo si el FAQ está en el body, mismo texto.
  5. @id no cambia entre staging y prod (ojo al dominio de preview).
  6. curl ve el JSON-LD en el HTML inicial (no solo tras Tag Manager).

Errores frecuentes

  • Person y Organization como el mismo nodo.
  • sameAs a la home del periódico que os mencionó una vez (no es identidad).
  • dateModified que salta cada build de Next.
  • Marcar Service «SEO, SEM, social, GEO, branding» cuando la web dice «solo GEO».

Cómo desplegarlo en 7 días

Día 1: inventario de plugins. Día 2: decisión de @id y nombre. Día 3: Organization+Person en home y about. Día 4: plantilla Article. Día 5: validación Rich Results. Día 6: curl user-agents de IA. Día 7: documentar en la guía de IT.

Botpass Labs lo mete en el mes 2 técnico, no como un ticket eterno.

Preguntas frecuentes

¿Microdata o JSON-LD?

JSON-LD.

¿Hace falta @graph sí o sí?

Si tienes más de un tipo por página, sí. Evita bloques sueltos que no se apuntan.

¿El logo SVG vale?

Una URL absoluta estable de ImageObject. Evita query strings de CDN que rotan cada hora.

¿Varios autores?

Varios Person @id. Cada post apunta a uno. Todos worksFor #org.

¿Wikidata Q-ID en sameAs?

Sí, cuando el ítem es vuestro. No el de un homónimo.

¿Esto posiciona en ChatGPT?

No por magia. Reduce ambigüedad. El chunk sigue siendo el pasaje.

¿Yoast basta?

Rara vez el grafo queda limpio. Alguien diseña @id.

¿Botpass Labs lo deja documentado al IT del cliente?

Sí. Hay guía interna GEO para IT (schema, WAF, JS).

Conclusión

El schema es el DNI. Un DNI duplicado o falso no te hace más visible: te hace sospechoso. Unifica @id y alinea el HTML.

Siguiente paso

En la auditoría miramos si tu grafo dice una marca o tres.

Notas y fuentes
  1. Google (2026) — Google’s Guide to Optimizing for Generative AI Features on Google Search. Google Search Central, actualizada el 10 de julio de 2026. developers.google.com/search/docs/fundamentals/ai-optimization-guide
  2. Chmael, Z. (2025) — Schema Markup for AI Citations: The Technical Implementation Guide. Averi, 30 de diciembre de 2025, actualizado el 2 de enero de 2026. www.averi.ai/blog/schema-markup-for-ai-citations-the-technical-implementation-guide
  3. Los plazos, umbrales y marcos de trabajo atribuidos a Botpass Labs en este artículo corresponden a su metodología propia de GEO, derivada de la medición continua de respuestas en proyectos de cliente; varían según sector y punto de partida.
Pablo Ruiz
Fundador y CEO de Botpass Labs. Desde 2023 desarrolla y aplica una metodología propia de posicionamiento en IA (GEO y AEO), validada con más de 20 clientes B2B en España y Latinoamérica. Mentor de startups B2B en Wayra (Telefónica) y conductor del podcast «Estrategias de Dark Social».
Cómo citar este artículo

Pablo Ruiz (2026). Tutorial JSON-LD @graph: Organization, Person y Article. Botpass Labs. https://botpasslabs.com/blog/tutorial-schema-graph-organization-person-article/

Seguir leyendo

Más sobre Implementación técnica

Implementación técnica

GEO para Bing y Microsoft Copilot

Cómo optimizar para Microsoft Copilot y Bing: Webmaster Tools, entidades de negocio, páginas de servicio y por qué el índice de Google no basta.

3 min

¿Quieres saber cómo te ve hoy la IA?

Leer sobre GEO está bien. Ver tu línea base real de citaciones en ChatGPT, Gemini y Perplexity es lo que hace que una conversación interna avance.

Sin compromiso · Sin permanencia · Planes desde 995 €/mes