GridWhy
आधिकारिकस्थानीय SEO के लिए Google Maps geo-grid रैंक इतिहास: स्कैन इतिहास देखें, पूछें कि रैंकिंग क्यों बदली (प्रतिस्पर्धियों, समीक्षाओं, श्रेणी में बदलाव के कारण), क्लाइंट के लिए तैयार पंक्तियाँ और अगले कदम पाएँ, और नया ग्रिड स्कैन चलाएँ।
GridWhy MCP के साथ आप क्या कर सकते हैं?
- स्कैन इतिहास की समीक्षा करें — ट्रैक की गई लोकेशन और कीवर्ड के नवीनतम स्कैन की जानकारी माँगें, जिसमें टॉप-20 और टॉप-3 ग्रिड काउंट, औसत और सर्वश्रेष्ठ रैंक, और शेष मैन्युअल स्कैन शामिल हों।
- रैंकिंग में बदलाव समझाएँ — जानें कि स्कैन के बीच कोई कीवर्ड क्यों ऊपर या नीचे गया, जिसमें कवरेज, प्रतिस्पर्धी, रिव्यू की गति, रेटिंग और कैटेगरी या नाम में बदलाव शामिल हों; साथ में क्लाइंट के लिए तैयार पंक्तियाँ भी पाएँ।
- ग्रिड स्कैन शुरू करें — अभी किसी एक ट्रैक किए गए कीवर्ड के लिए स्कैन शुरू करें। यह आपके मैन्युअल स्कैन की सीमा में गिना जाएगा और आगे की जानकारी के लिए एक स्कैन ID देगा।
- OAuth या key से कनेक्ट करें — Claude या ChatGPT में साइन-इन करके
https://gridwhy.com/mcpजोड़ें, या Claude Code, Cursor और स्क्रिप्ट के लिएgw_key का उपयोग करें।
होस्ट किया गया MCP सर्वर
npx add-mcp 'https://gridwhy.com/mcp'Claude Code, Codex, Cursor और अन्य में इंस्टॉल होता है
दस्तावेज़
एक क्लिक में कनेक्ट करें
Claude और ChatGPT को केवल URL https://gridwhy.com/mcp की ज़रूरत है। वे GridWhy का एक पेज खोलते हैं, जहाँ आप हमेशा की तरह साइन इन करते हैं (ईमेल लिंक या Google से) और चुनते हैं कि ऐप क्या कर सकता है: पढ़ना (लोकेशन, स्कैन इतिहास, क्या बदला) और स्कैन करना (स्कैन शुरू करना, जिनमें आपके मैन्युअल स्कैन की सीमा का उपयोग होता है)। कॉपी करने के लिए कोई कुंजी नहीं।
- Claude (claude.ai और डेस्कटॉप ऐप, किसी भी प्लान पर): Customize → Connectors → Add → Add custom connector चुनें। इसका नाम GridWhy रखें,
https://gridwhy.com/mcpपेस्ट करें, Continue पर क्लिक करें, Claude द्वारा Detected के रूप में चिह्नित प्रमाणीकरण विकल्प वैसे ही रहने दें (यह अपने-आप रजिस्टर हो जाता है), Add पर क्लिक करें, फिर Connect पर क्लिक करें। Team और Enterprise प्लान पर Owner इसे Organization settings → Connectors के अंतर्गत जोड़ता है और हर सदस्य कनेक्ट करता है। - ChatGPT: chatgpt.com/plugins खोलें, + चुनें, फिर Add custom MCP server चुनें। GridWhy दर्ज करें, Connection के अंतर्गत
https://gridwhy.com/mcpपेस्ट करें, प्रमाणीकरण के लिए OAuth चुनें, पुष्टि करें और Create as a plugin चुनें। कस्टम सर्वर की अनुमति है या नहीं, यह आपके वर्कस्पेस की नीतियाँ तय करती हैं।
कनेक्ट किए गए ऐप Settings → API and MCP के अंतर्गत सूचीबद्ध होते हैं, जहाँ आप उन्हें डिस्कनेक्ट कर सकते हैं; वे तुरंत काम करना बंद कर देते हैं। उन पर API कुंजी जैसी ही सीमाएँ लागू होती हैं (नीचे देखें)। ट्रायल समाप्त होने या सदस्यता रद्द होने पर, प्लान चुनने तक उन्हें एक स्पष्ट त्रुटि मिलती है। Claude और ChatGPT में मेनू के नाम समय-समय पर बदलते रहते हैं; URL वही रहता है।
1. या कुंजी का उपयोग करें
साइन इन करें, Settings → API and MCP खोलें और एक कुंजी बनाएँ। यह gw_ से शुरू होती है और केवल एक बार दिखाई जाती है। कुंजी आपके पूरे वर्कस्पेस के लिए काम करती है; आप इसे वहाँ कभी भी रद्द कर सकते हैं।
Claude Code, Cursor, स्क्रिप्ट और REST API के लिए। MCP endpoint: https://gridwhy.com/mcp (Streamable HTTP)। कुंजी को Authorization: Bearer gw_… के रूप में भेजें। इसका समर्थन करने वाले क्लाइंट के लिए OAuth discovery: https://gridwhy.com/.well-known/oauth-protected-resource/mcp।
2. अपना क्लाइंट कनेक्ट करें
Claude Code (टर्मिनल)
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), फिर रीस्टार्ट करें
{
"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 आवश्यक है। कुंजी एक environment variable में रखी जाती है, ताकि Windows पर “Bearer” के बाद का स्पेस बना रहे।
Cursor: ~/.cursor/mcp.json (या किसी प्रोजेक्ट में .cursor/mcp.json)
{
"mcpServers": {
"gridwhy": {
"url": "https://gridwhy.com/mcp",
"headers": { "Authorization": "Bearer gw_your_key" }
}
}
}
OpenAI Responses API के ज़रिए ChatGPT मॉडल
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 ऐप के भीतर, इसके बजाय ऊपर दिया गया एक-क्लिक कनेक्शन इस्तेमाल करें; यहाँ API कॉल में सीधे कुंजी दी जाती है।
3. टूल
get_historyलोकेशन, ट्रैक किए गए कीवर्ड और उनके स्कैन, सबसे नए पहले: शीर्ष 20 और शीर्ष 3 में रैंक करने वाले ग्रिड पॉइंट की संख्या, औसत और सर्वश्रेष्ठ रैंक, एक-पंक्ति में 'क्या बदला', और रिपोर्ट का लिंक। बिना आर्ग्युमेंट के: हर कीवर्ड का नवीनतम स्कैन, साथ ही बचे हुए मैन्युअल स्कैन। आर्ग्युमेंट: location, keyword, keyword_id, limit (सभी वैकल्पिक)explain_changeएक स्कैन और उससे पहले वाले स्कैन के बीच रैंकिंग क्यों बदली: निष्कर्ष (कवरेज, ऊपर आए या दिखाई दिए प्रतिस्पर्धी, समीक्षा की गति, रेटिंग, श्रेणी या नाम में बदलाव), हर निष्कर्ष के साथ क्लाइंट को भेजने के लिए एक पंक्ति, और अगले कदम। scan_id दें, या किसी लोकेशन और कीवर्ड के लिए उनका नवीनतम पूरा हुआ स्कैन दें। आर्ग्युमेंट: scan_id, location, keyword, keyword_id (सभी वैकल्पिक)run_scanअभी एक ट्रैक किए गए कीवर्ड के लिए ग्रिड स्कैन शुरू करता है (निर्धारित समय-सारणी के अतिरिक्त)। यह खाते के मैन्युअल स्कैन में गिना जाता है (प्रति दिन और प्रति 30 दिन); किसी कीवर्ड का पहला स्कैन मुफ़्त है। इसमें 15-30 सेकंड लगते हैं; फिर लौटाए गए scan_id के साथ explain_change कॉल करें। आर्ग्युमेंट: location, keyword, keyword_id (सभी वैकल्पिक)
आज़माएँ: “Wilson Plumbing के लिए ‘plumber’ पर क्या बदला, यह समझाएँ और क्लाइंट के लिए अपडेट लिखें।”
4. REST
वही तीन ऑपरेशन, वही कुंजी, सीमाएँ और जवाब (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; स्कैन में 15–30 सेकंड लगते हैं)
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" }'
त्रुटियाँ { "error": "…" } के रूप में 400, 401, 403, 404, 409 या 429 के साथ लौटती हैं (Retry-After के साथ)।
5. सीमाएँ
| प्लान | प्रति घंटे API कॉल | run_scan (मैन्युअल स्कैन) |
|---|---|---|
| Solo | 100 | प्रति दिन 5, प्रति 30 दिन 30 |
| Agency | 500 | प्रति दिन 20, प्रति 30 दिन 100 |
| Agency+ | 2,000 | प्रति दिन 50, प्रति 30 दिन 250 |
निर्धारित स्कैन पर API की सीमाएँ कभी लागू नहीं होतीं। मुफ़्त ट्रायल में Solo की सीमाएँ लागू होती हैं। ट्रायल समाप्त होने या सदस्यता रद्द होने पर कुंजी काम करना बंद कर देती है।