GridWhy
oficialHistorial 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/mcpen Claude o ChatGPT e iniciar sesión, o usar una clavegw_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.
- 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. - ChatGPT: abre chatgpt.com/plugins, selecciona + y luego Add custom MCP server. Escribe GridWhy, pega
https://gridwhy.com/mcpen 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_historyUbicaciones, 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_changePor 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_scanInicia 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
| Plan | Llamadas a la API por hora | run_scan (escaneos manuales) |
|---|---|---|
| Solo | 100 | 5 al día, 30 cada 30 días |
| Agency | 500 | 20 al día, 100 cada 30 días |
| Agency+ | 2,000 | 50 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.