GridWhy

offiziell

Google 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/mcp in Claude oder ChatGPT hinzu und melde dich an, oder verwende einen gw_-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.

  1. Claude (claude.ai und die Desktop-App, jeder Tarif): Customize → Connectors → Add → Add custom connector. Nenne ihn GridWhy, füge https://gridwhy.com/mcp ein, 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.
  2. ChatGPT: Öffne chatgpt.com/plugins, wähle + und dann Add custom MCP server. Gib unter Connection GridWhy ein, füge https://gridwhy.com/mcp ein, 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_history Standorte, 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_change Warum 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_scan Startet 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

TarifAPI-Aufrufe pro Stunderun_scan (manuelle Scans)
Solo1005 pro Tag, 30 pro 30 Tage
Agency50020 pro Tag, 100 pro 30 Tage
Agency+2,00050 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.