GridWhy
resmiRiwayat 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/mcpdi Claude atau ChatGPT dengan masuk, atau gunakan kuncigw_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.
- 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. - ChatGPT: buka chatgpt.com/plugins, pilih +, lalu Add custom MCP server. Masukkan GridWhy, tempel
https://gridwhy.com/mcpdi 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_historyDaftar 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_changeAlasan 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_scanMemulai 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
| Paket | Panggilan API per jam | run_scan (pemindaian manual) |
|---|---|---|
| Solo | 100 | 5 per hari, 30 per 30 hari |
| Agency | 500 | 20 per hari, 100 per 30 hari |
| Agency+ | 2,000 | 50 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.