Auditoría SEO completa directamente en la terminal con el plugin Claude SEO
Una auditoría SEO típica generalmente se convierte en una tarea tediosa. Abres Ahrefs o Screaming Frog, exportas gigabytes de tablas CSV, y luego pasas mucho tiempo tratando de descubrir cuáles de los quinientos errores encontrados realmente afectan el tráfico y cuáles son solo ruido. Después de eso, tienes que transferir manualmente las tareas al backlog de los desarrolladores.
Hace poco me encontré con un proyecto de código abierto claude-seo. Es una extensión para la herramienta CLI de Claude Code que maneja todo el trabajo rutinario de análisis SEO y entrega una hoja de ruta lista directamente en la consola.
Qué hace interesante a esta herramienta
El proyecto resuelve el problema principal de la mayoría de los servicios SEO: no solo genera una pared de métricas, sino que construye verificación alrededor de la falsabilidad. Cada recomendación en el informe tiene cuatro campos obligatorios:
- Observación de la fuente (en qué se basa la conclusión)
- Conexión con otras tareas en el grafo de dependencias
- Criterios de verificación claros ("cómo saber si la hipótesis no funcionó")
- Indicador principal para seguimiento de resultados
Dentro del plugin, trabajan 25 submódulos y 18 agentes especializados. Cuando ejecutas una auditoría del sitio, el sistema activa hasta 15 procesos en paralelo. Analizan simultáneamente el aspecto técnico, la validez del microdatos Schema.org, la calidad del contenido según las directrices E-E-A-T y la preparación de la página para respuestas de IA de búsqueda (GEO).
Enfoque en el nuevo tipo de resultados de búsqueda
El desarrollador del proyecto se orientó hacia las directrices actuales de Google sobre optimización de IA. La herramienta evalúa la citabilidad de bloques de texto (el fragmento ideal tiene entre 134 y 167 palabras con una respuesta completa a la pregunta), la densidad de atribución de hechos y la presencia de marca en plataformas externas como Reddit, YouTube y LinkedIn.
Al mismo tiempo, el autor desmiente abiertamente mitos populares. Basándose en fuentes primarias, el plugin tiene en cuenta que el archivo robots.txt actualmente no afecta las citas de Google, no se requiere la división artificial de contenido en fragmentos, y reescribir textos para palabras clave de IA es inútil: los motores de búsqueda funcionan bien entendiendo sinónimos.
Qué puede hacer el plugin en la práctica
La herramienta añade 32 comandos a la interfaz de Claude Code. Estas son las principales áreas de trabajo:
Auditoría rápida y análisis técnico
El comando /seo audit https://example.com ejecuta una verificación en paralelo de todo el sitio. Si necesitas un análisis de una sola página, el comando /seo page te da un segmento exacto de encabezados, meta tags y estructura. Las métricas técnicas se verifican mediante /seo technical — rastrea los Core Web Vitals (LCP, INP, CLS) sin parámetros obsoletos como FID.
Validación de Schema.org
Usando /seo schema, puedes encontrar bloques JSON-LD existentes, verificar su corrección e inmediatamente generar el marcado que falta. El plugin conoce la depreciación de resultados enriquecidos para FAQ y HowTo, así que no sugerirá perder tiempo con tipos de schema obsoletos.
SEO local y marketplaces
Los comandos /seo local y /seo maps analizan las señales de Google Business Profile, la consistencia de la dirección y el número de teléfono (NAP) en directorios y el sentimiento de las reseñas. Para proteger los sitios de penalizaciones por doorway pages, el plugin tiene límites integrados en el número de páginas geo.
Cómo instalar y ejecutar
La herramienta requiere que Claude Code CLI y Python 3.10 o superior estén instalados. El plugin se instala con un solo comando dentro de Claude Code:
/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup
El comando /seo setup crea un entorno Python aislado en la carpeta del plugin y descarga Chromium para Playwright. Los paquetes globales no se instalan en el sistema.
Si prefieres un script bash regular:
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh
Después de la instalación, puedes llamar a los comandos inmediatamente:
# Запустить аудит сайта
/seo audit https://mysite.com
# Проверить разметку Schema
/seo schema https://mysite.com/product/123
# Оценить готовность контента к AI-выдаче
/seo geo https://mysite.com/blog/article
Trabajar con API y extensiones
La funcionalidad básica del plugin funciona localmente y de forma gratuita. No necesita claves API para analizar páginas y generar informes. Pero si conectas las claves de Google, se abren posibilidades adicionales:
- En el nivel básico (clave API), se obtienen datos reales de PageSpeed Insights y tendencias de CrUX de 25 semanas.
- Al conectar OAuth o una cuenta de servicio, se añade la integración con Google Search Console y la API de Indexación.
- Conectar GA4 proporciona análisis de tráfico orgánico y páginas de destino.
- Para desarrolladores, está disponible la conexión con la API de Google Ads para estimar el volumen de demanda de búsqueda.
Además, se soportan servidores MCP externos: Ahrefs, DataForSEO, Firecrawl, Unlighthouse y SE Ranking.
Dónde será útil la herramienta
- Equipos internos de desarrollo y SEO. Es conveniente ejecutar
/seo auditun día antes de un sprint o antes de un lanzamiento para detectar canonicales rotos, problemas de hidratación en Next.js o marcado defectuoso. - Freelancers. Durante una llamada con el cliente, puedes armar un informe completo en Markdown con puntuaciones de 0 a 100 y una lista clara de correcciones en 10 minutos.
- Agencias. En lugar de compilar manualmente informes trimestrales, puedes configurar una ejecución semanal del script y rastrear regresiones usando el módulo
/seo drift.
Limitaciones y puntos débiles
La herramienta no es perfecta. En páginas con renderizado pesado del lado del cliente (CSR) o hidratación compleja que depende del scroll del usuario, el renderer headless a veces pierde contenido, creando falsos positivos. En tales casos, el autor recomienda ejecutar el sub-agente seo-visual y comparar su instantánea con el renderizado HTML sin procesar.
El segundo punto: sin APIs externas de pago (Ahrefs o DataForSEO), no obtendrás un análisis completo de backlinks de competidores. El plugin destaca en auditorías On-Page y técnicas, pero los datos Off-Page se limitan a fuentes gratuitas como Bing o Common Crawl.
claude-seo es un buen ejemplo de cómo los agentes LLM pueden simplificar el análisis rutinario. El proyecto se distribuye bajo la licencia MIT, el código es completamente abierto y el plugin no envía tus datos a servidores de terceros. Si usas Claude Code en tu trabajo diario y tratas con desarrollo web de cualquier manera, definitivamente vale la pena instalar y probar esta herramienta.
Proyectos relacionados