GridWhy
ทางการประวัติอันดับแบบกริดภูมิศาสตร์บน Google Maps สำหรับ SEO ในพื้นที่: ดูประวัติการสแกน ถามได้ว่าเหตุใดอันดับจึงเปลี่ยนแปลง (คู่แข่ง รีวิว การเปลี่ยนแปลงหมวดหมู่) พร้อมข้อความที่พร้อมส่งให้ลูกค้าและขั้นตอนถัดไป และเรียกใช้การสแกนกริดใหม่
คุณทำอะไรได้บ้างด้วย GridWhy MCP?
- ตรวจสอบประวัติการสแกน — ดูตำแหน่งและคีย์เวิร์ดที่ติดตามพร้อมผลสแกนล่าสุด รวมถึงจำนวนกริดที่ติดอันดับ 20 และ 3 อันดับแรก อันดับเฉลี่ยและอันดับที่ดีที่สุด และจำนวนการสแกนด้วยตนเองที่เหลืออยู่
- อธิบายการเปลี่ยนแปลงอันดับ — ดูสาเหตุที่คีย์เวิร์ดเปลี่ยนอันดับระหว่างการสแกน โดยครอบคลุมการมองเห็น คู่แข่ง ความเร็วในการรีวิว คะแนน และการเปลี่ยนแปลงหมวดหมู่หรือชื่อ พร้อมข้อความที่พร้อมส่งให้ลูกค้า
- เริ่มสแกนกริด — เริ่มสแกนคีย์เวิร์ดที่ติดตามหนึ่งคำได้ทันที โดยนับรวมในโควตาการสแกนด้วยตนเอง และส่งคืน ID การสแกนสำหรับติดตามผล
- เชื่อมต่อผ่าน OAuth หรือคีย์ — เพิ่ม
https://gridwhy.com/mcpใน Claude หรือ ChatGPT แล้วลงชื่อเข้าใช้ หรือใช้คีย์gw_สำหรับ Claude Code, Cursor และสคริปต์
เซิร์ฟเวอร์ 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 เจ้าขององค์กรจะเพิ่มตัวเชื่อมต่อนี้ได้ที่ Organization settings → Connectors แล้วสมาชิกแต่ละคนจึงเชื่อมต่อ - ChatGPT: เปิด chatgpt.com/plugins เลือก + แล้วเลือก Add custom MCP server ป้อน GridWhy วาง
https://gridwhy.com/mcpในส่วน Connection เลือก 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: https://gridwhy.com/mcp (Streamable HTTP) ส่งคีย์เป็น Authorization: Bearer gw_… การค้นหา OAuth สำหรับไคลเอนต์ที่รองรับ: 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 คีย์จะอยู่ในตัวแปรสภาพแวดล้อม เพื่อให้เว้นวรรคหลัง “Bearer” ได้เมื่อใช้ Windows
Cursor: ~/.cursor/mcp.json (หรือ .cursor/mcp.json ในโปรเจกต์)
{
"mcpServers": {
"gridwhy": {
"url": "https://gridwhy.com/mcp",
"headers": { "Authorization": "Bearer gw_your_key" }
}
}
}
โมเดล ChatGPT ผ่าน 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?"
}'
ภายในแอป 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 วินาที จากนั้นเรียก explain_change โดยใช้ scan_id ที่ส่งกลับมา อาร์กิวเมนต์: 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 ครั้งต่อวัน, 100 ครั้งต่อ 30 วัน |
| Agency+ | 2,000 | 50 ครั้งต่อวัน, 250 ครั้งต่อ 30 วัน |
การสแกนตามกำหนดเวลาไม่ถูกจำกัดโดย API ช่วงทดลองใช้มีข้อจำกัดเท่ากับแพ็กเกจ Solo คีย์จะหยุดทำงานเมื่อช่วงทดลองใช้สิ้นสุดหรือยกเลิกการสมัครใช้บริการ