@weppa-cloud/mcp-search-console/README.md

MCP server for Google Search Console with growth-focused metrics

# 🔍 Google Search Console MCP

Herramienta MCP para Google Search Console con métricas orientadas a growth y SEO.

## 🚀 Versión 1.1.0 - Nuevas Herramientas Avanzadas

Ahora con **análisis técnico avanzado** para growth hackers:
- 🚨 Detector de errores 404 con análisis de impacto
- ⚡ Analizador de Core Web Vitals con priorización
- 🎯 Buscador avanzado de oportunidades (quick wins, snippets, cannibalización)

## 🚀 Herramientas Disponibles

### 1. `seo_pulse` - Health Check SEO
```
"Dame el SEO pulse de mi sitio"
```
Retorna:
- Visibilidad (impresiones) con cambio %
- Tráfico (clicks) con alertas
- CTR y posición promedio
- Issues y oportunidades detectadas

### 2. `keyword_opportunities` - Oportunidades de Keywords
```
"Encuentra keywords donde puedo mejorar fácilmente"
```
Muestra:
- Keywords en posiciones 4-20
- Tráfico potencial al mejorar
- Nivel de dificultad
- Acciones recomendadas

### 3. `content_performance` - Performance de Contenido
```
"¿Cuáles son mis mejores páginas?"
```
Analiza:
- Top páginas por tráfico
- CTR y posición por página
- Recomendaciones de optimización
- Valor estimado del contenido

### 4. `competitor_keywords` - Keywords de Competencia
```
"¿En qué keywords me ganan los competidores?"
```
Identifica:
- Keywords donde rankeas mal (10-50)
- Fuerza de la competencia
- Estrategia para cada keyword

### 5. `search_analytics` - Análisis Detallado
```
"Dame datos de búsqueda del último mes"
```
Consultas personalizadas con filtros por:
- Query, página, país, dispositivo
- Rangos de fecha flexibles

## 🆕 Herramientas Avanzadas (v1.1.0)

### 6. `find_404_errors` - Detector de Errores 404
```
"Encuentra todos los errores 404 de mi sitio"
"¿Qué páginas rotas están perdiendo tráfico?"
```
Analiza:
- 🚨 Errores 404, soft 404, y crawl errors
- 📊 Impacto en tráfico perdido
- 🔍 Patrones en URLs rotas
- 💡 Recomendaciones de redirects

### 7. `analyze_core_web_vitals` - Análisis de Core Web Vitals
```
"Analiza los Core Web Vitals de mi sitio"
"¿Qué páginas tienen problemas de velocidad?"
```
Métricas:
- ⚡ LCP (Largest Contentful Paint)
- 🖱️ FID/INP (Interactividad)
- 📐 CLS (Estabilidad visual)
- 🎯 Páginas prioritarias por tráfico
- 🔧 Recomendaciones específicas

### 8. `find_content_opportunities` - Buscador Avanzado de Oportunidades
```
"Encuentra todas las oportunidades de contenido"
"¿Dónde tengo quick wins para subir posiciones?"
```
Identifica:
- 🚀 **Quick Wins**: Posiciones 11-20 con alto volumen
- 🍎 **Low Hanging Fruit**: Posiciones 4-10 con buen CTR
- 💬 **Featured Snippets**: Oportunidades de fragmentos destacados
- 🔄 **Cannibalización**: Múltiples páginas compitiendo
- 📋 Plan de acción priorizado

## 📊 Ejemplos de Uso

### Morning SEO Check
```
"SEO pulse de los últimos 7 días"
"¿Algún problema con mi visibilidad?"
```

### Optimización de Contenido
```
"Top 20 páginas por performance"
"¿Qué páginas necesitan optimización?"
```

### Estrategia de Keywords
```
"Keywords con potencial de mejora"
"¿Dónde están mis quick wins?"
```

### Análisis Competitivo
```
"Keywords donde pierdo contra competidores"
"¿En qué términos debería enfocarme?"
```

## 🔧 Configuración

1. **Agregar permisos en Search Console**:
   - Ve a Search Console
   - Configuración → Usuarios
   - Agrega el email de tu Service Account

2. **Habilitar API**:
   - Google Cloud Console
   - Habilitar "Google Search Console API"

3. **Configurar MCP**:
```json
{
  "mcpServers": {
    "search-console": {
      "command": "npx",
      "args": ["@weppa-cloud/mcp-search-console"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json",
        "GSC_SITE_URL": "https://tu-sitio.com"
      }
    }
  }
}
```

## 🎯 Métricas Clave

- **Impressions**: Cuántas veces apareces en búsquedas
- **Clicks**: Tráfico real desde Google
- **CTR**: Click-through rate (salud de tus títulos)
- **Position**: Ranking promedio
- **Potential Traffic**: Clicks adicionales al mejorar

## 💡 Pro Tips

1. **Enfócate en positions 4-10**: Más fácil de mejorar
2. **CTR < 2%**: Urgente optimizar título/descripción
3. **Alta impresión + bajo CTR**: Gran oportunidad
4. **Monitorea caídas súbitas**: Pueden ser penalizaciones

---

Built for growth teams by Weppa Cloud 🚀