Terminal de Claude Code ejecutando la instalación del plugin Claude SEO

Cómo instalar Claude SEO en Claude Code: guía paso a paso 2026

PorWeb Marketing MX

Instalar Claude SEO en Claude Code te da un sistema de auditoría SEO con 25 sub-skills y 18 agentes que corren en paralelo. Es open source, licencia MIT, y funciona local sin telemetría. En esta guía verás las dos formas de instalarlo y cómo lanzar tu primera auditoría en minutos.

Qué es Claude SEO

Claude SEO es un plugin para Claude Code que audita SEO técnico, calidad de contenido (E-E-A-T), Schema.org, optimización para búsqueda con IA (GEO/AEO), SEO local, e-commerce y SEO internacional. Cada auditoría entrega un plan de acción priorizado.

Lo que lo diferencia es que cada recomendación viene con una verificación de falsabilidad. Es decir, un chequeo explícito de “cómo sabríamos que esto falló”. Está alineado con la guía de optimización para IA de Google y con las Quality Rater Guidelines de septiembre 2025.

Si ya usas Claude Code para operar tu stack —por ejemplo, para controlar WordPress con Royal MCP o para orquestar automatizaciones con n8n— Claude SEO suma la capa de auditoría de búsqueda a ese mismo flujo de trabajo.

Requisitos previos

Antes de instalar, asegúrate de tener:

  • Claude Code CLI instalado y funcionando.
  • Python 3.10 o superior.
  • Git instalado en tu sistema.
  • Opcional: Playwright Chromium para renderizar sitios con mucho JavaScript. El script de instalación lo instala solo.
  • Opcional: credenciales de Google API para datos enriquecidos de Core Web Vitals, Search Console y GA4.

Puedes verificar Python y Git con estos comandos:

python --version
git --version

Opción 1: instalar Claude SEO como plugin

Esta es la vía más rápida. Requiere Claude Code 1.0.33 o superior. Es un alta única al marketplace y luego la instalación del plugin.

Abre Claude Code con el comando claude y dentro ejecuta:

/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo

Al terminar ya tendrás disponibles todos los comandos /seo.

Opción 2: instalación manual en Windows con PowerShell

Si prefieres revisar el código antes de ejecutarlo, la instalación manual es la opción segura. Clona el repo y corre el script de PowerShell:

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1

💡 Por qué así: se recomienda git clone en lugar de irm | iex porque te deja inspeccionar install.ps1 antes de correrlo. Las propias reglas de seguridad de Claude Code marcan la descarga y ejecución remota sin verificación como un riesgo de cadena de suministro.

Instalación manual en macOS o Linux

Si trabajas en Unix, el flujo es equivalente con el script de bash:

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh

El script coloca los skills y agentes en la ruta correcta para que Claude Code los detecte de forma automática.

Verifica la instalación y lanza tu primera auditoría

Arranca Claude Code y corre una auditoría completa de un sitio. Los sub-agentes se reparten el trabajo en paralelo y generan un reporte en Markdown.

claude
/seo audit https://tudominio.com

Si el reporte se genera, la instalación quedó correcta. Para sitios de una sola página o análisis puntuales, usa /seo page con la URL específica.

Comandos esenciales de Claude SEO

Estos son los comandos que más vas a usar en el día a día:

  • /seo audit <url>: auditoría completa del sitio con delegación en paralelo.
  • /seo page <url>: análisis profundo de una sola página.
  • /seo schema <url>: detecta, valida y genera marcado Schema.org.
  • /seo geo <url>: optimización para AI Overviews y búsqueda generativa.
  • /seo local <url>: SEO local con perfil de Google Business, citas y reseñas.
  • /seo sitemap generate: genera sitemaps XML con plantillas por industria.

Extensiones opcionales

El núcleo funciona sin ninguna API externa. Si más adelante quieres datos en vivo, puedes sumar extensiones MCP:

  • DataForSEO para datos de SERP, keywords y backlinks.
  • Firecrawl para rastreo de sitio completo.
  • Banana para generación de imágenes SEO.
  • Google APIs con el asistente /seo google setup para Search Console, GA4 y PageSpeed. Si quieres el paso previo, revisa cómo conectar Google Search Console a Claude Code.

Errores comunes y cómo resolverlos

Si /plugin marketplace add devuelve un 404, revisa que tu versión de Claude Code sea 1.0.33 o superior. Si los comandos /seo no aparecen tras la instalación manual, confirma que el script terminó sin errores y reinicia Claude Code.

Si las auditorías fallan en sitios con mucho JavaScript, verifica que Playwright Chromium quedó instalado. El renderizado headless es lo que permite auditar aplicaciones de una sola página como Next.js, React o Vue.

Preguntas frecuentes: Claude SEO

Aquí resolvemos tus dudas técnicas más comunes sobre la implementación y operación de la herramienta. Diseñada bajo un enfoque de transparencia, privacidad y alto rendimiento, esta solución open source se integra en tu stack tecnológico para auditar y optimizar tu sitio con precisión quirúrgica. Descubre cómo configurarla de forma segura, compatible con arquitecturas modernas y sin depender de servicios de terceros.

Sí. Tiene licencia MIT, es open source y no cobra por dominio ni impone cuotas. Algunas extensiones opcionales envuelven servicios de pago, pero en esos casos utilizas siempre tu propia cuenta directamente.

No son obligatorias. La herramienta funciona al 100% sin ninguna API key. Agregar credenciales de Google es un paso opcional que solo desbloquea datos de campo reales y el estado de indexación en vivo.

Sí. Incluye un renderizador headless basado en Playwright que detecta aplicaciones de una sola página (SPA) y cambia a un fetch renderizado de forma automática para asegurar la captura correcta de datos.

Se requiere Claude Code 1.0.33 o superior. Si te encuentras en versiones anteriores, deberás utilizar la instalación manual mediante el script específico para tu sistema operativo.

No por defecto. El plugin opera en modo local y no transmite información. Tus datos solo salen de tu equipo si activas extensiones o APIs específicas que consultan endpoints externos de manera explícita bajo tu autorización.

Documentado por webmarketingmx.pro • Basado en el proyecto open source github.com/AgriciDaniel/claude-seo • MIT License

Publicaciones Similares