GridWhy

resmi

Yerel SEO için Google Maps geo-grid sıralama geçmişi: tarama geçmişini görün, sıralamanın neden değiştiğini (rakipler, yorumlar, kategori değişiklikleri) müşteriyle paylaşmaya hazır ifadeler ve sonraki adımlarla öğrenin ve yeni bir grid taraması başlatın.

GridWhy MCP ile neler yapabilirsiniz?

  • Tarama geçmişini inceleyin — En son taramalarıyla birlikte takip edilen konumları ve anahtar kelimeleri; ilk 20 ve ilk 3 grid sayımlarını, ortalama ve en iyi sıralamayı ve kalan manuel taramaları sorun.
  • Sıralama değişikliklerini açıklayın — Bir anahtar kelimenin taramalar arasında neden yer değiştirdiğine ilişkin bulguları; kapsama alanı, rakipler, yorum hızı, puan ve kategori veya ad değişikliklerini kapsayacak şekilde, müşteriye sunmaya hazır ifadelerle alın.
  • Grid taraması başlatın — Takip edilen bir anahtar kelime için hemen tarama başlatın; bu, manuel tarama hakkınızdan düşülür ve takip için bir tarama kimliği döndürür.
  • OAuth veya anahtarla bağlanın — Claude veya ChatGPT'ye oturum açarak https://gridwhy.com/mcp ekleyin ya da Claude Code, Cursor ve betikler için bir gw_ anahtarı kullanın.

Barındırılan MCP Sunucusu

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

Claude Code, Codex, Cursor ve daha fazlasına kurulur

Dokümantasyon

Tek tıkla bağlanın

Claude ve ChatGPT için yalnızca https://gridwhy.com/mcp URL'si gerekir. Oturum açtığınız (e-posta bağlantısı veya Google ile) ve uygulamanın neler yapabileceğini seçtiğiniz bir GridWhy sayfası açarlar: okuma (konumlar, tarama geçmişi, nelerin değiştiği) ve tarama (manuel tarama hakkınızı kullanan taramaları başlatma). Kopyalanacak anahtar yok.

  1. Claude (claude.ai ve masaüstü uygulaması, tüm planlarda): Customize → Connectors → Add → Add custom connector. Adını GridWhy koyun, https://gridwhy.com/mcp yapıştırın, Continue'a tıklayın, Claude'un Detected olarak işaretlediği kimlik doğrulama seçeneklerini olduğu gibi bırakın (kendini otomatik olarak kaydeder), Add'e, ardından Connect'e tıklayın. Team ve Enterprise planlarında bir Owner, Organization settings → Connectors altında ekler ve her üye bağlanır.
  2. ChatGPT: chatgpt.com/plugins adresini açın, + simgesini, ardından Add custom MCP server'ı seçin. Connection altına GridWhy adını girip https://gridwhy.com/mcp yapıştırın, kimlik doğrulama için OAuth'u seçin, onaylayın ve Create as a plugin'i seçin. Özel sunuculara izin verilip verilmeyeceğini çalışma alanınızın politikaları belirler.

Bağlı uygulamalar Settings → API and MCP altında listelenir; buradan bağlantılarını kesebilirsiniz. Bağlantıları kesildiğinde hemen çalışmayı durdururlar. API anahtarıyla aynı sınırlara tabidirler (aşağıya bakın). Deneme süresi sona erdiğinde veya abonelik iptal edildiğinde, bir plan seçene kadar anlaşılır bir hata alırlar. Claude ve ChatGPT'deki menü adları zaman zaman değişir; URL aynı kalır.

1. Ya da bir anahtar kullanın

Oturum açın, Settings → API and MCP sayfasını açın ve bir anahtar oluşturun. Anahtar gw_ ile başlar ve yalnızca bir kez gösterilir. Anahtar, çalışma alanınızın tamamı adına işlem yapar; istediğiniz zaman buradan iptal edebilirsiniz.

Claude Code, Cursor, betikler ve REST API için. MCP uç noktası: https://gridwhy.com/mcp (Streamable HTTP). Anahtarı Authorization: Bearer gw_… olarak gönderin. Destekleyen istemciler için OAuth keşfi: https://gridwhy.com/.well-known/oauth-protected-resource/mcp.

2. İstemcinizi bağlayın

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), ardından yeniden başlatın

{
  "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 gerekir. Anahtar bir ortam değişkeninde tutulur; böylece “Bearer” sonrasındaki boşluk Windows'ta korunur.

Cursor: ~/.cursor/mcp.json (veya bir projede .cursor/mcp.json)

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

OpenAI Responses API üzerinden ChatGPT modelleri

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?"
  }'

ChatGPT uygulamasında bunun yerine yukarıdaki tek tıkla bağlantıyı kullanın; buradaki API çağrısı doğrudan bir anahtar alır.

3. Araçlar

  • get_history Konumlar, izlenen anahtar kelimeler ve bunların taramaları, en yeniden başlayarak: ilk 20 ve ilk 3'te sıralanan ızgara noktalarının sayısı, ortalama ve en iyi sıralama, tek satırlık 'neler değişti' özeti ve rapor bağlantısı. Argüman olmadan: en son taramasıyla birlikte her anahtar kelime ve kalan manuel tarama hakkı. Argümanlar: location, keyword, keyword_id, limit (tümü isteğe bağlı)
  • explain_change Bir tarama ile önceki tarama arasındaki sıralama değişikliğinin nedeni: bulgular (kapsama alanı, yükselen veya yeni görünen rakipler, yorum hızı, puan, kategori veya ad değişiklikleri), her biri müşteriye iletilebilecek bir cümleyle birlikte ve sonraki adımlar. scan_id ya da en son tamamlanan taramaları için bir konum ve anahtar kelime girin. Argümanlar: scan_id, location, keyword, keyword_id (tümü isteğe bağlı)
  • run_scan İzlenen bir anahtar kelime için hemen bir ızgara taraması başlatır (zamanlanmış taramalara ek olarak). Hesabın manuel tarama haklarından düşer (günlük ve 30 günlük); bir anahtar kelimenin ilk taraması ücretsizdir. 15-30 saniye sürer; ardından döndürülen scan_id ile explain_change çağrısını yapın. Argümanlar: location, keyword, keyword_id (tümü isteğe bağlı)

Şunu deneyin: “Wilson Plumbing için ‘plumber’ konusunda nelerin değiştiğini açıkla ve müşteriye yönelik güncellemeyi yaz.”

4. REST

Aynı üç işlem, aynı anahtar, sınırlar ve yanıtlar (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; tarama 15–30 saniye sürer)

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" }'

Hatalar, 400, 401, 403, 404, 409 veya 429 durum kodlarıyla birlikte { "error": "…" } olarak döner (Retry-After ile).

5. Sınırlar

PlanSaatteki API çağrısırun_scan (manuel taramalar)
Solo100Günde 5, 30 günde 30
Agency500Günde 20, 30 günde 100
Agency+2,000Günde 50, 30 günde 250

Zamanlanmış taramalar API sınırlarına tabi değildir. Ücretsiz deneme, Solo planının sınırlarına sahiptir. Deneme süresi sona erdiğinde veya abonelik iptal edildiğinde anahtar çalışmayı durdurur.