Cómo audité el SEO de mi blog con Claude Code

Auditar un blog con Claude Code sirve para encontrar problemas de estructura, metadatos, enlaces internos, slugs, contenido duplicado y oportunidades AEO más rápido. No sustituye una auditoría SEO profesional, pero sí ayuda a documentar patrones y convertir hallazgos en tareas accionables.

¿Por qué audité mi propio blog con Claude Code?

Lo hice porque quería revisar el blog como sistema, no como una colección de posts sueltos. Una cosa es leer un artículo y pensar “está bien”. Otra muy distinta es revisar si todos los artículos tienen metadatos consistentes, rutas claras, enlaces internos, estructura AEO y oportunidades de actualización.

Este artículo debe leerse como caso documentado de proceso, no como promesa de resultados mágicos. La IA puede acelerar una auditoría, pero no reemplaza la interpretación. Claude Code puede recorrer archivos, encontrar patrones, comparar estructuras y sugerir cambios. Pero decidir qué importa, qué se publica y qué se prioriza sigue siendo trabajo estratégico.

Mi objetivo fue responder preguntas concretas: ¿qué artículos están listos para competir?, ¿cuáles se quedaron cortos?, ¿qué slugs no son claros?, ¿dónde faltan FAQs?, ¿qué piezas deberían enlazarse entre sí?, ¿qué temas podrían convertirse en clústeres? Esa clase de preguntas no se resuelve con un “análisis general”. Se resuelve con revisión sistemática.

Lo interesante fue que Claude Code me ayudó a ver el blog como producto editorial. No solo como contenido. Y cuando ves un blog como producto, empiezas a notar deuda técnica, deuda de información y deuda de posicionamiento.

¿Qué revisaría primero en una auditoría SEO con IA?

Primero revisaría lo que puede impedir que el contenido se entienda: títulos, metadescripciones, H1, slugs, categorías, enlaces internos, estructura de encabezados y respuesta directa a la intención de búsqueda. Después revisaría profundidad, autoridad y diferenciación.

Google explica que el SEO ayuda a los buscadores a entender contenido y a los usuarios a encontrar un sitio mediante búsqueda ¹. Esa definición se vuelve más importante cuando además queremos que motores de respuesta puedan interpretar el contenido. No basta con que exista un artículo. Tiene que tener señales claras de tema, intención, autoría y utilidad.

Mi primera capa de auditoría se ve así:

Claude Code ayuda porque puede revisar muchos archivos con el mismo criterio. El humano ayuda porque entiende si ese criterio tiene sentido para el posicionamiento de la marca.

¿Cómo preparé la auditoría antes de pedirle algo a Claude Code?

Preparé la auditoría definiendo un checklist, una taxonomía de problemas y el formato de salida esperado. Si no le dices a la IA qué buscar y cómo reportarlo, te devolverá observaciones útiles mezcladas con ruido.

Este punto es clave. Muchas personas piden “audita mi blog” y esperan una respuesta brillante. Pero una auditoría buena necesita alcance. No es lo mismo revisar SEO técnico, contenido, AEO, conversión, enlaces internos o performance. Todo puede importar, pero no todo se revisa igual.

Antes de correr cualquier análisis, definí tres niveles:

1. Problemas críticos. Cosas que afectan entendimiento, indexación, rutas, duplicados o estructura base.
2. Mejoras editoriales. Respuestas débiles, títulos vagos, falta de ejemplos, poca autoridad o secciones incompletas.
3. Oportunidades estratégicas. Nuevos clústeres, artículos puente, comparativas, FAQs y enlaces internos.

Después pedí una salida tabular. Eso evita que el análisis quede como párrafo inspirador. Una auditoría debe convertirse en backlog. Si no se puede asignar, priorizar o ejecutar, todavía no es auditoría; es opinión.

¿Qué prompts usé para auditar el blog?

Usé prompts que separan exploración, diagnóstico y acciones. Primero pedí inventario; después evaluación; luego priorización. Esa secuencia evita que la IA proponga cambios antes de entender el sistema.

Un primer prompt útil sería:

Revisa la estructura de este blog como sistema editorial. Crea un inventario de artículos, slugs, categorías, title SEO, meta description, H1, número de H2, presencia de FAQ, enlaces internos y CTA. No propongas cambios todavía.

Después viene el diagnóstico:

Con base en el inventario, identifica problemas SEO y AEO. Clasifica cada hallazgo como crítico, medio o bajo. Explica por qué importa y qué acción concreta recomiendas.

Y finalmente la priorización:

Convierte los hallazgos en un backlog de mejora. Ordena por impacto SEO/AEO, dificultad de implementación y relación con servicios de diseño UX/UI, Webflow, IA, neuromarketing, branding y paid media.

Claude Code funciona especialmente bien en este tipo de tareas porque puede trabajar dentro del proyecto, leer archivos, buscar patrones y sintetizar hallazgos. Anthropic describe que Claude Code puede automatizar tareas de desarrollo, trabajar con archivos, ejecutar comandos y entender codebases completos ². Para un blog estático o basado en archivos, esa capacidad se vuelve muy útil.

¿Qué hallazgos buscaría en un blog como blog.israelpina.cool?

Buscaría si el blog construye autoridad alrededor de temas claros: diseño con IA, Webflow, UX/UI, neuromarketing, branding y paid media. También revisaría si cada artículo conecta con servicios, casos o recursos que puedan convertir la lectura en una conversación.

No se trata de publicar por publicar. Se trata de construir clústeres. Si un blog tiene un artículo sobre AEO, debería conectarse con llms.txt, JSON-LD, citabilidad en ChatGPT, auditorías SEO y Webflow. Si tiene artículos sobre diseño con IA, debería conectar Figma, Claude, prompts, prototipado, ética y flujo de trabajo.

La auditoría debe responder si esos pilares están vivos o solo aparecen como categorías. Una categoría sin enlaces internos, sin artículos pilar y sin CTA claro es una etiqueta, no una estrategia.

¿Cómo convierto hallazgos en acciones concretas?

Convierto hallazgos en acciones usando una matriz de impacto y esfuerzo. No todo lo encontrado debe corregirse de inmediato. Primero van las mejoras que aumentan claridad, enlazado interno y conversión sin requerir reescrituras enormes.

Mi matriz simple es esta:

La auditoría con IA brilla cuando convierte problemas repetitivos en tareas repetibles. Por ejemplo: “todos los artículos AEO deben iniciar con una definición directa”, “todos los artículos de Webflow deben enlazar a servicios”, “cada post debe tener FAQ y CTA suave”, “cada clúster debe tener un artículo pilar”.

Ese tipo de reglas editoriales hacen que el blog mejore como sistema. Y cuando el sistema mejora, cada artículo nuevo hereda mejores condiciones.

¿Qué errores evitaría al auditar SEO con Claude Code?

Evitaría aceptar recomendaciones sin verificar, reescribir todo por ansiedad, optimizar solo para keywords y confundir cantidad de hallazgos con calidad de auditoría. Una buena auditoría prioriza; una mala auditoría abruma.

El error más común es dejar que la IA proponga cambios infinitos. Siempre habrá algo que mejorar. Pero no todo mejora el negocio. Si el objetivo es atraer clientes de diseño, Webflow o estrategia digital, la priorización debe conectar con esos servicios. Un artículo puede estar “SEO correcto” y aun así no mover la aguja.

Otro error es aplicar automatización sin control editorial. Si actualizas títulos, metadescripciones y enlaces internos masivamente, revisa consistencia de tono. La IA puede hacer una meta description funcional, pero quizá no suena como tu marca. Y en un blog personal-profesional, la voz importa.

También evitaría medir el éxito solo por tráfico. Para un consultor o estudio, importa calidad: consultas correctas, autoridad percibida, tiempo de lectura, enlaces internos recorridos, leads calificados y capacidad de ser citado.

Checklist para auditar tu blog con Claude Code

Antes de cerrar la auditoría, revisaría lo siguiente:

1. Existe inventario completo de artículos y metadatos.
2. Cada artículo tiene H1 claro y único.
3. Cada meta description promete una respuesta concreta.
4. Los slugs son legibles y alineados al tema.
5. Los H2 responden preguntas reales.
6. Hay enlaces internos entre artículos del mismo clúster.
7. Las FAQs responden dudas long-tail, no relleno.
8. Cada artículo tiene CTA suave relacionado con servicios.
9. Los artículos pilar están identificados.
10. Los hallazgos están priorizados por impacto y esfuerzo.

La auditoría termina cuando existe un plan accionable. Si solo tienes un documento largo, todavía falta convertirlo en decisiones.

Preguntas frecuentes

¿Claude Code puede hacer una auditoría SEO completa?

Puede ayudar mucho con inventario, patrones, estructura y recomendaciones, pero no reemplaza análisis estratégico, investigación de keywords, datos de Search Console ni criterio editorial.

¿Necesito que mi blog sea de código para usar Claude Code?

Funciona mejor si el blog vive en archivos o repositorio. Si está en CMS cerrado, se puede usar con exports, sitemaps, scraping o documentación, pero cambia el flujo.

¿Qué diferencia hay entre auditar SEO y AEO?

SEO revisa visibilidad en buscadores; AEO revisa si el contenido responde con claridad y puede ser usado por motores de respuesta. Se complementan.

¿Puedo automatizar cambios en todos mis posts?

Puedes, pero conviene hacerlo con revisión. Automatizar sin control puede romper tono, enlaces, formato o metadatos.

¿Qué revisaría primero si tengo poco tiempo?

Revisaría titles, metas, H1, respuesta directa al inicio, enlaces internos y CTA. Son cambios de alto impacto y esfuerzo relativamente bajo.

CTA suave

Si quieres convertir tu blog en un sistema editorial más claro para SEO, AEO y conversión, escríbeme a hola@israelpinapol.com o visita israelpina.cool. La IA puede acelerar la auditoría, pero la estrategia decide qué vale la pena corregir.

---

1. Google Search Central, “Search Engine Optimization Starter Guide”, consultado para definición operativa de SEO, contenido útil y descubrimiento: https://developers.google.com/search/docs/fundamentals/seo-starter-guide ↩
2. Anthropic Docs, “Claude Code Overview”, consultado para capacidades de lectura de codebase, edición de archivos, ejecución de comandos y automatización de tareas: https://docs.anthropic.com/en/docs/claude-code/overview ↩