how-i-use-claude-code-for-seo-audits.html
< BACK Una ventana de terminal limpia con un cursor suave sobre un escritorio de madera junto a una pequeña lupa, sugiriendo análisis de código asistido por IA

Cómo uso Claude Code para auditorías técnicas de SEO en 2026

Gestiono búsqueda orgánica en 91,000 páginas en Deluxe Astrology, 28,000 páginas de SEO programático en HostList.io, y en toda la cartera de clientes de Seahawk Media. El trabajo de auditoría que solía tomarme un día completo por sitio ahora toma 90 minutos dentro de Claude Code, y el resultado es más riguroso que la versión manual. Este es el flujo de trabajo actual que ejecuto, el stack MCP detrás de él, el prompt que uso, y las partes de una auditoría de SEO que Claude Code aún no puede hacer bien.

Si estás evaluando si las auditorías asistidas por IA son reales, este post es la respuesta del operador: sí, con disciplina, y solo si tratas a Claude como el colaborador ingeniero senior en lugar del estratega senior.

Por qué Claude Code supera las herramientas de auditoría tradicionales para el aburrido 70%

Una auditoría técnica de SEO tradicional implica que Screaming Frog rastree un sitio, Search Console extraída para la vista de indexabilidad y CWV, Lighthouse ejecutado algunas veces en plantillas representativas, markup de esquema revisado manualmente contra un validador, y finalmente un humano ensamblando todo eso en una lista de remediación priorizada con severidad e impacto de tráfico. El rastreo y análisis es aproximadamente el 70 por ciento del tiempo de reloj. La capa de criterio es el 30 por ciento restante.

Claude Code con el stack MCP correcto colapsa el 70 por ciento. La ejecución del rastreo, análisis, deduplicación, validación de esquema, y redacción de informes suceden en una sola sesión contra tu repositorio o tu sitio alojado. El 30 por ciento que requiere criterio senior (cuáles problemas realmente importan para este negocio específico, qué priorizar dado el tiempo y la capacidad del equipo) permanece siendo humano. El tiempo de reloj combinado se reduce aproximadamente 6 veces con la misma calidad o superior.

Ese es el pitch completo. Todo lo que sigue son los detalles operativos de cómo hacerlo funcionar en realidad.

El stack MCP que realmente uso

Otros escritos sobre Claude Code para SEO usan un único MCP (generalmente Puppeteer) y se detienen ahí. El stack honesto para trabajo de auditoría serio es más amplio:

Filesystem MCP

Integrado en Claude Code por defecto. Lo uso para volcar los resultados de auditoría en un directorio de trabajo, y luego hago que Claude razone sobre ellos en la misma sesión. El Filesystem MCP también es cómo le proporciono a Claude reportes existentes, mapas del sitio, robots.txt y cualquier documentación técnica preexistente.

Puppeteer MCP

Automatización de navegador. Rastrea el sitio, toma capturas de pantalla de plantillas representativas, extrae HTML renderizado para páginas con mucho JavaScript, captura Core Web Vitals a través de la Performance API. El renderizado impulsado por Puppeteer es lo más parecido a lo que Google realmente ve, más preciso que el análisis estático de HTML.Core Web Vitals via the Performance API. The Puppeteer-driven render is the closest thing to what Google actually sees, more accurate than static HTML parsing.

Postgres MCP (o SQLite para trabajos más pequeños)

Crítico para auditorías serias. Los datos de Search Console exportados como CSV se cargan en una tabla de Postgres. Claude ejecuta consultas SQL contra ellos: qué URLs están perdiendo tráfico mes a mes, qué consultas se desplazaron, qué páginas desaparecieron del índice. El trabajo de agregación que toma 20 minutos en Excel toma 30 segundos en SQL.

Brave Search o similar

Comparación actual de SERP. Al auditar regresiones de ranking, comparar lo que actualmente rankea para las consultas objetivo contra lo que envía el sitio auditado es la mitad del diagnóstico. Una herramienta MCP que extrae SERPs convierte esto en una única llamada a herramienta en lugar de un ejercicio manual de cambiar pestañas.

Bash / shell

Claude Code ejecuta Lighthouse CLI, pruebas curl para cadenas de redirecciones, y cualquier script personalizado que tenga para el proyecto. Tratar el shell como otra herramienta en lugar de un entorno separado es importante; la auditoría ocurre en una sesión continua.

Preparación previa a la auditoría: 90 segundos de contexto

Antes de que se ejecute cualquier crawl, Claude necesita saber qué tipo de sitio es este y para qué es la auditoría. Abro Claude Code en el directorio del proyecto (o un directorio nuevo si estoy auditando un sitio externo) e inicio la sesión con un resumen breve:

Tres oraciones sobre el negocio: qué venden, quién es su audiencia, cuál es su objetivo de tráfico orgánico para los próximos 12 meses. Dos oraciones sobre la forma del sitio: stack, cantidad de páginas, forma de indexabilidad, cadencia de contenido. Una oración sobre el resultado de la auditoría: qué debería ser verdad al final de la auditoría que no lo es hoy.

Esos 90 segundos de carga de contexto son la diferencia entre Claude generando una auditoría de checklist genérica y Claude produciendo una auditoría calibrada al negocio específico. Omítelo y obtendrás el mismo resultado genérico que demuestra cada otro writeup de SEO con Claude Code.

Fase 1: Crawl técnico

Claude ejecuta Puppeteer contra el sitio, sigue enlaces internos a una profundidad configurable (por defecto uso 3), y captura: HTML renderizado por URL, códigos de respuesta, cadenas de redirección, etiquetas canónicas, anotaciones hreflang, bloques de schema markup, señales de indexabilidad (robots meta, X-Robots-Tag, robots.txt), y Core Web Vitals.

La salida se vuelca a ./audit-output/crawl/ como un archivo JSON por URL más un summary.json en todo el corpus. Para sitios de menos de 500 páginas esto se completa en menos de 10 minutos. Para sitios más grandes limito el crawl a 1.000 URLs representativas y muestreo el resto.

Patrones comunes que el rastreo identifica de inmediato: cadenas de redirecciones de más de 2 saltos, etiquetas canónicas que apuntan a URLs no canónicas, ruptura de reciprocidad en hreflang, errores de validación de esquema. Cada uno de estos requiere horas de trabajo manual para encontrarlo a escala; el rastreo los encuentra en los primeros 10 minutos.

Fase 2: Análisis de datos de Search Console

Exporto los datos de Search Console como CSV (consultas, páginas, fechas, clics, impresiones, posición) y los cargo a través de Postgres MCP. Claude entonces ejecuta una secuencia de consultas que responden preguntas específicas del operador:

Qué páginas están perdiendo más tráfico mes a mes, clasificadas por pérdida absoluta de clics.

Qué consultas salieron del top 20 en los últimos 90 días.

Qué pares página-consulta tienen impresiones pero clics cercanos a cero (oportunidad de CTR).

Qué páginas están indexadas pero reciben cero impresiones en los últimos 30 días (candidatos probables a contenido delgado o filtro de calidad).

Qué páginas tienen múltiples señales canónicas en competencia en el índice.

Cada una de estas solía ser una pestaña separada de tablas dinámicas en Excel. Ahora son una secuencia de consultas SQL que Claude genera, ejecuta y sintetiza en una sola sección del informe.

Fase 3: Auditoría de marcado de esquema

Claude toma los bloques de esquema capturados en la Fase 1, los valida contra los tipos esperados de schema.org por arquetipo de página (Organization, BreadcrumbList, Article, BlogPosting, Product, FAQPage, HowTo, LocalBusiness) e identifica problemas:

Propiedades requeridas faltantes (sameAs en Organization, image en BlogPosting, aggregateRating sin datos de calificación reales).

Desajustes de tipo (esquema LocalBusiness en páginas que no son negocios locales, esquema Product en páginas de categoría).

Referencias obsoletas (URLs en sameAs apuntando a perfiles de redes sociales eliminados, URLs de imagen que devuelven 404).

Relaciones de entidades desactualizadas (arrays about y mentions sin las entidades reales que cubre la página).

He detectado 30+ errores de esquema de esta manera en sitios que pensaban que su esquema estaba bien. El validador encuentra los errores sintácticos; Claude encuentra los semánticos.

Fase 4: Core Web Vitals vía Lighthouse

Lighthouse se ejecuta como comando CLI que Claude invoca. Por defecto ejecuto entre 8-12 plantillas representativas por sitio en lugar de una sola URL. Los JSONs de salida se guardan en ./audit-output/lighthouse/ y Claude los sintetiza en una sección de CWV que muestra la mediana de LCP, CLS, INP y TTFB en el conjunto de plantillas, más la página de peor desempeño individual por métrica.

La síntesis es lo que los auditorías manuales hacen mal. Una sola ejecución de Lighthouse es ruido de un momento puntual; 12 ejecuciones en plantillas es la verdadera imagen de desempeño. Claude hace la agregación en segundos.

Fase 5: Síntesis del informe

Después de las cuatro fases, Claude ha identificado aproximadamente entre 30 y 80 problemas. El prompt de síntesis le pide a Claude que:

Agrupe los problemas por severidad (rojo bloquea la publicación, ámbar afecta el ranking, verde es pulido).

Estime el impacto en tráfico por cluster usando datos de Search Console.

Ordene la remediación por impacto en tráfico dividido entre costo de ingeniería.

Genere los 10 principales problemas en formato de una página por problema: severidad, cantidad de URLs afectadas en tráfico, explicación en inglés plano, solución concreta, mejora estimada de métrica en 90 días.

Ese es el entregable. 10 problemas que un equipo senior puede solucionar en 4 a 8 semanas, priorizados por impacto, listos para entregar a ingeniería. Las auditorías manuales suelen producir hojas de cálculo de 200 filas que nadie soluciona; la lista de 10 problemas priorizados sí se soluciona.

El prompt de auditoría que realmente uso

Un único prompt que ejecuto después del contexto de 90 segundos. He iterado sobre esto aproximadamente 12 meses en docenas de auditorías:

"Eres un auditor técnico de SEO senior trabajando en el sitio descrito en el resumen anterior. Ejecuta una auditoría de 5 fases en este orden: rastreo técnico vía Puppeteer, análisis de Search Console vía Postgres MCP, validación de schema, Core Web Vitals vía Lighthouse CLI, y síntesis del reporte priorizado. Guarda los resultados en ./audit-output/. Después de la fase de síntesis, presenta los 10 principales problemas en formato de una página por problema. Para cada problema: severidad (rojo / ámbar / verde), cantidad de URLs afectadas en tráfico, explicación en inglés plano, solución concreta, mejora estimada de métrica en 90 días. Espera mi aprobación antes de generar patches de corrección. Usa ortografía británica. Evita guiones largos."

Sin marcos de John Wick, sin teatro de "eres un experto pagado". La instrucción es directa, la estructura es explícita, y el formato de salida coincide con lo que leen clientes y equipos de ingeniería.

Lo que Claude Code no puede hacer aquí

Lista honesta de dónde el auditoría asistida por IA llega a su límite:

Priorización estratégica en el contexto del negocio. Claude puede clasificar problemas por impacto de tráfico; no puede decirte que una pérdida de 5,000 visitantes en una página de marketing importa más que una pérdida de 50,000 visitantes en una página de producto descontinuado que la empresa está eliminando de todas formas.

Posicionamiento competitivo. Claude puede comparar tus SERPs con los competidores mecánicamente; no puede decirte que el competidor está ganando por una campaña de marca que no ves en los datos.

Criterio editorial sobre la calidad del contenido. Claude puede marcar contenido delgado estadísticamente. Si el contenido delgado debe eliminarse, expandirse o mantenerse como una página de bajo valor pero relevante para un nicho es una decisión humana.

Comunicación con stakeholders. El auditoría cae bien o mal según cómo se presente al equipo del cliente. Esa presentación es trabajo humano.

Trata Claude Code como el colaborador senior de ingeniería en el auditoría, no como el estratega senior. El 30 por ciento del auditoría que es criterio sigue siendo tuyo.

El costo honesto

Los costos de la API de Claude para una auditoría de 1,000 páginas rondan 8 a 25 USD con precios del nivel Sonnet. El rastreo de Puppeteer, las ejecuciones de Lighthouse y las consultas de Postgres son gratuitos; el costo está completamente en los tokens del modelo. Un auditoría manual tradicional a tasas de agencia cuesta 5,000 a 25,000 USD. La brecha de costo es real y es la razón por la que este flujo de trabajo se convertirá en estándar en 18 meses.

El trabajo se desplazó, no desapareció. El auditoría aún requiere un especialista en SEO senior para ejecutar los prompts, interpretar el resultado y ser responsable de la priorización estratégica. Lo que desapareció son las 6 horas de rastreo, análisis y agregación que ninguna persona senior debería haber pasado tiempo haciendo.

Conclusión

Claude Code con un stack MCP real reduce el 70 por ciento de una auditoría SEO a una sesión de 90 minutos. El 30 por ciento restante (criterio, priorización, comunicación) sigue siendo trabajo humano y paga mejor que nunca porque el costo del 70 por ciento aburrido ha caído casi a cero.

Las agencias que adapten este flujo de trabajo superarán en precio a las que no lo hagan dentro de 12 meses. Los SEO senior que lo aprendan se vuelven más valiosos, no menos, porque su criterio es la restricción vinculante en el volumen de producción.

En Seahawk Media realizamos auditorías técnicas de SEO usando exactamente este flujo de trabajo en compromisos con clientes a partir de 2,500 USD. La primera conversación es gratuita y el entregable de auditoría es la misma lista de 10 problemas priorizados descrita arriba, sin importar qué nivel de agencia elijas.

Lecturas relacionadas

Cómo ejecutar una auditoría técnica de SEO en 2026 (el pilar de la metodología)

SEO para operadores en 2026 (la guía de términos principales)

Las mejores herramientas de seguimiento de SERP en 2026

Preguntas frecuentes

¿Cómo Claude Code acelera las auditorías de SEO?

Automatiza el 70% tedioso de una auditoría técnica: rastreo, análisis de Search Console, verificación de esquema y Core Web Vitals mediante Lighthouse, usando un stack MCP. El trabajo que tomaba un día completo por sitio ahora toma aproximadamente 90 minutos, dejando tiempo humano para el juicio y la estrategia.

¿Qué stack MCP usas para las auditorías de SEO?

El flujo de trabajo se ejecuta en servidores MCP de Puppeteer, Filesystem, Postgres y Lighthouse. Puppeteer rastrea, Filesystem y Postgres manejan datos, y Lighthouse mide Core Web Vitals. Esa combinación cubre las fases mecánicas de una auditoría técnica.

¿Puede Claude Code reemplazar a un consultor de SEO?

No. Colapsa el 70% repetitivo de una auditoría, el rastreo, las extracciones de datos y las verificaciones, pero el juicio, la priorización y la estrategia aún necesitan un humano. Es un multiplicador de fuerza para el consultor, no un reemplazo de la experiencia que decide qué realmente importa.

¿Cuánto tiempo toma una auditoría de SEO con Claude Code?

Aproximadamente 90 minutos para la parte técnica, reducido de un día completo. Las cinco fases, rastreo, análisis de Search Console, auditoría de esquema, Core Web Vitals y síntesis de informes, se ejecutan rápido con el stack MCP correcto y un paso breve de contextualización al inicio.

< BACK