Explorar la documentación

Pack SEO / GEO: auditar la visibilidad en buscadores y en respuestas de IA

SEO / GEO: tres agentes auditan la visibilidad en buscadores y en respuestas generadas por IA (calidad del contenido, datos estructurados, preparación para IA) con 15 comandos. Instalación y límites.

En esta página
  1. Cuándo usarlo
  2. Qué se instala
  3. Inicio rápido
  4. Ejemplos para copiar
  5. Qué escribe y dónde
  6. Flujos de datos y requisitos
  7. Límites y trampas

El pack SEO / GEO audita un sitio web desde dos ángulos. SEO es la visibilidad en los resultados de los buscadores. GEO (generative engine optimisation) es la visibilidad en las respuestas que generan los asistentes de IA y los resúmenes de IA: si sus rastreadores pueden leer el sitio, si el contenido y los datos estructurados son lo bastante buenos para ser citados y cuán preparadas están las páginas. El pack aporta tres agentes que comparten un solo comando, /seo: Scout rastrea e inspecciona, Judge evalúa contenido, datos estructurados y preparación para la IA, y Chief puntúa, planifica e informa. Usa un pequeño kit de Python cuando está disponible y recurre a un modo de solo prompts cuando no, y entonces se niega a inventar cifras.

Cuándo usarlo

  • Antes de un lanzamiento o tras un rediseño, para detectar problemas de indexación, canonical, redirecciones y cabeceras de seguridad.
  • Cuando baja el tráfico orgánico y necesitas una lista priorizada de causas y un plan a 30, 60 y 90 días.
  • Para saber si los rastreadores de IA pueden leer el sitio, si tiene un archivo llms.txt y cuán citables son sus pasajes.
  • Para comparar tu sitio con el de un competidor o seguir la puntuación a lo largo del tiempo.

Qué se instala

SEO es un pack empaquetado: vive en .agents/skills/pack-seo/ con el enrutador SKILL.md (la habilidad se llama seo-engine), los tres archivos de agente seo-scout.md, seo-chief.md y seo-judge.md, una checklist.md, un pagespeed-playbook.md, archivos de referencia en ref/, plantillas de informe, requirements.txt y los scripts de Python en scripts/. El registro no enumera habilidades separadas para este pack.

Tres agentes, diez roles
AgenteRolesQué hace
SEO Scout (Technical Scanner)Crawler, Inspector, PhotographerRastrea y mapea el sitio, ejecuta nueve categorías de comprobaciones técnicas, toma capturas móviles y de escritorio.
SEO Judge (Content & AI Analyst)Content Expert, Schema Master, GEO AnalystCalifica E-E-A-T y calidad del contenido, valida datos estructurados, mide la preparación para la búsqueda con IA.
SEO Chief (Strategist & Reporter)Scorer, Strategist, Reporter, BenchmarkerCalcula la puntuación de salud SEO, prioriza problemas, redacta el plan y las correcciones, informa, compara y hace benchmark.

Los 15 comandos /seo

Enrutador de comandos
ComandoAgenteAcción
/seo full <url>Scout, Judge, ChiefLas seis fases
/seo quick <url>Scout, Judge, ChiefSolo las fases 1 a 4
/seo technical <url>Scout (Inspector)Solo las comprobaciones técnicas de la fase 2
/seo content <url>Judge (Content Expert)Solo las comprobaciones de contenido de la fase 2
/seo geo <url>Judge (GEO Analyst)Preparación para buscadores con IA (fase 3)
/seo schema <url>Judge (Schema Master)Detección y validación de datos estructurados
/seo images <url>Judge (Content Expert)Subconjunto de auditoría de imágenes
/seo hreflang <url>Scout (Inspector)Auditoría hreflang
/seo pagespeed <url>Scout y ChiefBucle de perfeccionamiento de PageSpeed
/seo plan <type>Chief (Strategist)Plan estratégico para saas, ecommerce, local, publisher o agency
/seo fixChief (Strategist)Generar correcciones desde la última auditoría
/seo historyChief (Reporter)Mostrar el historial de puntuaciones
/seo compareChief (Reporter)Comparar con la auditoría anterior
/seo competitor <url1> <url2>Scout, Judge, ChiefComparar dos sitios
/seo api <url>Un scriptAPI de Google: PageSpeed, CrUX, prueba de optimización para móviles

Las seis fases de una auditoría completa

  1. Reconocimiento: obtener la página de inicio, rastrear hasta profundidad 2 y como máximo 25 páginas, detectar el tipo de negocio (SaaS, comercio electrónico, local, editorial, agencia), buscar robots.txt, sitemap.xml y llms.txt. Un punto de control pregunta si se continúa.
  2. Análisis profundo, en paralelo: Scout revisa nueve categorías técnicas (rastreabilidad, indexabilidad, seguridad, estructura de URL, móvil, Core Web Vitals, detección de datos estructurados, renderizado de JavaScript, IndexNow) mientras Judge revisa E-E-A-T, calidad del contenido, schema e imágenes.
  3. Preparación para la IA: acceso de GPTBot, ClaudeBot y PerplexityBot, llms.txt, citabilidad de los pasajes (bloques de 134 a 167 palabras) y una puntuación de preparación para la IA de 0 a 100.
  4. Puntuación: la puntuación de salud SEO de 0 a 100, solo cuando cada categoría ponderada tiene datos verificados.
  5. Plan de acción: problemas clasificados como críticos, altos, medios o bajos, ganancias rápidas, hoja de ruta a 30, 60 y 90 días, correcciones generadas (etiquetas meta, JSON-LD, robots.txt, llms.txt). Un punto de control pregunta si se aplican las correcciones. Puede seguir un bucle de PageSpeed.
  6. Seguimiento, opcional: guardar los resultados en .bmad-seo/history/ y comparar con la auditoría anterior.
Ponderaciones de la puntuación de salud SEO
CategoríaPeso
SEO técnico20 %
Contenido y E-E-A-T22 %
SEO on-page18 %
Schema10 %
Rendimiento (Core Web Vitals)12 %
Preparación para IA (GEO)12 %
Imágenes6 %

Inicio rápido

  1. Instalar el pack

    Core se añade automáticamente. El modo solo prompts no necesita nada más.

    En la terminal del proyecto
    npx bmad-plus install --packs seo

  2. Opcional: aprovisionar el kit de Python

    Con --provision-python el instalador crea un entorno aislado en .bmad/venv/seo/ (requiere Python 3.11 o superior, o uv, que puede obtener uno) y comprueba que requests, bs4, defusedxml y lxml se importan. Es voluntario.

    En la terminal del proyecto
    npx bmad-plus install --packs seo --provision-python

  3. Opcional: definir una clave de API de Google

    Solo hace falta para datos en vivo de PageSpeed y CrUX. La clave es gratuita y se lee del entorno; se envía en una cabecera de la petición, nunca en una URL.

    En la terminal del proyecto
    $env:GOOGLE_API_KEY = "tu-clave"

  4. Lanzar una primera auditoría

    Sustituye la dirección por un sitio que tengas permiso para auditar.

    En la terminal del proyecto
    SEO Scout, lanza una auditoría rápida de https://example.com (la ruta /seo quick, fases 1 a 4).

Ejemplos para copiar

Lanzar la auditoría completa de seis fases

Úsalo en un sitio que te pertenezca o que tengas mandato para auditar. Scout, Judge y Chief trabajan en secuencia.

En tu asistente de IA
SEO Scout, lanza la auditoría completa de seis fases de https://example.com (la ruta /seo full). Detente en cada punto de control para que yo decida si continuamos.

Lo que deberías obtener La fase 1 termina con un resumen de descubrimiento y la pregunta «Continue with full audit?». Siguen el análisis profundo, la preparación para la IA y la puntuación, y el plan de acción, que se detiene en «Apply fixes automatically?». Si Python no está disponible, la auditoría anuncia de entrada el «prompts-only mode», marca los datos que faltan como no verificados y omite toda puntuación con datos incompletos, incluida la puntuación de salud SEO global.

Solo inspección técnica

Úsalo cuando sospechas problemas de indexación o de infraestructura y no necesitas la revisión de contenido.

En tu asistente de IA
SEO Scout, ejecuta la ruta técnica (/seo technical) en https://shop.example. El viernes pasado cambiamos de plataforma y las páginas están desapareciendo de Google: revisa primero robots.txt, las directivas noindex y las etiquetas canonical.

Lo que deberías obtener Scout actúa como Inspector y devuelve un informe técnico de nueve categorías, con los problemas ordenados en críticos, altos, medios y bajos. Las Core Web Vitals se juzgan a partir del código fuente cuando no hay datos de API en vivo, y se usa INP en lugar del FID retirado.

Auditar el hreflang de un sitio multilingüe

Úsalo para sitios con varios idiomas o regiones, por ejemplo variantes /fr/ y /de/.

En tu asistente de IA
SEO Scout, audita las anotaciones hreflang de https://example.com (la ruta /seo hreflang). El sitio tiene versiones /fr/ y /de/: comprueba que cada página enlaza de vuelta a sus traducciones y que x-default está definido.

Lo que deberías obtener Scout comprueba las etiquetas autorreferenciadas, las etiquetas de retorno y x-default según las reglas hreflang del pack e informa de las páginas que las incumplen.

Validar los datos estructurados

Úsalo antes y después de añadir JSON-LD. Judge actúa como Schema Master.

En tu asistente de IA
SEO Judge, valida los datos estructurados de https://example.com/pricing (la ruta /seo schema) y dime si algún tipo está obsoleto o falta.

Lo que deberías obtener Un informe de schema: qué se encontró, en qué formato, si cada tipo es válido y no está obsoleto, y qué oportunidades faltantes merece la pena añadir. Judge recomienda JSON-LD, señala los tipos retirados y puede generar fragmentos conformes.

Medir la preparación para la búsqueda con IA

Úsalo para decidir qué cambiar de modo que los asistentes puedan leer y citar tus páginas. Judge actúa como GEO Analyst.

En tu asistente de IA
SEO Judge, ejecuta la ruta GEO (/seo geo) en https://docs.example. ¿Pueden GPTBot, ClaudeBot y PerplexityBot leer nuestra documentación, y ayudaría un llms.txt?

Lo que deberías obtener Un informe GEO: qué rastreadores de IA permite o bloquea robots.txt, si llms.txt existe y está bien formado, cuántos pasajes caben en el rango citable de 134 a 167 palabras y la puntuación de preparación para la IA, mostrada solo si sus datos se verificaron.

Mejorar las puntuaciones de PageSpeed una corrección a la vez

Requiere GOOGLE_API_KEY para las puntuaciones en vivo. El objetivo es 100 en las cuatro categorías de Lighthouse.

En tu asistente de IA
SEO Chief, con SEO Scout, lanza el ciclo de PageSpeed (/seo pagespeed) en https://example.com/landing. Mi GOOGLE_API_KEY está definida. Corrige un problema cada vez y vuelve a probar tras cada uno.

Lo que deberías obtener Scout y Chief repiten el ciclo: medir, corregir un problema, volver a probar, confirmar la mejora y pasar al siguiente, según el playbook y la checklist de PageSpeed del pack. Sin clave, los agentes dicen que las puntuaciones en vivo no están disponibles en lugar de estimarlas.

Obtener un plan para tu tipo de sitio y luego las correcciones

Ejecútalo tras una auditoría. Los tipos de plan son saas, ecommerce, local, publisher y agency.

En tu asistente de IA
SEO Chief, la auditoría de nuestro sitio ha terminado. Redacta el plan estratégico para un sitio SaaS (la ruta /seo plan saas) y convierte esa auditoría en correcciones listas para aplicar (/seo fix).

Lo que deberías obtener Chief redacta un plan estratégico para un sitio SaaS (páginas de precios, comparativa de funciones, llamadas a la prueba, SEO de la documentación). Luego /seo fix convierte la última auditoría en cambios listos para aplicar: etiquetas title y description optimizadas, JSON-LD construido con las plantillas del pack, un robots.txt mejorado y un llms.txt.

Compararte con un competidor y seguir el progreso

Úsalo cuando quieras una lectura lado a lado, o tras una segunda auditoría para ver las diferencias.

En tu asistente de IA
SEO Chief, compara https://example.com con https://competitor.example (la ruta /seo competitor) y dime dónde va por delante el rival. Si guardé auditorías anteriores, muestra también cómo ha evolucionado nuestra puntuación.

Lo que deberías obtener Chief ejecuta una auditoría completa de ambos sitios y compara las puntuaciones con diferencias (puntuación SEO, E-E-A-T, tipos de schema, puntuación GEO, PageSpeed), y luego enumera las brechas donde el rival va por delante, tus ventajas y qué priorizar. El historial de puntuaciones solo existe si se guardaron auditorías anteriores en .bmad-seo/history/ mediante la fase de seguimiento opcional (fase 6 de una auditoría completa); entonces /seo history y /seo compare pueden mostrar la evolución, y sin una auditoría guardada no hay nada que comparar.

Qué escribe y dónde

Archivos que puede crear el pack SEO
RutaLo produceContenido
.bmad-seo/history/<domain>-<date>.jsonFase 6 (seguimiento)Puntuaciones por categoría y lista de problemas, para historial y comparación
seo-report.htmlscripts/seo_report.pyInforme HTML a partir de un JSON de auditoría, nombre por defecto; se usa solo cuando todas las puntuaciones están verificadas
screenshot.pngscripts/seo_screenshot.pyNombre de salida por defecto de una captura de página (--output lo cambia)
.bmad/venv/seo/install --provision-pythonEl entorno aislado de Python

Flujos de datos y requisitos

  • Entornos de ejecución: Node.js 20 para el instalador; Python 3.11 o superior solo si quieres el kit (si no, modo solo prompts). Paquetes de Python: requests, beautifulsoup4, defusedxml, lxml.
  • Flujos fuera de la máquina: seo-site-fetch (el rastreo contacta el sitio auditado; las direcciones se comprueban contra la falsificación de peticiones del lado del servidor y se fijan), seo-google-apis (PageSpeed, CrUX y la prueba de optimización para móviles, con tu GOOGLE_API_KEY enviada en la cabecera x-goog-api-key), seo-screenshot (el navegador solo llega al host auditado) y python-provision (instalación de paquetes, voluntaria).
  • El pack lleva la etiqueta de cumplimiento GDPR (RGPD) porque los datos de Google Analytics o Search Console pueden contener datos personales; trata esas exportaciones según tus propias reglas.

Límites y trampas

Advertencia Sin datos, sin puntuación

En modo solo prompts, o cuando no se pudo comprobar una categoría, los agentes la marcan como no verificada. Nunca la sustituyen por cero ni reponderan las demás categorías, de modo que una auditoría incompleta muestra su cobertura (páginas y comprobaciones revisadas, fuentes, elementos sin verificar) en lugar de una cifra global.

Nota Las capturas requieren un navegador que instalas tú

requirements.txt mantiene Playwright comentado, y --provision-python solo verifica requests, bs4, defusedxml y lxml. Para seo_screenshot.py, instala tú playwright y Chromium en el mismo entorno. Los recursos de terceros se bloquean durante una captura y se listan en blocked_requests, de modo que una imagen de CDN ausente es un efecto de la captura, no un defecto del sitio.

Nota Pide en lenguaje natural: los nombres /seo son rutas, no comandos slash

Los nombres /seo ... son el vocabulario del enrutador propio del pack. El pack no los registra como comandos slash en tu cliente de IA, así que escritos solos pueden recibir un mensaje de comando desconocido. Escribe una petición normal a un agente SEO y nombra la ruta dentro de la frase, como hacen los ejemplos anteriores. Para una auditoría, pide la ruta full (las seis fases) o la ruta quick (fases 1 a 4); el enrutador no tiene una ruta audit suelta.

Nota Procedencia

La base SEO Audit 360 la escribió Laurent Rochetta en Oveanet, su empresa, y se integró en BMAD+.

Véase también