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) และเลือกได้ว่าแอปทำอะไรได้บ้าง: อ่าน (ตำแหน่ง ประวัติการสแกน และสิ่งที่เปลี่ยนแปลง) และ สแกน (เริ่มการสแกน ซึ่งใช้โควตาการสแกนด้วยตนเอง) ไม่ต้องคัดลอกคีย์

  1. Claude (claude.ai และแอปเดสก์ท็อป ทุกแพ็กเกจ): Customize → Connectors → Add → Add custom connector ตั้งชื่อว่า GridWhy วาง https://gridwhy.com/mcp คลิก Continue คงตัวเลือกการยืนยันตัวตนที่ Claude ระบุว่า Detected ไว้ (ระบบจะลงทะเบียนโดยอัตโนมัติ) คลิก Add แล้วคลิก Connect สำหรับแพ็กเกจ Team และ Enterprise เจ้าขององค์กรจะเพิ่มตัวเชื่อมต่อนี้ได้ที่ Organization settings → Connectors แล้วสมาชิกแต่ละคนจึงเชื่อมต่อ
  2. 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 (การสแกนด้วยตนเอง)
Solo1005 ครั้งต่อวัน, 30 ครั้งต่อ 30 วัน
Agency50020 ครั้งต่อวัน, 100 ครั้งต่อ 30 วัน
Agency+2,00050 ครั้งต่อวัน, 250 ครั้งต่อ 30 วัน

การสแกนตามกำหนดเวลาไม่ถูกจำกัดโดย API ช่วงทดลองใช้มีข้อจำกัดเท่ากับแพ็กเกจ Solo คีย์จะหยุดทำงานเมื่อช่วงทดลองใช้สิ้นสุดหรือยกเลิกการสมัครใช้บริการ