GridWhy

chính thức

Lịch sử thứ hạng geo-grid trên Google Maps cho SEO địa phương: xem lịch sử quét, hỏi lý do thứ hạng thay đổi (đối thủ cạnh tranh, đánh giá, thay đổi danh mục) với các câu trả lời sẵn sàng gửi cho khách hàng và các bước tiếp theo, đồng thời chạy một lượt quét lưới mới.

Bạn có thể làm gì với GridWhy MCP?

  • Xem lại lịch sử quét — Yêu cầu danh sách vị trí và từ khóa được theo dõi cùng các lần quét mới nhất, bao gồm số lượng trong top 20 và top 3 trên lưới, thứ hạng trung bình và cao nhất, cùng số lượt quét thủ công còn lại.
  • Giải thích thay đổi thứ hạng — Tìm hiểu lý do từ khóa thay đổi thứ hạng giữa các lần quét, bao gồm độ phủ, đối thủ cạnh tranh, tốc độ nhận đánh giá, điểm xếp hạng và thay đổi về danh mục hoặc tên, kèm theo các câu có thể gửi cho khách hàng.
  • Bắt đầu quét lưới — Kích hoạt quét ngay một từ khóa được theo dõi. Lượt quét này sẽ được tính vào hạn mức quét thủ công và trả về mã quét để theo dõi.
  • Kết nối qua OAuth hoặc khóa — Thêm https://gridwhy.com/mcp vào Claude hoặc ChatGPT để đăng nhập, hoặc dùng khóa gw_ cho Claude Code, Cursor và các tập lệnh.

Máy chủ MCP được lưu trữ

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

Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác

Tài liệu

Kết nối chỉ với một cú nhấp

Claude và ChatGPT chỉ cần URL https://gridwhy.com/mcp. Chúng sẽ mở một trang GridWhy, nơi bạn đăng nhập như thường lệ (qua liên kết email hoặc Google) và chọn những gì ứng dụng được phép thực hiện: đọc (địa điểm, lịch sử quét, những thay đổi) và quét (bắt đầu quét, sử dụng hạn mức quét thủ công của bạn). Không cần sao chép khóa.

  1. Claude (claude.ai và ứng dụng máy tính, mọi gói): Customize → Connectors → Add → Add custom connector. Đặt tên là GridWhy, dán https://gridwhy.com/mcp, nhấp Continue, giữ nguyên các tùy chọn xác thực mà Claude đánh dấu là Detected (Claude tự động đăng ký), nhấp Add, rồi Connect. Với gói Team và Enterprise, Chủ sở hữu thêm ứng dụng trong Organization settings → Connectors, sau đó từng thành viên kết nối.
  2. ChatGPT: mở chatgpt.com/plugins, chọn +, rồi Add custom MCP server. Nhập GridWhy, dán https://gridwhy.com/mcp vào mục Connection, chọn OAuth để xác thực, xác nhận rồi chọn Create as a plugin. Chính sách của không gian làm việc sẽ quyết định có cho phép máy chủ tùy chỉnh hay không.

Các ứng dụng đã kết nối được liệt kê trong Settings → API and MCP, nơi bạn có thể ngắt kết nối; chúng sẽ ngừng hoạt động ngay lập tức. Chúng có cùng giới hạn như khóa API (bên dưới). Khi thời gian dùng thử kết thúc hoặc gói đăng ký bị hủy, chúng sẽ trả về thông báo lỗi rõ ràng cho đến khi bạn chọn một gói. Tên menu trong Claude và ChatGPT thỉnh thoảng thay đổi; URL vẫn giữ nguyên.

1. Hoặc dùng khóa

Đăng nhập, mở Settings → API and MCP và tạo khóa. Khóa bắt đầu bằng gw_ và chỉ được hiển thị một lần. Khóa có hiệu lực trên toàn bộ không gian làm việc của bạn; bạn có thể thu hồi khóa tại đó bất cứ lúc nào.

Dành cho Claude Code, Cursor, tập lệnh và REST API. Điểm cuối MCP: https://gridwhy.com/mcp (Streamable HTTP). Gửi khóa dưới dạng Authorization: Bearer gw_…. Khám phá OAuth dành cho các ứng dụng hỗ trợ tính năng này: https://gridwhy.com/.well-known/oauth-protected-resource/mcp.

2. Kết nối ứng dụng

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), sau đó khởi động lại

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

Cần Node.js. Khóa được lưu trong biến môi trường để khoảng trắng sau “Bearer” vẫn được giữ nguyên trên Windows.

Cursor: ~/.cursor/mcp.json (hoặc .cursor/mcp.json trong dự án)

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

Các mô hình ChatGPT thông qua 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?"
  }'

Trong ứng dụng ChatGPT, hãy dùng kết nối một cú nhấp ở trên; lệnh gọi API tại đây nhận khóa trực tiếp.

3. Công cụ

  • get_history Địa điểm, từ khóa được theo dõi và các lần quét của chúng, mới nhất trước: số điểm trên lưới xếp hạng trong top 20 và top 3, thứ hạng trung bình và cao nhất, nội dung tóm tắt một dòng về “những thay đổi” và liên kết báo cáo. Không có đối số: mọi từ khóa cùng lần quét mới nhất của chúng, cộng với số lượt quét thủ công còn lại. Đối số: location, keyword, keyword_id, limit (tất cả đều tùy chọn)
  • explain_change Lý do thứ hạng thay đổi giữa một lần quét và lần trước đó: các phát hiện (mức độ bao phủ, đối thủ cạnh tranh tăng hạng hoặc mới xuất hiện, tốc độ đánh giá, điểm đánh giá, thay đổi danh mục hoặc tên), mỗi phát hiện kèm một câu để gửi cho khách hàng, cùng các bước tiếp theo. Truyền scan_id, hoặc location và keyword để lấy lần quét hoàn tất mới nhất của chúng. Đối số: scan_id, location, keyword, keyword_id (tất cả đều tùy chọn)
  • run_scan Bắt đầu quét lưới ngay cho một từ khóa được theo dõi (ngoài lịch quét định kỳ). Tính vào số lượt quét thủ công của tài khoản (mỗi ngày và mỗi 30 ngày); lần quét đầu tiên của một từ khóa được miễn phí. Mất 15-30 giây; sau đó gọi explain_change với scan_id được trả về. Đối số: location, keyword, keyword_id (tất cả đều tùy chọn)

Thử: “Giải thích những thay đổi đối với Wilson Plumbing cho ‘plumber’ và viết nội dung cập nhật cho khách hàng.”

4. REST

Cùng ba thao tác, cùng khóa, giới hạn và câu trả lời (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; quá trình quét mất 15–30 giây)

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

Lỗi được trả về dưới dạng { "error": "…" } với mã 400, 401, 403, 404, 409 hoặc 429 (kèm Retry-After).

5. Giới hạn

GóiSố lệnh gọi API mỗi giờrun_scan (lượt quét thủ công)
Solo1005 mỗi ngày, 30 mỗi 30 ngày
Agency50020 mỗi ngày, 100 mỗi 30 ngày
Agency+2,00050 mỗi ngày, 250 mỗi 30 ngày

API không bao giờ giới hạn các lần quét theo lịch. Bản dùng thử miễn phí có giới hạn như gói Solo. Khóa sẽ ngừng hoạt động khi thời gian dùng thử kết thúc hoặc gói đăng ký bị hủy.