Claude Code SEO: El Agente que Edita tu Sitio, No tus Borradores

Busca «claude code seo» y la mayoría de lo que aparece son recopilaciones de indicaciones: pega tu borrador en Claude y pide descripciones meta, genera diez variantes de título, lluvia de ideas de palabras clave. Todo trata a Claude Code como una máquina de escribir con opiniones — lo que pasa por alto lo que realmente es. Claude Code es el agente de terminal de Anthropic. Sus habilidades nativas son leer archivos, editar archivos y ejecutar git. Y en un sitio web moderno, esa lista describe casi toda la superficie del SEO — porque tus etiquetas de título, canónicos, mapa del sitio, reglas de robots, redirecciones y datos estructurados no son configuraciones en un panel. Son líneas de código en un repositorio.

Este es el replanteamiento que esta guía se compromete a hacer: Claude Code no asiste con el SEO, convierte el SEO en trabajo de repositorio — encuentra el problema en Search Console, edita los archivos fuente reales, abre una solicitud de extracción, y verifica el movimiento en Search Console semanas después. Este es el lado práctico de nuestro pilar Claude para SEO: no lo que el modelo puede escribir, sino lo que el agente puede enviar.

Tus problemas de SEO son archivos

Recorre lo que una auditoría de SEO señala y dónde vive realmente cada elemento en un sitio de marco. El título débil en tu página de dinero es una exportación generateMetadata. Las URL duplicadas que dividen tus señales son una regla canónica en un archivo de diseño. Las páginas que Google nunca encontró son una entrada faltante en app/sitemap.ts. El bloqueo de ensayo que se envió a producción es una línea en app/robots.ts. El resultado enriquecido que no estás obteniendo es un componente JSON-LD que se desvió de sincronización con la página. Ninguno de estos son artefactos de marketing. Son código, versionado en git, editable en segundos.

El flujo de trabajo tradicional ignora esto. Una herramienta encuentra el problema en un navegador, un comercializador lo escribe en un ticket, un desarrollador lo recoge dos sprints después, y nadie vuelve a verificar el número después. El hallazgo fue instantáneo; el envío llevó un mes; la prueba nunca sucedió. Esa brecha no es un problema de talento — es lo que obtienes cuando las personas que encuentran problemas de SEO y las personas que pueden editar archivos viven en diferentes herramientas. Un agente de codificación que puede consultar Search Console y editar el código fuente colapsa la brecha en una sesión.

Lo que Claude Code necesita: evidencia que puede consultar, archivos que puede editar

De serie, Claude Code ejecutándose en tu repositorio de sitio web tiene las manos pero no la evidencia. Puede leer cada plantilla, pero no puede saber qué consulta se sienta en la primera página sin ganar nada, qué páginas muestra Google pero nadie hace clic, o cómo se ven los resultados en competencia. Ese conocimiento vive en Google Search Console y en los SERP — fuera del repositorio, detrás de API.

El puente es MCP, el Protocolo de Contexto de Modelo — el estándar abierto, introducido por Anthropic, que permite que Claude Code llame a herramientas remotas de forma tan natural como lee archivos locales. Conecta un servidor MCP que expone tus datos de Search Console y un panel de tareas compartido, y el agente de repente tiene ambas mitades del trabajo: puede ejecutar una consulta GSC para encontrar la página con bajo rendimiento, usar grep en el repositorio para la plantilla que la representa, editar el archivo, y registrar toda la transacción en un panel que sobrevive a la sesión. Cómo se construye ese servidor — alcances, herramientas, el panel como sistema de registro — es el tema de la guía hermana en Servidores MCP para SEO; el cableado práctico es un único comando claude mcp add, cubierto en la guía de conexión.

El bucle, de punta a punta: encuentra, edita, PR, verifica

Aquí está el mecanismo completo, ejecutado como un movimiento continuo único en lugar de cuatro trabajos desconectados. Es la implementación concreta del ciclo buscar → reparar → verificar que nuestro guía de SEO de bucle cerrado describe en abstracto — con Claude Code como las manos en cada paso.

1. Buscar — la evidencia proviene de Search Console

El agente consulta GSC a través de MCP para los patrones que vale la pena actuar: consultas que clasifican en la primera página con una tasa de clics muy inferior a lo que la posición debería ganar, páginas con impresiones y sin clics, consultas a distancia de ataque zumbando en la posición once, URL que el mapa del sitio declara pero el índice ignora. En un sitio que auditamos, una consulta comercial se sentaba cómodamente en la primera página y ganaba casi nada — el título que Google mostraba era un valor predeterminado de plantilla que no decía nada en lo que un comprador haría clic. Ningún rastreador señala eso; la evidencia solo existe en los datos de Search Console a nivel de consulta. Cada hallazgo se convierte en una tarea con la métrica que juzgará la corrección comprometida por adelantado: este es un problema de CTR, por lo que CTR será el juez.

2. Editar — la corrección es un diff, no una sugerencia

Ahora la parte que ningún panel puede hacer. El agente busca en el repositorio la ruta, lee la exportación generateMetadata o el diseño que produce el título débil, y lo edita — en el archivo real, en el estilo del código circundante. Los errores a nivel de plantilla obtienen correcciones a nivel de plantilla: una edición a un archivo de diseño corrige cada página que ese diseño renderiza, algo que un flujo de trabajo CMS página por página no puede expresar. El mismo movimiento cubre componentes de esquema, lógica canónica, enlaces internos, redirecciones — toda la superficie de auditoría del repositorio-primero.

3. Enviar — la solicitud de extracción es la puerta de revisión

El agente ramifica, confirma, y abre un PR cuya descripción lleva la evidencia: la consulta, los números que la señalaron, el impacto esperado, la métrica que la verificará. Un humano revisa el diff y se fusiona — o se resiste. Nada se envía silenciosamente. El PR fusionado cumple doble función: envía la corrección y la marca con el tiempo, y esa marca de tiempo es desde la que corre el reloj de verificación. La tarea se cambia a completada con la URL del PR adjunta.

4. Verificar — Search Console da el veredicto

Aproximadamente tres semanas después — tiempo suficiente para un rastreo e para que se acumulen datos de consulta nuevos en ambos lados del cambio — la métrica comprometida se vuelve a leer en la consulta exacta que la tarea nombró. Se movió y se mantuvo: confirmado, y el sitio ahora tiene un hecho probado que no tenía antes. Se movió de la manera incorrecta: regresionó, y la tarea se reabre con mejor información. Todavía no puede decir: inconcluso, un nulo honesto. Un monitor semanal realiza la re-lectura, por lo que ningún humano tiene que recordar treinta fechas de verificación.

Por qué el PR hace esto más seguro, no más lento

El reflejo de objeción a un agente que edita tu sitio web es el riesgo — y tiene el riesgo exactamente al revés. Compara los modos de fallo. Una edición en lote de CMS o un botón «auto-optimizar» de un complemento cambian páginas sin diff, sin revisor, y sin una forma limpia de volver atrás. Una solicitud de extracción es lo opuesto a los tres: cada cambio es un diff legible, un humano lo aprueba antes de que exista en producción, y git revert lo deshace en un movimiento. El flujo de trabajo de PR que los equipos de software adoptaron precisamente porque los cambios no revisados te queman es la misma puerta que hace que el SEO agéntico sea confiable.

Un agente que sugiere es seguro e inútil. Un agente que envía silenciosamente es útil y peligroso. Un agente que envía a través de una solicitud de extracción es tanto útil como revisable — ese es todo el diseño.

La puerta también soluciona algo más sutil: atribución. Porque cada corrección es un commit fusionado con una marca de tiempo, la pregunta «¿qué cambió y cuándo?» — la pregunta que hace que la mayoría de las retrospectivas de SEO se disuelvan en encogimientos de hombros — tiene una respuesta exacta. La verificación es tan buena como el registro de lo que se envió, y git es el mejor registro de cambios jamás construido.

Claude Code vs. Claude en una ventana de chat

El mismo modelo se sienta detrás de ambos, lo que es exactamente por qué la comparación es esclarecedora: la diferencia no es inteligencia, es agencia. Una ventana de chat puede razonar brillantemente sobre SEO y aún dejar cada hallazgo varado en tu lado del cristal — llevas la perspicacia al CMS, recuerdas volver a verificar, eres el bucle. Claude Code con acceso MCP es el bucle.

Lo que honestamente no puede hacer

Cuatro límites, declarados claramente. Primero, el bucle necesita sus datos: sin Search Console conectado a través de MCP, Claude Code está auditando ciego — puede leer cada archivo y aun así no saber cuál importa, porque la importancia es una propiedad de las consultas, no del código. Segundo, la verificación obedece la física de la fuente de datos, no tu cadencia de sprint: el propio reporte de Search Console se retrasa aproximadamente dos días, los rastreos tardan más días, y un antes y después justo necesita impresiones en ambos lados — lee el número en el día cinco y estás calificando ruido. Tercero, ejecutar honestamente, una parte real de las correcciones verificarán inconcluso, especialmente cambios higiénicos pequeños; un sistema que confirmó todo estaría mintiéndote.

Cuarto — y este es el que las recopilaciones de indicaciones entienden mal en la otra dirección — el acceso a repositorio no hace la estrategia de contenido gratis. Un agente que escribe artículos sin evidencia de SERP produce conjeturas seguras y bien formateadas. El bucle de escritura tiene su propia disciplina — un desglose de lo que ya se clasifica, un esquema que lo supera, puertas de puntuación antes de que algo se envíe — que el pilar Claude para SEO mapea a través del clúster. La misma advertencia se aplica a sitios que ni siquiera son repositorios: un CMS alojado sin acceso a la fuente retrocede a herramientas basadas en rastreo e integraciones de API, que funcionan, pero renuncian a la ventaja a nivel de plantilla que hace que la ruta de repositorio sea tan eficiente.

Cómo configurarlo

La configuración de trabajo es cuatro pasos, y ninguno de ellos es exótico. Instala Claude Code. Abre una terminal en el repositorio de tu sitio web — el mismo en el que trabajan tus desarrolladores. Conecta un servidor MCP que expone tus datos de Search Console y un panel de tareas compartido (un comando, luego autentica). Luego pídele que trabaje el panel: buscar, editar, PR, y deja que el monitor lea los veredictos. De ese punto en adelante la restricción ya no es cuán rápido se pueden enviar los hallazgos — es cuán buenos son los hallazgos, que es donde el acceso del agente a datos de consulta reales se compone ciclo tras ciclo.

Si quieres ver el medio de búsqueda ejecutarse contra tu propia propiedad primero, el informe SEO gratuito conecta tu Search Console y muestra las consultas donde enviar una edición de archivo realmente movería un número — clasificaciones de primera página sin ganar nada, páginas mostradas y nunca elegidas. Y si prefieres que todo el bucle corra para ti — agente, panel, PR, y los veredictos de tres semanas — agenda una llamada y lo recorreremos en tus datos.