¿Cómo agrego schema markup (JSON-LD) a mi sitio con Claude Code o Codex?

Pide al agente que genere el JSON-LD en las plantillas con los mismos datos que muestra cada página, solo con tipos y valores que el lector ve, renderizado en el servidor. Escribe esa regla en CLAUDE.md o AGENTS.md para que toda página nueva la siga. Luego prueba la URL publicada, no el código, en la Prueba de resultados enriquecidos de Google.

Datos

Google recomienda JSON-LD entre los 3 formatos de datos estructurados que admite, si la configuración del sitio lo permite. (Google Search Central: Introduction to structured data markup)
Las directrices de Google piden no marcar contenido que el lector no ve, y los elementos sin las propiedades obligatorias no son aptos para resultados enriquecidos. (Google Search Central: General structured data guidelines)
Google dice que no hace falta ningún schema.org especial para aparecer en AI Overviews o AI Mode, y que los datos estructurados deben coincidir con el texto visible. (Google Search Central: AI features and your website)
El marcado Organization va en la página de inicio o en una página sobre la empresa, no tiene propiedades obligatorias y su logo debe medir al menos 112x112 píxeles. (Google Search Central: Organization structured data)
Claude Code carga el CLAUDE.md del proyecto en cada sesión, junto a una memoria automática de hasta 200 líneas o 25KB. (Claude Code docs: How Claude remembers your project)
Codex lee AGENTS.md antes de cualquier trabajo y combina los archivos de instrucciones hasta 32 KiB por defecto. (OpenAI Codex docs: Custom instructions with AGENTS.md)

¿Qué tipos de schema le pido al agente?

Pide el tipo que corresponde a lo que muestra cada página, y nada más:

Página	Tipo de schema	Propiedades clave
Inicio o acerca de	Organization (o LocalBusiness)	name, url, logo, sameAs
Guía o artículo de blog	Article	headline, author, datePublished, dateModified, publisher
Página de producto	Product	name, offers con el precio que muestra la página
Página con preguntas y respuestas visibles	FAQPage	Solo las preguntas impresas en la página

¿Qué prompt le doy a Claude Code o Codex?

Dale un conjunto de reglas que aplique a todas las plantillas, con la prohibición de inventar valores:

Agrega datos estructurados en JSON-LD a este sitio.
- Genéralos en las plantillas de página con los mismos datos que la página muestra.
  Nunca fijes en el código un valor que la página no muestre.
- Organization (name, url, logo, sameAs) solo en la página de inicio.
- Article en guías y artículos: headline, author, datePublished,
  dateModified (el último cambio real), publisher = la Organization.
- Product, LocalBusiness o FAQPage solo donde ese contenido sea visible.
- Si un valor no existe, omite la propiedad. No lo inventes.
- Renderízalo en el servidor, en un <script type="application/ld+json">.
- Enumera cada página que cambiaste y los tipos que ahora tiene.

¿Dónde pongo la regla para que las páginas nuevas también tengan schema?

En el archivo de instrucciones que el agente carga solo. Claude Code lee ./CLAUDE.md o ./.claude/CLAUDE.md al inicio de cada sesión, y /init crea una primera versión. Codex lee AGENTS.md desde la raíz del proyecto antes de cualquier trabajo. Una regla corta ahí mantiene la próxima página igual a la anterior.

¿Cómo compruebo que el agente no inventó nada?

Prueba la URL publicada en la Prueba de resultados enriquecidos y compara cada valor con la página que ve el lector. La prueba por URL ejecuta el JavaScript de la página, cosa que el código pegado no hace. Luego usa la Inspección de URLs de Search Console para confirmar que Google encontró el marcado. Una prueba válida solo demuestra la sintaxis; los valores los revisas tú.

¿El schema markup hace que ChatGPT o la IA de Google citen mi sitio?

No por sí solo. Google dice que AI Overviews y AI Mode no requieren schema especial, y no garantiza resultados enriquecidos para un marcado válido. Un JSON-LD correcto ayuda a los buscadores a entender quién eres y qué es la página; lo que se cita sigue siendo la respuesta escrita en la página.

Paso a paso

Lista tus tipos de página. Inicio, acerca de, guías, productos: un tipo de schema para cada uno.
Dale el prompt al agente. Pide el JSON-LD en las plantillas con los datos de la propia página, sin valores inventados.
Guarda la regla. Ponla en CLAUDE.md o AGENTS.md para que las próximas páginas la sigan.
Revisa el diff y despliega. Comprueba que los valores salen de los datos de la página, no de texto fijo.
Prueba la URL publicada. Ejecuta la Prueba de resultados enriquecidos en la página publicada y luego la Inspección de URLs en Search Console.

Errores comunes

Dejar que el agente complete valoraciones, precios o autores que la página no muestra.
Marcar FAQPage con preguntas que no aparecen en la página.
Probar código pegado en lugar de la URL publicada, perdiendo lo que renderiza el JavaScript.
Cambiar dateModified en cada build y no cuando cambió el contenido.

Cómo lo resuelve easyIndex

easyIndex nunca toca tu sitio: tu agente de código escribe las páginas y el schema, y easyIndex audita cada página al enviarla y la revisa de nuevo en el sitio publicado, incluido si tiene JSON-LD y una fecha real de actualización. El paso se completa con esa evidencia, no con el informe del agente.

Preguntas frecuentes

¿JSON-LD, Microdata o RDFa?

JSON-LD. Google admite los tres y recomienda JSON-LD cuando la configuración del sitio lo permite.

¿El agente puede inyectar el JSON-LD con JavaScript?

Google procesa el JSON-LD presente tras el renderizado, pero el marcado renderizado en el servidor es más seguro para rastreadores que no ejecutan JavaScript.

¿Organization va en todas las páginas?

Google lo pide en la página de inicio o en una página sobre la empresa; las demás pueden citarla como publisher.

¿Funciona igual con Cursor u otro agente?

Sí. Cualquier agente que edite tus plantillas sigue el mismo prompt; solo cambia el nombre del archivo de instrucciones.

Sigue leyendo

Verificado el 13 de octubre de 2026.