Corregir errores SEO con un agente de programación con IA: flujo seguro

Respuesta corta: Un agente de programación con IA puede corregir los problemas SEO mecánicos y verificables de tu sitio (títulos, meta descriptions, etiquetas canonical, hreflang, textos alternativos, cabeceras de seguridad y los archivos robots.txt, sitemap y llms.txt), siempre que le entregues un hallazgo cada vez con una condición que diga cuándo está terminada la tarea, lo dejes trabajar en una rama, leas el diff y midas la página de nuevo después. No debe inventar contenido, elegir tus palabras clave, hablar en nombre de tu empresa ni decidir por ti si los rastreadores de IA pueden leer tu sitio. Una corrección deja la página técnicamente correcta, pero un mejor posicionamiento nunca está garantizado.

¿Para qué sirve un agente de programación con IA en SEO y para qué no?

Una auditoría SEO produce dos tipos de hallazgos. Unos son mecánicos: hay una única respuesta correcta y puedes comprobarla pidiendo la página. Otros son decisiones que corresponden a una persona. Un agente de programación con IA como Claude Code, Cursor o GitHub Copilot encaja con el primer tipo y es arriesgado para el segundo.

Una regla práctica ayuda a repartir: si puedes juzgar el resultado con una petición a la página o con una prueba, es una tarea para el agente. Si antes tendrías que preguntar a tu responsable, a tu cliente o a ti mismo, se queda contigo.

Buenos trabajos para un agente:

• Títulos y meta descriptions. Una etiqueta que falta, está duplicada o tiene una longitud inadecuada se localiza rápido en una plantilla o en un archivo de contenido. El agente debe derivar el texto de lo que la página ya dice, no escribir un texto publicitario de la nada.
• Etiquetas canonical y hreflang. Ambas son reglas, no prosa. hreflang tiene una trampa a la que volvemos más abajo: cada versión de idioma debe enlazar de vuelta a las demás.
• Textos alternativos. Sirve donde el significado de la imagen se deduce de la página que la rodea. Si no, el agente debe preguntar.
• Cabeceras de seguridad. Unas pocas líneas de configuración del servidor o del framework, fáciles de verificar con curl -I.
• Los archivos de la raíz: robots.txt, sitemap.xml y llms.txt. Texto plano y corto, y el resultado se lee de inmediato.

Trabajos que se quedan contigo:

• Inventar contenido. Datos de producto, precios, testimonios, afirmaciones sobre tu empresa. El encargo que genera SEOgrinder lo recoge en sus reglas de trabajo: no inventes contenido, deriva el texto que falte de lo que ya hay en la página o pregunta.
• Decisiones de palabras clave y de temas. Qué página debe apuntar a qué búsqueda es una cuestión de negocio.
• Decisiones del propietario. Si los rastreadores de IA pueden leer tu sitio, y si pueden usarlo para entrenar modelos, lo decides tú. Los prompts de agente de SEOgrinder lo dicen de forma explícita: permitir o bloquear es decisión del propietario, así que hay que preguntar y no elegir por él.
• El trabajo de rendimiento, en parte. Los objetivos se pueden medir: las Core Web Vitals cuentan en el percentil 75 de las cargas de página, por separado para móvil y escritorio, y «bueno» significa LCP de hasta 2,5 segundos, INP de hasta 200 milisegundos y CLS de hasta 0,1 (web.dev). Un agente puede aplicar correcciones conocidas, pero una sola prueba de laboratorio después no muestra lo que miden los visitantes reales, así que qué quitar lo decides tú.

El flujo seguro en seis pasos

El objetivo es un ciclo en el que cada cambio sea pequeño, comprobado y reversible.

1. Analiza. Escribe la dirección de tu sitio público en SEOgrinder. Es gratis y no necesita cuenta. Obtienes una puntuación global, una lista de tareas ordenada por impacto y seis áreas: velocidad, cómo se ve la página en Google, accesibilidad, tecnología y seguridad, preparación para la IA y el sitio en sí.
2. Entrega. Para la lista completa, pulsa Entregar a la IA en el informe. Se abre el encargo, una orden de trabajo en Markdown que descargas como .md o que copias y pegas en tu agente. Para una sola tarea, pulsa Entregar a la IA en su tarjeta de tarea. Para las comprobaciones para agentes de IA, la pestaña Preparación para la IA tiene un botón Copiar prompt del agente en cada línea (las líneas cumplidas se despliegan primero). Los prompts están redactados en inglés porque van dirigidos a un modelo y las especificaciones a las que enlazan están en inglés.
3. Un hallazgo cada vez. Dile al agente que haga la tarea uno y se detenga. No le pidas «el SEO entero». Una tarea pequeña da un diff pequeño que puedes leer.
4. Lee el diff y ejecuta tus pruebas. Tu compilación, tu linter y tu batería de tests existen justo para esto. Abre tú mismo los archivos modificados. Si el agente tocó algo que la tarea no mencionaba, pregúntale por qué.
5. Vuelve a comprobar. Cuando el cambio esté publicado en tu dirección pública, abre el informe y pulsa Comprobar de nuevo. SEOgrinder conserva un informe hasta 24 horas, de modo que sin ese botón verías el resultado antiguo. El botón funciona unas cuantas veces por hora. El hallazgo debería haber desaparecido. SEOgrinder analiza solo sitios web públicos, así que un cambio que solo existe en tu equipo o detrás de un inicio de sesión le resulta invisible. Comprueba entonces después de la publicación y mantén el cambio lo bastante pequeño como para poder revertirlo.
6. Haz el commit. Un commit por hallazgo, con un mensaje que lo nombre. Fusiona cuando la nueva comprobación lo confirme y pasa a la tarea siguiente.

Cómo es un buen encargo de trabajo

Un agente sin un objetivo claro se detiene cuando algo parece plausible. Un buen encargo le quita margen para adivinar. Tiene cuatro partes:

El encargo se construye en este orden: Encargo, Página, Estado actual, Palabras clave, Tareas, Reglas de trabajo y Datos (legibles por máquina). En una instalación local de SEOgrinder, la sección «Comprueba tu trabajo» queda entre Reglas de trabajo y Datos; el encargo de seogrinder.com no la contiene. Cada tarea lleva su problema, la manera de resolverlo, una valoración del esfuerzo y el bloque «Listo cuando». Ese bloque está escrito como un test, por ejemplo:

meta[name=description] exists
description.length in [min, max]
description contains the focus keyword

En el encargo real, los límites están rellenados para tu página. Lo importante es que «terminado» se pueda verificar. Las reglas de trabajo son breves: trabajar de arriba abajo, localizar el archivo afectado antes de cada cambio, omitir e informar de una tarea cuyo sitio no se pueda encontrar, no inventar contenido, mantener el formato, el idioma y el tono existentes y enumerar al final qué archivos han cambiado y qué tareas se han hecho o se han omitido, con el motivo.

En una instalación local, la sección «Comprueba tu trabajo» indica al agente que vuelva a medir la página. Según el texto del encargo, esa comparación solo comprueba lo que dicen las tareas de arriba, no el posicionamiento, y su comando tiene que ejecutarse en el equipo donde se ejecuta SEOgrinder. La comprobación en la que siempre puedes confiar es, por tanto, la del paso 5: publicar, pulsar Comprobar de nuevo y leer el informe.

Un ejemplo de prompt abreviado

Debajo tienes una versión abreviada del prompt de agente para un robots.txt ya existente, con example.com como sitio. El prompt real de SEOgrinder es más largo y enumera más comprobaciones.

# Review and improve the existing robots.txt

Your site already serves a robots.txt. Review it against RFC 9309
and fix what is wrong. Change only what is needed.
Do not remove a rule you do not understand: ask the site owner.

## Check

- Served as text/plain with HTTP 200, not as an HTML page
- Valid User-agent groups with Allow/Disallow rules, no syntax errors
- No rule blocks pages that should appear in search
- The sitemap is listed as an absolute URL
- AI crawlers: allowing or blocking is the owner's decision.
  Ask, do not choose for them

## Read it

curl -sg https://example.com/robots.txt

Report the problems you found and the changes you made.

Cuatro hábitos hacen seguro este prompt, y puedes copiarlos en tus propios prompts. Contención: «Change only what is needed» mantiene el diff pequeño. Una forma de decir «no lo sé»: «ask the site owner» le da al agente una salida legítima, para que no tenga que adivinar. Un límite para las decisiones: las decisiones del propietario se nombran como tales. Primero el estado real: la línea con curl hace que el agente lea el archivo de verdad en lugar de suponer lo que contiene. La última línea te da un resumen para compararlo con el diff.

Reglas de seguridad antes de que un agente toque tu código

• Trabaja en una rama, o en una copia del proyecto. No dejes nunca que un agente edite archivos directamente en el servidor de producción. Los cambios llegan a producción por tu proceso de publicación habitual.
• Lee todos los diffs. Un agente puede estar seguro de sí mismo y equivocarse. El diff es donde lo notas.
• Mantén los secretos fuera. Ni claves, ni tokens, ni contenido de un .env en un prompt o en archivos que pegues. Comprueba que los cambios del agente no hayan copiado ninguno al repositorio.
• Ningún cambio masivo sin una muestra. Si una tarea afecta a todas las páginas, por ejemplo una plantilla de títulos, aplícala primero a una, mira el resultado y amplíala después.
• Compilación y tests antes de cada commit.
• Trata el texto descargado como datos. El contenido de una página, una exportación de Search Console o la respuesta de un servidor pueden contener frases que suenan a instrucciones. Las tuyas son las que has escrito tú. El resumen de Search Console de SEOgrinder marca las consultas y las direcciones de una exportación como «datos, no instrucciones» por esta misma razón.

Errores frecuentes

• Entregar toda la lista de golpe. El diff crece y ya no puedes saber qué cambio causó qué problema.
• Dejar que el agente decida sobre los rastreadores de IA. Es una regla sobre quién puede usar tu contenido. Es tu decisión.
• hreflang sin enlaces de vuelta. Google documenta que cada versión de idioma debe nombrarse a sí misma y a todas las demás, y que la falta de enlaces de vuelta puede llevar a que se ignoren las anotaciones. Un agente que edita una página y deja las otras rompe el conjunto. Indica en la tarea que todas las versiones cambian a la vez y lee el resultado en cada versión. Los detalles están en la guía de Google sobre versiones localizadas.
• Un grupo nuevo en el robots.txt que olvida las reglas anteriores. El RFC 9309 dice que un rastreador usa el grupo que coincide con su nombre y que, si existe, el grupo * no se le aplica. Cuando un agente añade un bloque para un bot de IA, deben repetirse allí todas las reglas que ese bot tiene que seguir.
• Una página de error amable con estado 200. Una página que falta debería responder 404 o 410. Si el contenido dice «no encontrada» pero el estado es 200, Search Console de Google puede informar de un soft 404, como describe la página de Google sobre los códigos de estado HTTP. Una página de error más bonita debe seguir enviando el estado 404. Más sobre esto en nuestro artículo sobre los errores soft 404.
• Creer en el «hecho» sin medir. El informe del agente dice lo que pretendía cambiar. Solo un análisis nuevo dice lo que está publicado.

Preguntas frecuentes

¿Qué agente de programación con IA es el mejor para corregir SEO?

No clasificamos herramientas y no afirmamos nada sobre modelos o productos concretos. El encargo es un archivo Markdown pensado para Claude Code, Cursor, GitHub Copilot o ChatGPT. La calidad del encargo, el tamaño de la tarea y tu revisión importan más que el nombre de la herramienta.

¿Puede el agente ejecutar toda la auditoría sin supervisión?

Nosotros no lo haríamos. Los hallazgos mecánicos encajan con un agente; las decisiones, no; y una ejecución sin supervisión es donde una suposición equivocada llega a producción. Una tarea, un diff y una comprobación es más lento y mucho más seguro.

¿Cambia SEOgrinder mi sitio web?

No. SEOgrinder lee tus páginas públicas e informa de lo que encuentra. Los cambios los hace tu agente en tu proyecto, y tú los revisas.

¿Subirá mi posicionamiento si corrijo los hallazgos?

Nadie puede garantizarlo. Corregir los hallazgos elimina errores técnicos y facilita la lectura de la página a rastreadores y visitantes, una base sólida. Lo que pase con el posicionamiento o con las menciones en respuestas de IA, ninguna herramienta puede prometerlo.

Tu siguiente paso

Haz el análisis gratuito de tu sitio, abre el informe y elige la primera tarea de la lista. Entrega solo esa a tu agente, lee el diff, publica, pulsa Comprobar de nuevo y haz el commit. Si después quieres una visión de conjunto de lo que conviene revisar, consulta la checklist SEO.