GridWhy

oficial

Historial de posiciones en cuadrículas geográficas de Google Maps para SEO local: consulta el historial de escaneos, pregunta por qué cambió una posición (competidores, reseñas, cambios de categoría) con frases listas para compartir con clientes y próximos pasos, y ejecuta un nuevo escaneo de cuadrícula.

¿Qué puedes hacer con GridWhy MCP?

  • Revisar el historial de escaneos — Consultar las ubicaciones y palabras clave seguidas con sus escaneos más recientes, incluidos los recuentos de cuadrículas en el top 20 y el top 3, la posición media y la mejor posición, y los escaneos manuales restantes.
  • Explicar los cambios de posición — Obtener información sobre por qué una palabra clave cambió de posición entre escaneos, teniendo en cuenta la cobertura, la competencia, la velocidad de reseñas, la valoración y los cambios de categoría o nombre, con frases listas para compartir con clientes.
  • Iniciar un escaneo de cuadrícula — Activar ahora un escaneo para una palabra clave seguida; se descontará de tu límite de escaneos manuales y se devolverá un ID de escaneo para consultarlo más adelante.
  • Conectar mediante OAuth o una clave — Añadir https://gridwhy.com/mcp en Claude o ChatGPT e iniciar sesión, o usar una clave gw_ para Claude Code, Cursor y scripts.

Servidor MCP alojado

npx add-mcp 'https://gridwhy.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Conéctate con un clic

Claude y ChatGPT solo necesitan la URL https://gridwhy.com/mcp. Abren una página de GridWhy donde inicias sesión como siempre (con un enlace por correo electrónico o con Google) y eliges qué puede hacer la aplicación: leer (ubicaciones, historial de escaneos, qué cambió) y escanear (iniciar escaneos, que usan tu cuota de escaneos manuales). No hay que copiar ninguna clave.

  1. Claude (claude.ai y la aplicación de escritorio, cualquier plan): Customize → Connectors → Add → Add custom connector. Ponle el nombre GridWhy, pega https://gridwhy.com/mcp, haz clic en Continue, conserva las opciones de autenticación que Claude marque como Detected (se registra automáticamente), haz clic en Add y luego en Connect. En los planes Team y Enterprise, un Owner lo añade en Organization settings → Connectors y cada miembro se conecta.
  2. ChatGPT: abre chatgpt.com/plugins, selecciona + y luego Add custom MCP server. Escribe GridWhy, pega https://gridwhy.com/mcp en Connection, elige OAuth para la autenticación, confirma y selecciona Create as a plugin. Las políticas de tu espacio de trabajo determinan si se permiten servidores personalizados.

Las aplicaciones conectadas aparecen en Settings → API and MCP, donde puedes desconectarlas; dejarán de funcionar de inmediato. Tienen los mismos límites que una clave de API (más abajo). Cuando termina una prueba o se cancela una suscripción, muestran un error claro hasta que elijas un plan. Los nombres de los menús de Claude y ChatGPT cambian de vez en cuando; la URL sigue siendo la misma.

1. O usa una clave

Inicia sesión, abre Settings → API and MCP y crea una clave. Empieza por gw_ y solo se muestra una vez. Una clave actúa en nombre de todo tu espacio de trabajo; puedes revocarla allí en cualquier momento.

Para Claude Code, Cursor, scripts y la API REST. Endpoint MCP: https://gridwhy.com/mcp (Streamable HTTP). Envía la clave como Authorization: Bearer gw_…. Descubrimiento de OAuth para clientes que lo admiten: https://gridwhy.com/.well-known/oauth-protected-resource/mcp.

2. Conecta tu cliente

Claude Code (terminal)

claude mcp add --transport http gridwhy https://gridwhy.com/mcp \
  --header "Authorization: Bearer gw_your_key"

Claude Desktop: Settings → Developer → Edit config (claude_desktop_config.json) y luego reinicia

{
  "mcpServers": {
    "gridwhy": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://gridwhy.com/mcp", "--header", "Authorization:${GRIDWHY_AUTH}"],
      "env": { "GRIDWHY_AUTH": "Bearer gw_your_key" }
    }
  }
}

Requiere Node.js. La clave se guarda en una variable de entorno para que el espacio después de “Bearer” se conserve en Windows.

Cursor: ~/.cursor/mcp.json (o .cursor/mcp.json en un proyecto)

{
  "mcpServers": {
    "gridwhy": {
      "url": "https://gridwhy.com/mcp",
      "headers": { "Authorization": "Bearer gw_your_key" }
    }
  }
}

Modelos de ChatGPT mediante la API OpenAI Responses

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model>",
    "tools": [{
      "type": "mcp",
      "server_label": "gridwhy",
      "server_url": "https://gridwhy.com/mcp",
      "headers": { "Authorization": "Bearer gw_your_key" },
      "require_approval": { "never": { "tool_names": ["get_history", "explain_change"] } }
    }],
    "input": "Which of my clients lost ground on Google Maps this week, and why?"
  }'

En la aplicación ChatGPT, usa en su lugar la conexión con un clic de arriba; la llamada a la API de aquí recibe una clave directamente.

3. Herramientas

  • get_history Ubicaciones, palabras clave seguidas y sus escaneos, del más reciente al más antiguo: cuántos puntos de la cuadrícula se posicionan entre los 20 primeros y entre los 3 primeros, la posición media y la mejor, una línea sobre «qué cambió» y un enlace al informe. Sin argumentos: todas las palabras clave con su último escaneo, además de los escaneos manuales restantes. Argumentos: location, keyword, keyword_id, limit (todos opcionales)
  • explain_change Por qué cambió la clasificación entre un escaneo y el anterior: hallazgos (cobertura, competidores que subieron o aparecieron, ritmo de reseñas, cambios en la valoración, categoría o nombre), cada uno con una línea para compartir con el cliente, además de los siguientes pasos. Pasa scan_id o una ubicación y una palabra clave para obtener su último escaneo finalizado. Argumentos: scan_id, location, keyword, keyword_id (todos opcionales)
  • run_scan Inicia ahora un escaneo de cuadrícula para una palabra clave seguida (además de los programados). Se descuenta de los escaneos manuales de la cuenta (por día y por 30 días); el primer escaneo de una palabra clave es gratis. Tarda entre 15 y 30 segundos; después, llama a explain_change con el scan_id devuelto. Argumentos: location, keyword, keyword_id (todos opcionales)

Prueba: «Explica qué cambió para Wilson Plumbing con “plumber” y redacta la actualización para el cliente».

4. REST

Las mismas tres operaciones, la misma clave, los mismos límites y las mismas respuestas (JSON).

get_history

curl "https://gridwhy.com/api/v1/history?location=Wilson&keyword=plumber&limit=5" \
  -H "Authorization: Bearer gw_your_key"

explain_change

curl "https://gridwhy.com/api/v1/explain?scan_id=<scan id>" \
  -H "Authorization: Bearer gw_your_key"

run_scan (202 Accepted; el escaneo tarda entre 15 y 30 segundos)

curl -X POST "https://gridwhy.com/api/v1/scans" \
  -H "Authorization: Bearer gw_your_key" -H "Content-Type: application/json" \
  -d '{ "location": "Wilson Plumbing", "keyword": "plumber" }'

Los errores se devuelven como { "error": "…" } con los códigos 400, 401, 403, 404, 409 o 429 (con Retry-After).

5. Límites

PlanLlamadas a la API por horarun_scan (escaneos manuales)
Solo1005 al día, 30 cada 30 días
Agency50020 al día, 100 cada 30 días
Agency+2,00050 al día, 250 cada 30 días

Los escaneos programados nunca están limitados por la API. La prueba gratuita tiene los límites de Solo. Una clave deja de funcionar cuando termina una prueba o se cancela una suscripción.