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