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. Ключ перестаёт работать по окончании пробного периода или при отмене подписки.