GridWhy
공식로컬 SEO를 위한 Google Maps 지오 그리드 순위 기록: 스캔 기록을 확인하고, 순위가 변경된 이유(경쟁업체, 리뷰, 카테고리 변경)를 물어 클라이언트에게 바로 전달할 수 있는 문구와 다음 단계를 확인하고, 새 그리드 스캔을 실행하세요.
GridWhy MCP(으)로 무엇을 할 수 있나요?
- 스캔 기록 검토 — 추적 중인 위치와 키워드의 최신 스캔 정보를 확인합니다. 상위 20위 및 상위 3위 그리드 수, 평균 및 최고 순위, 남은 수동 스캔 횟수가 포함됩니다.
- 순위 변동 설명 — 스캔 간 키워드 순위가 변한 이유를 확인합니다. 노출 범위, 경쟁사, 리뷰 증가 속도, 평점, 카테고리 또는 이름 변경을 다루며, 고객에게 바로 전달할 수 있는 문구도 제공합니다.
- 그리드 스캔 시작 — 추적 중인 키워드 하나를 지금 스캔합니다. 수동 스캔 허용량에서 차감되며, 후속 확인을 위한 스캔 ID가 반환됩니다.
- OAuth 또는 키로 연결 — Claude 또는 ChatGPT에서 로그인하여
https://gridwhy.com/mcp를 추가하거나, Claude Code, Cursor 및 스크립트에서gw_키를 사용합니다.
호스팅형 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 엔드포인트: 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가 필요합니다. 키는 환경 변수에 저장되므로 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" }'
오류는 400, 401, 403, 404, 409 또는 429 상태 코드와 함께 { "error": "…" }로 반환됩니다(Retry-After 포함).
5. 제한
| 요금제 | 시간당 API 호출 | run_scan (수동 스캔) |
|---|---|---|
| Solo | 100 | 하루 5회, 30일당 30회 |
| Agency | 500 | 하루 20회, 30일당 100회 |
| Agency+ | 2,000 | 하루 50회, 30일당 250회 |
예약된 스캔에는 API 제한이 적용되지 않습니다. 무료 체험에는 Solo 요금제의 제한이 적용됩니다. 체험 기간이 끝나거나 구독이 취소되면 키가 작동하지 않습니다.