GridWhy
offiziellGoogle Maps Geo-Grid-Rankingverlauf für lokales SEO: Scan-Verlauf ansehen, nach den Gründen für eine Rankingänderung fragen (Wettbewerber, Bewertungen, Kategorieänderungen), mit kundenfertigen Formulierungen und nächsten Schritten, und einen neuen Grid-Scan durchführen.
Was kann man mit GridWhy MCP machen?
- Scan-Verlauf prüfen — Frage nach erfassten Standorten und Keywords mit ihren neuesten Scans, einschließlich der Anzahl der Raster in den Top 20 und Top 3, des durchschnittlichen und besten Rangs sowie der verbleibenden manuellen Scans.
- Ranking-Änderungen erklären — Erfahre, warum sich ein Keyword zwischen Scans verschoben hat, unter Berücksichtigung von Abdeckung, Wettbewerbern, Bewertungsgeschwindigkeit, Bewertung sowie Änderungen an Kategorie oder Name, mit direkt für Kunden geeigneten Formulierungen.
- Raster-Scan starten — Starte jetzt einen Scan für ein erfasstes Keyword. Dieser wird auf dein Kontingent für manuelle Scans angerechnet und liefert eine Scan-ID zur späteren Abfrage.
- Per OAuth oder Schlüssel verbinden — Füge
https://gridwhy.com/mcpin Claude oder ChatGPT hinzu und melde dich an, oder verwende einengw_-Schlüssel für Claude Code, Cursor und Skripte.
Gehosteter MCP-Server
npx add-mcp 'https://gridwhy.com/mcp'Installiert in Claude Code, Codex, Cursor und mehr
Dokumentation
Mit einem Klick verbinden
Claude und ChatGPT benötigen nur die URL https://gridwhy.com/mcp. Sie öffnen eine GridWhy-Seite, auf der du dich wie gewohnt anmeldest (per E-Mail-Link oder Google) und auswählst, was die App tun darf: lesen (Standorte, Scan-Verlauf, was sich geändert hat) und scannen (Scans starten, die dein Kontingent für manuelle Scans nutzen). Kein Schlüssel zum Kopieren.
- Claude (claude.ai und die Desktop-App, jeder Tarif): Customize → Connectors → Add → Add custom connector. Nenne ihn GridWhy, füge
https://gridwhy.com/mcpein, klicke auf Continue, behalte die Authentifizierungsoptionen bei, die Claude als Detected markiert (Claude registriert sich automatisch), klicke auf Add und dann auf Connect. Bei Team- und Enterprise-Tarifen fügt ein Owner ihn unter Organization settings → Connectors hinzu, und jedes Mitglied verbindet sich. - ChatGPT: Öffne chatgpt.com/plugins, wähle + und dann Add custom MCP server. Gib unter Connection GridWhy ein, füge
https://gridwhy.com/mcpein, wähle OAuth als Authentifizierungsmethode, bestätige und wähle Create as a plugin. Die Richtlinien deines Arbeitsbereichs bestimmen, ob benutzerdefinierte Server zulässig sind.
Verbundene Apps werden unter Settings → API and MCP aufgeführt. Dort kannst du die Verbindung trennen; sie funktionieren dann sofort nicht mehr. Für sie gelten dieselben Limits wie für einen API-Schlüssel (siehe unten). Wenn ein Testzeitraum endet oder ein Abonnement gekündigt wird, erhalten sie eine verständliche Fehlermeldung, bis du einen Tarif auswählst. Die Menünamen in Claude und ChatGPT ändern sich gelegentlich; die URL bleibt gleich.
1. Oder einen Schlüssel verwenden
Melde dich an, öffne Settings → API and MCP und erstelle einen Schlüssel. Er beginnt mit gw_ und wird nur einmal angezeigt. Ein Schlüssel gilt für deinen gesamten Arbeitsbereich; du kannst ihn dort jederzeit widerrufen.
Für Claude Code, Cursor, Skripte und die REST API. MCP-Endpunkt: https://gridwhy.com/mcp (Streamable HTTP). Sende den Schlüssel als Authorization: Bearer gw_…. OAuth-Erkennung für Clients, die dies unterstützen: https://gridwhy.com/.well-known/oauth-protected-resource/mcp.
2. Client verbinden
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), dann neu starten
{
"mcpServers": {
"gridwhy": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://gridwhy.com/mcp", "--header", "Authorization:${GRIDWHY_AUTH}"],
"env": { "GRIDWHY_AUTH": "Bearer gw_your_key" }
}
}
}
Node.js erforderlich. Der Schlüssel befindet sich in einer Umgebungsvariable, damit das Leerzeichen nach „Bearer“ unter Windows erhalten bleibt.
Cursor: ~/.cursor/mcp.json (oder .cursor/mcp.json in einem Projekt)
{
"mcpServers": {
"gridwhy": {
"url": "https://gridwhy.com/mcp",
"headers": { "Authorization": "Bearer gw_your_key" }
}
}
}
ChatGPT-Modelle über die OpenAI Responses API
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?"
}'
Verwende in der ChatGPT-App stattdessen die Verbindung mit einem Klick; der API-Aufruf hier nimmt direkt einen Schlüssel entgegen.
3. Tools
get_historyStandorte, erfasste Keywords und ihre Scans, neueste zuerst: wie viele Rasterpunkte in den Top 20 und Top 3 ranken, durchschnittliches und bestes Ranking, die einzeilige Zusammenfassung „was sich geändert hat“ und ein Link zum Bericht. Ohne Argumente: jedes Keyword mit seinem neuesten Scan sowie die verbleibenden manuellen Scans. Argumente: location, keyword, keyword_id, limit (alle optional)explain_changeWarum sich das Ranking zwischen einem Scan und dem vorherigen geändert hat: Erkenntnisse (Abdeckung, aufgestiegene oder neu hinzugekommene Wettbewerber, Bewertungsgeschwindigkeit, Bewertung, Kategorie- oder Namensänderungen), jeweils mit einer Zeile zum Einfügen in die Nachricht an den Kunden, sowie nächste Schritte. Übergib scan_id oder einen Standort und ein Keyword für den zuletzt abgeschlossenen Scan. Argumente: scan_id, location, keyword, keyword_id (alle optional)run_scanStartet jetzt einen Raster-Scan für ein erfasstes Keyword (zusätzlich zum Zeitplan). Wird auf die manuellen Scans des Kontos angerechnet (pro Tag und pro 30 Tage); der erste Scan eines Keywords ist kostenlos. Dauert 15–30 Sekunden; rufe anschließend explain_change mit der zurückgegebenen scan_id auf. Argumente: location, keyword, keyword_id (alle optional)
Probiere: „Erkläre, was sich für Wilson Plumbing bei ‚plumber‘ geändert hat, und verfasse das Update für den Kunden.“
4. REST
Dieselben drei Vorgänge, derselbe Schlüssel, dieselben Limits und Antworten (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; der Scan dauert 15–30 Sekunden)
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" }'
Fehler werden als { "error": "…" } mit 400, 401, 403, 404, 409 oder 429 zurückgegeben (mit Retry-After).
5. Limits
| Tarif | API-Aufrufe pro Stunde | run_scan (manuelle Scans) |
|---|---|---|
| Solo | 100 | 5 pro Tag, 30 pro 30 Tage |
| Agency | 500 | 20 pro Tag, 100 pro 30 Tage |
| Agency+ | 2,000 | 50 pro Tag, 250 pro 30 Tage |
Geplante Scans sind über die API niemals begrenzt. Für den kostenlosen Testzeitraum gelten die Limits von Solo. Ein Schlüssel funktioniert nicht mehr, wenn ein Testzeitraum endet oder ein Abonnement gekündigt wird.