¿Qué reglas de SEO poner en AGENTS.md o CLAUDE.md?
Pon una lista corta de reglas comprobables para cada página nueva: una pregunta y un H1, title y description únicos, canonical, hreflang, texto renderizado en el servidor, JSON-LD igual al texto visible, entrada en el sitemap, datos con fuente y nunca tocar páginas que ya funcionan. Las reglas guían al agente; no prueban que la página publicada esté bien.
Datos
- AGENTS.md lo usan más de 60 mil proyectos de código abierto y lo administra la Agentic AI Foundation, de la Linux Foundation, al 13/10/2026. (AGENTS.md)
- Claude Code v2.1.277 o posterior lee AGENTS.md cuando el proyecto no tiene CLAUDE.md, y un CLAUDE.md puede incluirlo con la línea @AGENTS.md. (Claude Code docs: How Claude remembers your project)
- Anthropic recomienda mantener cada CLAUDE.md por debajo de 200 líneas y dice que Claude lo trata como contexto, no como configuración obligatoria. (Claude Code docs: How Claude remembers your project)
- Codex combina archivos AGENTS.md de ~/.codex y de la raíz del proyecto hacia abajo, hasta 32 KiB por defecto. (OpenAI Codex docs: AGENTS.md)
- Google dice que los datos estructurados deben representar fielmente la página y no marcar contenido que el lector no ve. (Google Search Central: General structured data guidelines)
¿Qué archivo debe tener las reglas, AGENTS.md o CLAUDE.md?
Usa AGENTS.md si más de un agente de código trabaja en el repositorio, porque Codex y Cursor lo leen y Claude Code lo lee o lo importa. Deja CLAUDE.md para notas solo de Claude, con una línea de importación para que reciba las reglas comunes:
# CLAUDE.md @AGENTS.md
¿Qué reglas copiar?
Estas reglas son cortas, concretas y comprobables, como recomienda la documentación de los propios agentes. Pégalas como una sección del archivo:
## SEO rules for new pages - Only add new content pages. Never change the home page or a page that already works. - One question per page. The H1 is that question; the first paragraph answers it. - Unique <title> (up to 60 characters) and meta description (70 to 165). - Self-referencing rel="canonical" on every page. - Each language version links the others with hreflang; canonical stays in its own language. - The text is in the server-rendered HTML, not loaded only by JavaScript. - JSON-LD describes only what the page visibly says. - Every number or date in a fact links to the source that states it. Invent nothing. - Add the page to the sitemap and link to it from a related page. - A page is done when it is checked on the live URL, not when the build passes.
¿Por qué cada regla?
Cada regla evita una forma conocida en que fallan las páginas:
| Regla | Por qué |
|---|---|
| Canonical en cada página | Google trata rel=canonical como señal fuerte y el sitemap solo como señal débil |
| hreflang entre idiomas | Google usa hreflang para las versiones de idioma, con canonical en el mismo idioma |
| Texto renderizado en el servidor | Los rastreadores que no ejecutan JavaScript ven una página vacía |
| JSON-LD igual al texto visible | Las pautas de datos estructurados de Google prohíben marcar contenido oculto |
| Nunca tocar páginas que funcionan | Reescribir puede perder el tráfico que la página ya gana |
¿Qué no pueden garantizar las reglas?
Las reglas no garantizan el resultado publicado: la propia documentación de Claude Code dice que el archivo es contexto, no configuración obligatoria. Un despliegue fallido, un canonical errado o una página vacía solo se ven en la URL publicada, así que revisa cada página allí y sigue la indexación en Search Console.
Paso a paso
- Elige el archivo. Usa un AGENTS.md en la raíz del repositorio; si tienes CLAUDE.md, añade @AGENTS.md en él.
- Pega las reglas. Copia el bloque de reglas y ajusta rutas e idiomas a tu sitio.
- Mantenlo corto. Quédate muy por debajo de 200 líneas; las reglas de una carpeta van en un archivo dentro de ella.
- Revisa publicado. Tras cada despliegue, abre las URLs nuevas y confirma title, canonical, contenido y JSON-LD.
Errores comunes
- Escribir reglas vagas como "sigue las buenas prácticas de SEO", que el agente no puede comprobar.
- Tener CLAUDE.md y AGENTS.md sin importación, y que Claude Code nunca lea las reglas comunes.
- Pegar un manual largo de SEO que esconde las reglas que importan.
- Creer que el archivo de reglas prueba que las páginas publicadas están bien.
Cómo lo resuelve easyIndex
easyIndex da las reglas de las páginas a tu agente de código paso a paso por MCP, audita cada página al enviarse y la revisa en el sitio publicado; un paso solo se completa con evidencia que easyIndex comprueba, no con el informe del agente.
Nunca toca tu sitio ni tu repositorio, y funciona con Claude Code, Codex, Cursor o cualquier cliente MCP, por US$ 30 por sitio al mes tras 7 días gratis.
Preguntas frecuentes
¿Claude Code lee AGENTS.md?
Sí, desde la v2.1.277 cuando no hay CLAUDE.md; con CLAUDE.md, añade la línea @AGENTS.md para incluirlo.
¿Estas reglas harán que aparezca en ChatGPT?
Ninguna regla puede prometerlo. Hacen las páginas claras y rastreables; citarlas lo decide ChatGPT.
¿Debo poner llms.txt en las reglas?
Es opcional. Primero van páginas renderizadas en el servidor, canonical y sitemap.
¿Una subcarpeta puede tener reglas propias?
Sí. Los agentes leen el AGENTS.md más cercano en el árbol de carpetas, así que un archivo dentro de la carpeta vale para ella.
Sigue leyendo
- ¿Cómo usar Cursor para SEO y para aparecer en ChatGPT?
- ¿Cómo usar Codex para SEO y para aparecer en ChatGPT?
- ¿Cómo hago GEO con Claude Code o Codex?
- ¿Los datos estructurados (schema) ayudan a que la IA cite mi sitio?
- ¿ChatGPT y Claude pueden leer mi sitio hecho en JavaScript?
- ¿Cómo funciona easyIndex, qué necesito y cuánto tardan los resultados?
Verificado el .