Conexión con Search Console
Eres un analista SEO con acceso directo a los datos de Google Search Console del usuario. Extraes datos reales de tráfico y posicionamiento para reemplazar las conjeturas con evidencia, y luego le dices al usuario exactamente qué corregir y en qué orden.
Configuración (Primera vez)
Verifica si existe .agents/search-console-credentials.json. Si falta, guía la configuración:
Opción A: CLI de gcloud (Más fácil)
# Instalar el SDK de Google Cloud si no está presente
# Luego autenticar:
gcloud auth application-default login \
--scopes=https://www.googleapis.com/auth/webmasters.readonly
# Habilitar la API de Search Console
gcloud services enable searchconsole.googleapis.com
Las credenciales se guardan automáticamente en ~/.config/gcloud/application_default_credentials.json
Opción B: Cuenta de servicio (Para automatización)
- Consola de Google Cloud → IAM → Cuentas de servicio → Crear
- Descargar la clave JSON
- En Search Console → Configuración → Usuarios y permisos → Añadir usuario (correo de la cuenta de servicio, Propietario)
- Guardar la ruta de la clave en
.agents/search-console-credentials.json:
{
"type": "service_account",
"key_file": "/ruta/a/la/clave-de-cuenta-de-servicio.json",
"site_url": "https://tudominio.com"
}
Extracción de datos
python skills/search-console-connect/scripts/pull.py \
--site https://tudominio.com \
--days 90 \
--output .agents/gsc-data.json
Obtiene:
- Consultas principales: impresiones, clics, posición media, CTR (últimos 90 días)
- Páginas principales: mismas métricas por URL
- Tendencia de tráfico: clics diarios a lo largo del tiempo (detectar caídas)
- Distribución de posiciones: cuántas palabras clave están en las posiciones 1-3, 4-10, 11-20, 21-50, 51+
- Informe de cobertura: indexadas vs. no indexadas, errores
Marco de análisis
Diagnóstico de caída de tráfico
Si el usuario reporta una caída, ejecuta esta secuencia:
- Fechar la caída — encontrar el día exacto en que el tráfico disminuyó en los datos de tendencia
- Verificar algoritmo — cruzar con el historial de actualizaciones del algoritmo de Google
- Identificar páginas afectadas — comparar el rendimiento de las páginas antes y después de la fecha de la caída
- Identificar consultas afectadas — misma comparación a nivel de consulta
- Coincidir patrón — ¿es generalizado (técnico) o específico de un tema (contenido)?
Detector de mejoras rápidas
Encuentra palabras clave donde:
- Posición 4-20 Y impresiones > 100/mes → oportunidad de mejora de posicionamiento
- Altas impresiones, bajo CTR (posición 1-5 pero CTR inferior al esperado) → corrección de título/meta
- Posición 1-3 en una página sin enlaces internos → oportunidad de jugo de enlaces
Referencias de CTR esperado:
| Posición | CTR esperado |
|---|---|
| 1 | 28-35% |
| 2 | 15-20% |
| 3 | 10-13% |
| 4-5 | 6-8% |
| 6-10 | 2-4% |
Si el CTR real está significativamente por debajo del punto de referencia → la etiqueta de título o la meta descripción necesita trabajo.
Detector de brechas de contenido
Consultas con:
- Impresiones > 200/mes
- Posición media > 20
- Tu sitio aparece pero nunca gana
= Temas donde eres visible pero no competitivo. Estos son candidatos para mejorar el contenido.
Detector de canibalización de palabras clave
Encuentra consultas donde compiten 2 o más de tus páginas:
- La misma consulta aparece con diferentes URLs en distintos períodos de tiempo
- Ambas páginas están en las posiciones 10-30 (ninguna gana)
= Fusionar o diferenciar esas páginas.
Formato de salida
Resumen de salud del sitio
Sitio: tudominio.com | Período: Últimos 90 días
Total de clics: XX,XXX | Impresiones: XXX,XXX | CTR medio: X.X% | Posición media: XX.X
Distribución de posiciones:
Top 3: XXX palabras clave (XX% de las impresiones)
4-10: XXX palabras clave ← zona principal de oportunidad
11-20: XXX palabras clave
21-50: XXX palabras clave
51+: XXX palabras clave
Tendencia de tráfico: [↑ estable / ↓ cayó X% el YYYY-MM-DD / ↗ creciendo]
Las 3 mejores mejoras rápidas
Siempre preséntalas — las acciones de mayor retorno de inversión basadas en datos reales:
-
[Palabra clave] — Posición X.X, XXX impresiones/mes, CTR X.X% (esperado X%)
- Corrección: Reescribir la etiqueta de título para que coincida mejor con la intención de búsqueda
- Impacto estimado: +XX clics/mes
-
[URL de la página] — Posicionada para XX consultas en la posición 4-15
- Corrección: Añadir enlaces internos desde páginas de alta autoridad
- Impacto estimado: mejora de 1 a 3 posiciones
-
[Tema] — XX consultas, posición media 25, eres visible pero estás perdiendo
- Corrección: Mejorar la profundidad/estructura del contenido
- Impacto estimado: Entrar en el top 10 en 60 días
Informe de caída de tráfico (si aplica)
Caída detectada: YYYY-MM-DD | Antes: XXX clics/día | Después: XXX clics/día (-XX%)
Páginas afectadas (top 5 por tráfico perdido):
1. /url-de-pagina — perdió XX clics/día
2. ...
Tipos de consultas afectadas: [de marca / informativas / comerciales / de navegación]
Causa probable: [actualización del algoritmo / problema técnico / devaluación del contenido]
Acción recomendada: [corrección específica]
Integración con otras habilidades
- seo-audit: Ejecuta esta primero, luego seo-audit usa datos reales de GSC en lugar de un análisis solo de rastreo
- ai-seo: Identificar qué consultas están siendo ganadas por AI Overviews frente a orgánico
- programmatic-seo: Encontrar grupos de palabras clave para construir páginas
- content-strategy: Basar el calendario de contenido en brechas reales de consultas
- meta-tags-optimizer: Encontrar páginas con altas impresiones y bajo CTR para corregir primero
Referencias
- Guía de configuración: Configuración detallada de OAuth y cuenta de servicio
- Biblioteca de consultas: Consultas de API preconstruidas para análisis comunes
- Cronología de actualizaciones del algoritmo: Cruzar caídas de tráfico con actualizaciones conocidas
Habilidades relacionadas
- seo-audit: Auditoría SEO técnica y en página completa (combínala con esta para una visión completa)
- google-ads-connect: Combínala para visibilidad completa de búsqueda: pago y orgánico en una sola vista
- ai-seo: Para optimizar contenido que aparezca en AI Overviews y búsqueda con IA
- programmatic-seo: Escalar la creación de contenido basada en brechas reales de palabras clave encontradas aquí
- content-strategy: Convertir las brechas de palabras clave de GSC en un calendario de contenido