# Instrucciones para el agente: Search Console MCP: analiza consultas y páginas de tu sitio

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/ahonn/mcp-server-gsc
- Guía completa: https://lab.wisd.ai/hub/google-search-console-mcp

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: instala el paquete

Comprueba que tienes Node.js ≥18 y npm/npx disponibles. Ejecuta la instalación desde una carpeta de proyecto.

```bash
npm install mcp-server-gsc
```

### Paso 2: configura Google

Sigue los pasos del README para habilitar la API, crear la cuenta de servicio y darle acceso a la propiedad. Conserva sus credenciales en una ruta privada.

### Paso 3: conecta el cliente

En Claude Desktop incorpora esta entrada a `mcpServers`, conservando las entradas existentes y sustituyendo la ruta por la absoluta del JSON privado:

```json
{
  "mcpServers": {
    "gsc": {
      "command": "npx",
      "args": ["-y", "mcp-server-gsc"],
      "env": {"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"}
    }
  }
}
```

Reinicia el cliente. Es la configuración del README.

### Paso 4: consulta

Pide search_analytics con siteUrl, startDate y endDate, empezando por un resultado pequeño.

## Comprobación

Compara clics e impresiones con Search Console para las mismas fechas, propiedad, tipo de búsqueda y dimensiones. No mezcles un dominio completo con una propiedad de prefijo URL.

## Si algo falla

Si recibe permiso denegado, confirma el acceso de la cuenta de servicio a esa propiedad. Si el regex no filtra, compara queryFilter o pageFilter y filterOperator con los ejemplos del README.

[Fuente del procedimiento](https://github.com/ahonn/mcp-server-gsc).