GridWhy

resmi

Riwayat peringkat geo-grid Google Maps untuk SEO lokal: lihat riwayat pemindaian, tanyakan alasan perubahan peringkat (pesaing, ulasan, perubahan kategori) dengan kalimat siap disampaikan kepada klien dan langkah selanjutnya, serta jalankan pemindaian grid baru.

Apa yang bisa Anda lakukan dengan GridWhy MCP?

  • Tinjau riwayat pemindaian — Minta lokasi dan kata kunci yang dilacak beserta pemindaian terbarunya, termasuk jumlah grid top-20 dan top-3, peringkat rata-rata dan terbaik, serta sisa pemindaian manual.
  • Jelaskan perubahan peringkat — Dapatkan temuan tentang alasan kata kunci berpindah peringkat di antara pemindaian, mencakup cakupan, pesaing, laju ulasan, rating, serta perubahan kategori atau nama, dengan kalimat yang siap disampaikan kepada klien.
  • Mulai pemindaian grid — Picu pemindaian untuk satu kata kunci yang dilacak sekarang. Pemindaian ini mengurangi jatah pemindaian manual Anda dan menghasilkan ID pemindaian untuk tindak lanjut.
  • Hubungkan melalui OAuth atau kunci — Tambahkan https://gridwhy.com/mcp di Claude atau ChatGPT dengan masuk, atau gunakan kunci gw_ untuk Claude Code, Cursor, dan skrip.

Server MCP Terhosting

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

Terpasang ke Claude Code, Codex, Cursor, dan lainnya

Dokumentasi

Hubungkan dengan satu klik

Claude dan ChatGPT hanya memerlukan URL https://gridwhy.com/mcp. Keduanya akan membuka halaman GridWhy tempat Anda masuk seperti biasa (tautan email atau Google) dan memilih tindakan yang boleh dilakukan aplikasi: membaca (lokasi, riwayat pemindaian, perubahan) dan memindai (memulai pemindaian, yang menggunakan jatah pemindaian manual Anda). Tidak perlu menyalin kunci.

  1. Claude (claude.ai dan aplikasi desktop, paket apa pun): Customize → Connectors → Add → Add custom connector. Beri nama GridWhy, tempel https://gridwhy.com/mcp, klik Continue, biarkan opsi autentikasi yang ditandai Claude sebagai Detected (Claude mendaftarkannya secara otomatis), klik Add, lalu Connect. Pada paket Team dan Enterprise, Owner menambahkannya melalui Organization settings → Connectors, lalu setiap anggota menghubungkannya.
  2. ChatGPT: buka chatgpt.com/plugins, pilih +, lalu Add custom MCP server. Masukkan GridWhy, tempel https://gridwhy.com/mcp di bagian Connection, pilih OAuth untuk autentikasi, konfirmasi, lalu pilih Create as a plugin. Kebijakan ruang kerja Anda menentukan apakah server khusus diizinkan.

Aplikasi yang terhubung tercantum di Settings → API and MCP, tempat Anda dapat memutuskan koneksinya; aplikasi tersebut akan langsung berhenti berfungsi. Batasannya sama dengan kunci API (di bawah). Saat uji coba berakhir atau langganan dibatalkan, aplikasi tersebut akan menampilkan kesalahan yang jelas sampai Anda memilih paket. Nama menu di Claude dan ChatGPT dapat berubah sewaktu-waktu; URL-nya tetap sama.

1. Atau gunakan kunci

Masuk, buka Settings → API and MCP dan buat kunci. Kunci diawali gw_ dan hanya ditampilkan sekali. Kunci berlaku untuk seluruh ruang kerja Anda; Anda dapat mencabutnya kapan saja di sana.

Untuk Claude Code, Cursor, skrip, dan REST API. Endpoint MCP: https://gridwhy.com/mcp (Streamable HTTP). Kirim kunci sebagai Authorization: Bearer gw_…. Penemuan OAuth untuk klien yang mendukungnya: https://gridwhy.com/.well-known/oauth-protected-resource/mcp.

2. Hubungkan klien Anda

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), lalu mulai ulang

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

Memerlukan Node.js. Kunci disimpan dalam variabel lingkungan agar spasi setelah “Bearer” tetap ada di Windows.

Cursor: ~/.cursor/mcp.json (atau.cursor/mcp.json dalam proyek)

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

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

Di dalam aplikasi ChatGPT, gunakan koneksi satu klik di atas; panggilan API di sini menggunakan kunci secara langsung.

3. Alat

  • get_history Daftar lokasi, kata kunci yang dilacak beserta pemindaiannya, dari yang terbaru: jumlah titik kisi yang berada di peringkat 20 teratas dan 3 teratas, peringkat rata-rata dan terbaik, ringkasan satu baris tentang 'perubahan', serta tautan laporan. Tanpa argumen: setiap kata kunci beserta pemindaian terbarunya, serta sisa pemindaian manual. Argumen: location, keyword, keyword_id, limit (semuanya opsional)
  • explain_change Alasan perubahan peringkat antara suatu pemindaian dan pemindaian sebelumnya: temuan (cakupan, pesaing yang naik peringkat atau muncul, laju ulasan, perubahan rating, kategori, atau nama), masing-masing disertai kalimat untuk disampaikan kepada klien, serta langkah selanjutnya. Berikan scan_id, atau lokasi dan kata kunci untuk pemindaian terakhir yang selesai. Argumen: scan_id, location, keyword, keyword_id (semuanya opsional)
  • run_scan Memulai pemindaian kisi untuk satu kata kunci yang dilacak sekarang (di luar jadwal). Dihitung dalam jatah pemindaian manual akun (per hari dan per 30 hari); pemindaian pertama untuk suatu kata kunci gratis. Memerlukan waktu 15-30 detik; setelah itu, panggil explain_change dengan scan_id yang dikembalikan. Argumen: location, keyword, keyword_id (semuanya opsional)

Coba: “Jelaskan perubahan untuk Wilson Plumbing pada ‘plumber’ dan tulis pembaruan untuk klien.”

4. REST

Tiga operasi yang sama, kunci, batas, dan jawaban yang sama (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; pemindaian memerlukan waktu 15–30 detik)

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

Kesalahan dikembalikan sebagai { "error": "…" } dengan kode 400, 401, 403, 404, 409, atau 429 (dengan Retry-After).

5. Batas

PaketPanggilan API per jamrun_scan (pemindaian manual)
Solo1005 per hari, 30 per 30 hari
Agency50020 per hari, 100 per 30 hari
Agency+2,00050 per hari, 250 per 30 hari

Pemindaian terjadwal tidak pernah dibatasi oleh API. Uji coba gratis memiliki batas seperti paket Solo. Kunci berhenti berfungsi saat uji coba berakhir atau langganan dibatalkan.