Claude Code para SEO: del primer prompt a un equipo de agentes

Claude Code para SEO significa usar un agente de IA que lee los archivos de tu sitio, los edita, ejecuta comandos y, mediante un conector MCP, lee tus datos de Search Console, Analytics y Google Business Profile. Empieza poco a poco: una carpeta bajo git, la regla de leer cada diff y acceso a los datos de solo lectura. Cuando ese ciclo sea confiable, agrega agentes en paralelo y luego varias sesiones con un líder.

Algunas personas lo llaman "vibe coding SEO" o "vibe SEO": describir el resultado con palabras sencillas y dejar que la IA escriba el código. Es una etiqueta informal, no un término de Anthropic ni de Google, y solo es seguro con las comprobaciones que siguen. Otras etiquetas relacionadas son "Claude SEO", "Claude Code SEO" y "MCP SEO". Para empezar ya, conecta el conector de ZeusSEO, que está incluido en todos los planes: la guía del MCP de Google Business Profile explica la configuración, y la sección de MCP más abajo agrega los comandos de Claude Code. Si prefieres leer sobre un experto ya listo en lugar de armar un flujo de trabajo, también existe Athena, el experto de SEO con IA de ZeusSEO (en acceso anticipado).

Qué es Claude Code y qué puede hacer por el SEO

Anthropic describe Claude Code como una herramienta de programación con agentes que lee tu base de código, edita archivos, ejecuta comandos y se integra con tus herramientas de desarrollo. Funciona en una terminal, un IDE, una app de escritorio y un navegador, y la mayoría de las superficies requieren una suscripción a Claude o una cuenta de Anthropic Console.

Para el SEO, "base de código" significa cualquier carpeta de texto: plantillas, entradas en markdown, fragmentos de schema, robots.txt, mapas de redirecciones y exportaciones CSV. "SEO con Claude" suele significar conversar en una ventana; Claude Code trabaja dentro de una carpeta de tu equipo, así que puede abrir archivos, modificarlos y ejecutar comprobaciones. No tiene visibilidad de Google hasta que le agregas una, como exportaciones o mediante un conector.

Herramientas recomendadas y sugeridas

Instala desde la descripción general oficial, como herramienta de terminal, extensión de VS Code o app de escritorio. Todas las superficies usan el mismo motor, por lo que tus archivos CLAUDE.md, la configuración y los servidores MCP se mantienen.

Un CLAUDE.md inicial para la carpeta de un cliente podría decir:

• Qué carpetas contienen plantillas, contenido y exportaciones.
• No editar nunca robots.txt ni el mapa de redirecciones sin preguntar.
• No inventar nunca datos, precios, reseñas ni estadísticas.
• Proponer los cambios de Google Business Profile; nunca publicarlos.

Git y carpetas locales: tu botón de deshacer

Asigna a cada cliente una carpeta para los archivos del sitio, las exportaciones y los informes, e inicia Claude Code allí. En modo Manual pregunta antes de leer o escribir fuera de la carpeta donde se inició, como explica la página de seguridad.

1. Usa git, incluso para las exportaciones. ¿No hay repositorio para un sitio con CMS? Guarda los borradores y los CSV en una carpeta y ejecuta git init.
2. Una rama por tarea, y haz commit antes de cada ejecución.
3. Lee git diff antes de aceptar. Claude Code puede hacer commits por ti, pero la revisión es tuya.

Cinco flujos de trabajo de SEO para empezar

Usa un mismo flujo de trabajo de SEO con IA repetible para los cinco trabajos de SEO con Claude Code: definir el alcance, obtener datos, planificar, cambiar archivos en una rama, ejecutar una comprobación, leer el diff y hacer commit. Las mejores prácticas de Anthropic recomiendan planificar antes de programar y darle a Claude una comprobación que pueda ejecutar, para que itere hasta que la comprobación pase.

1. Auditoría técnica de los archivos de un sitio

Pídele a Claude que lea las plantillas, robots.txt y la configuración del sitemap en modo plan y que enumere los hallazgos por archivo y línea. Google indica que robots.txt no es una forma de mantener una página fuera de Google, así que señala cualquier Disallow usado con ese fin. Nuestra guía de auditoría SEO técnica cubre la parte en vivo.

2. Escribir y comprobar schema

La introducción a los datos estructurados de Google recomienda JSON-LD en la mayoría de los casos e indica que el marcado debe describir contenido que los usuarios puedan ver. Haz que Claude lo redacte por plantilla y luego valídalo tú mismo.

3. Correcciones on-page en bloque en un repositorio

Dale a Claude un CSV con la URL y el título nuevo y deja que edite los archivos correspondientes. Prueba primero con unos pocos y luego usa /batch, que divide un cambio entre 5 y 30 subagentes que trabajan cada uno en su propio worktree.

4. Hojas de cálculo de clústeres de palabras clave

Exporta las consultas a un CSV y pídele a Claude que escriba y ejecute un script que las agrupe por tema y proponga una página para cada grupo.

5. Preparación de informes

Obtén los números a través del conector y pide una narrativa breve por cliente. Consulta nuestra guía de informes de posicionamiento SEO para saber qué debe contener un informe para clientes.

MCP: conecta ZeusSEO a Claude Code

MCP, el Model Context Protocol, es un estándar abierto para conectar herramientas de IA con fuentes de datos externas, y Claude Code admite servidores MCP remotos mediante HTTP. El MCP para SEO significa que tu agente lee datos de clientes en vivo en lugar de una exportación pegada. El conector de ZeusSEO tiene una sola URL y más de 100 herramientas.

1. Agrega el servidor en una terminal, no dentro de una sesión:

2. Compruébalo. claude mcp list muestra "Needs authentication" hasta que inicies sesión, como describe el inicio rápido de MCP.
3. Inicia sesión. Inicia claude, escribe /mcp, elige zeuseo y selecciona Authenticate. Tu navegador se abre en el paso de inicio de sesión descrito en la guía del MCP de Google Business Profile.

Agrega --scope user para usarlo en todos los proyectos. Si agregaste el conector en Claude y usas esa misma cuenta para Claude Code, la documentación de MCP indica que los conectores de Claude se cargan automáticamente, a menos que una clave de API sea tu inicio de sesión. Nuestro inicio de sesión es un flujo OAuth estándar con PKCE que acepta la dirección de retorno local de Claude Code.

Leer tus propios datos no cuesta Staters, los créditos de uso prepagados de ZeusSEO. Unas pocas herramientas con nombre que llaman a nuestros proveedores de pago o a IA, como la investigación de palabras clave y las búsquedas de competidores en SERP, los gastan, y al asistente se le indica que te avise antes. Sus instrucciones también dicen que confirme el contenido y los destinos antes de cualquier publicación, edición, eliminación o respuesta, y un puesto de solo lectura es rechazado en las escrituras. Una prueba gratuita tiene un límite de uso razonable de 100 llamadas a la API. Consulta Staters y créditos de IA, los precios y las guías del MCP de Search Console y de Analytics.

Uso de APIs: claves, costos y scripts

Inicias sesión con una suscripción a Claude o una cuenta de Anthropic Console. La página de costos indica que la cifra en dólares de /usage es una estimación local y que los suscriptores tienen el uso incluido en su plan.

Para los scripts, claude -p ejecuta un prompt sin una sesión interactiva y acepta entrada por tubería, un patrón de la descripción general:

En el modo --bare, Claude Code no usa el inicio de sesión de tu suscripción, así que define ANTHROPIC_API_KEY, como explica la página de uso programático. Si Claude escribe scripts que llaman a una API de datos, guarda la clave en una variable de entorno y agrega la regla de denegación Read(./.env). Para los datos de Google, el conector evita la espera de aprobación del proyecto de API propio; consulta API de Google vs MCP.

Permisos y hooks: define las barreras una sola vez

Las instrucciones en un prompt o en CLAUDE.md moldean lo que Claude intenta, pero las reglas de permisos las aplica Claude Code, no el modelo. Las reglas se comprueban en orden: denegar, luego preguntar, luego permitir. Los modos de permisos de abajo definen con qué frecuencia pregunta Claude. Con Claude Code 2.1.283 o posterior, el modo auto es el modo inicial integrado para las sesiones interactivas de terminal y de VS Code, así que para el trabajo con clientes pulsa Shift+Tab para llegar al modo Manual, o inicia con claude --permission-mode default.

• Permite las herramientas de lectura: mcp__zeuseo__gsc_*, mcp__zeuseo__ga4_* y mcp__zeuseo__argus_*. El prefijo zeuseo es el nombre del servidor que elegiste al agregarlo.
• Mantén las herramientas de escritura fuera de las reglas de permiso, para que el modo Manual pregunte siempre. En el modo auto, un clasificador revisa la llamada en su lugar, así que agrega una regla de preguntar en /permissions si quieres una confirmación en cualquier caso.
• Deniega los secretos: Read(./.env).
• Bloqueos duros: un hook PreToolUse que termina con el código 2 detiene las ediciones de archivos protegidos. La guía de hooks indica que los hooks son deterministas, a diferencia de CLAUDE.md.

Agentes de IA para SEO: subagentes en paralelo

Un subagente se ejecuta en su propia ventana de contexto con un prompt personalizado, herramientas específicas y permisos independientes, y luego devuelve un resumen. Defínelo como un archivo markdown en .claude/agents/, por ejemplo un revisor de schema limitado a Read, Grep y Glob para que no pueda editar. Anthropic enumera varias formas de ejecutar agentes en paralelo, entre ellas:

Un agente que actúa como líder

La descripción general explica un agente líder que coordina el trabajo, asigna subtareas y combina los resultados. Los subagentes informan solo a la conversación que los generó, así que esa conversación es tu único punto de contacto.

1. Dale instrucciones al líder: "Usa subagentes de solo lectura para auditar /product, /locations y /blog en paralelo. Informa por archivo y línea."
2. Combina y edita: el líder elimina duplicados, ordena por gravedad y es el único que edita, de modo que los trabajadores no colisionen.
3. Revisa: ejecuta un revisor nuevo, como la skill integrada /code-review, sobre el diff.

Avanzado: varias sesiones, un líder y tú como última barrera

Este es un patrón de trabajo construido con funciones documentadas, no un modo integrado. La documentación describe un líder integrado solo para los equipos de agentes, que son experimentales y están desactivados por defecto; allí, las solicitudes de permisos de los compañeros aparecen en la sesión líder, con un mayor costo de tokens.

• La misma lógica: los archivos CLAUDE.md del proyecto y la configuración de permisos se pueden compartir mediante el control de versiones.
• Archivos separados: claude --worktree schema-fixes inicia una sesión en su propia rama bajo .claude/worktrees/; la documentación de worktrees sugiere agregar esa carpeta a .gitignore.
• Mensajes: la mensajería entre sesiones permite que Claude enumere tus otras sesiones y les envíe texto sin formato. Requiere Claude Code 2.1.224 o posterior (2.1.234 en Windows nativo).

1. Haz commit de las reglas y divide por archivos: todas las sesiones empiezan igual y ninguna comparte un archivo con otra.
2. Nombra las sesiones con --name o /rename; revísalas con /list-agents, o menciona una con @name.
3. El líder asigna por mensaje; los trabajadores hacen commit y devuelven un resumen por mensaje.
4. El líder revisa cada diff, ejecuta las comprobaciones y rechaza las ediciones fuera del alcance. Tú revisas su lista breve.

Prácticas seguras y qué dice Google sobre el contenido con IA

• Lee cada diff. La página de seguridad de Anthropic indica que eres responsable de revisar el código y los comandos propuestos.
• Mínimo privilegio, sin secretos: permite las lecturas, pide confirmación para las escrituras y nunca pongas claves ni contraseñas en los prompts, en CLAUDE.md ni en configuraciones con commit.

Un orden sensato para adoptar todo esto

1. Instala Claude Code, abre una carpeta de cliente y ejecuta git init si hace falta.
2. Escribe un CLAUDE.md breve, deniega Read(./.env) y cambia al modo Manual para los archivos de clientes.
3. Ejecuta una auditoría de solo lectura en modo plan.
4. Conecta ZeusSEO y permite solo las herramientas de lectura.
5. Haz un cambio en bloque en una rama, con una comprobación.
6. Agrega un subagente revisor de solo lectura, luego una segunda sesión en su propio worktree y después un líder con nombre.

¿Gestionas muchas ubicaciones? El mismo enfoque encaja con nuestras guías sobre varias ubicaciones, optimización del perfil y respuestas a reseñas. Tu siguiente paso es la guía del MCP de Google Business Profile, que conecta el conector de ZeusSEO. Si prefieres leer sobre un experto ya listo en lugar de armar el tuyo, también existe Athena (en acceso anticipado).