Данные Google Maps / сервер MCP

Данные Google Maps внутри вашего ИИ-процесса.

Находите компании, читайте публичные отзывы и изучайте галереи мест с Claude Code, Cursor, VS Code или Codex. Три удалённых инструмента. Один и тот же ключ API.

Работает с вашим клиентом MCP

Удалённый Streamable HTTP · Приватный ключ API · Бесплатные и платные тарифы API

Три инструмента / Одно подключение

От поиска компаний к деталям места.

Каждый инструмент возвращает результат напрямую. Выберите операцию, нужную вашей задаче, и держите запрашиваемые страницы явными.

Найти компании

search_google_maps

Поиск по категории и местоположению. Получите до 20 компаний с доступными полями карточки, контактов, рейтинга и количества отзывов.

q · page · extra

Открыть Search API

Читать публичные отзывы

get_google_maps_reviews

Используйте feature ID места, чтобы запросить до 10 отзывов. Выберите по релевантности, новизне, высшему или низшему рейтингу.

fid · page · sort_by

Открыть Reviews API

Просматривать медиа галереи

get_google_maps_photos

Получите до 20 записей метаданных фото и видео для одного места. Читайте возвращённые URL медиа и флаг пагинации.

fid · page

Открыть Photos API

Отзывы и фото принимают feature ID Maps из place.dataId результата поиска. Поиск использует страницы 1–10; медиа-инструменты возвращают next, чтобы ваш агент мог решить, нужна ли ещё страница.

Подключение MCP

Один эндпоинт. Ваше рабочее пространство API.

Ваш клиент выполняет инициализацию и обнаружение инструментов, затем отправляет ваш ключ API с каждым запросом.

Подключение к удалённому MCP
POST https://gmapscrawl.com/api/mcp
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
Accept: application/json, text/event-stream

Настройка клиента

Выберите клиент, в котором работаете.

Создайте ключ API, затем скопируйте конфигурацию для вашего клиента. Храните ключ в его окружении или защищённой настройке ввода.

Добавьте этот сервер в .mcp.json. Сделайте GMSCRAPER_API_KEY доступным в окружении, запускающем Claude Code.

{
  "mcpServers": {
    "google-maps-data": {
      "type": "http",
      "url": "https://gmapscrawl.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${GMSCRAPER_API_KEY}"
      }
    }
  }
}
Документация Claude Code ↗

После сохранения конфигурации переподключитесь и убедитесь, что три инструмента появились. Следуйте пошаговому руководству по настройке.

Ваш первый процесс

Подключитесь. Протестируйте одну страницу. Прочитайте результат.

Начните с тестового ключа и имитированных данных. Переключитесь на реальный ключ, когда будете готовы использовать свою квоту API.

01

Подготовьте рабочее пространство

Выберите продукт API и создайте тестовый ключ со scrapes:write. Ваш тариф API должен разрешать MCP; у Online и Extension отдельные квоты.

Создать ключ
02

Обнаружьте и вызовите один инструмент

Подключите клиент, изучите search_google_maps и запросите одну страницу. Генерируйте новый ID запроса для новой работы и сохраняйте его при повторе того же запроса.

Посмотреть настройку клиента
03

Используйте возвращённые компании

Читайте structuredContent.businesses и total. Помечайте тестовые результаты как имитированные, сохраняйте отсутствующие значения и остановитесь после запрошенной страницы.

Понять поля
Вызов search_google_maps

Заменяйте ID запроса для каждого нового поиска. Этот пример не выполняет запрос со страницы.

{
  "q": "coffee shops in Seattle",
  "page": 1,
  "hl": "en",
  "extra": false,
  "client_request_id": "replace-with-a-fresh-uuid"
}

Что возвращается

Структурированные записи в том же ответе инструмента.

businesses
До 20 возвращённых компаний; поля могут отсутствовать.
params + total
Нормализованный запрос и количество на этой странице.
simulated + usage metadata
Тестовые ответы обозначают фикстурные данные и используют ноль реальных единиц запросов.
isError
Проверяйте ошибку, прежде чем сообщать, что инструмент выполнен успешно.

Результаты возвращаются напрямую; опрос задач не нужен. Сохраняйте даты наблюдений источника при превращении JSON в таблицу или отчёт.

Примеры промптов

Полезный вопрос. Ясная точка остановки.

Используйте эти промпты после подключения. Укажите реальный feature ID там, где нужно, и попросите агента помечать тестовые результаты как имитированные.

Составить сфокусированный список компаний

“Используй search_google_maps один раз для кофеен в Сиэтле, страница 1, extra false. Верни названия, сайты, номера телефонов, рейтинги и количество отзывов из возвращённых компаний. Оставь отсутствующие поля пустыми и покажи даты наблюдений. Остановись после этой страницы.”

Ожидаемый результат

Таблица до 20 возвращённых компаний с отметками времени источника и сохранёнными отсутствующими значениями.

Обобщить одну страницу отзывов

“Для выбранной мной компании используй её place.dataId как fid. Запроси страницу 1 get_google_maps_reviews с sort_by 2. Обобщи темы только в этих возвращённых отзывах и цитируй их даты. Не запрашивай дополнительные страницы.”

Ожидаемый результат

Ограниченное резюме до 10 отзывов, без трактовки одной страницы как опыта всех клиентов.

Изучить одну галерею

“Используй get_google_maps_photos для этого указанного feature ID, только страница 1. Перечисли возвращённые поля photoUrl и необязательные videoUrl и сообщи, равен ли next true. Не скачивай файлы и не запрашивай следующую страницу.”

Ожидаемый результат

До 20 записей галереи и возвращённое состояние пагинации, готовые для изучения вашим приложением.

REST + MCP

Одна квота API для обоих интерфейсов.

MCP доступен на бесплатных и платных тарифах API. Каждая успешная реальная страница источника использует одну единицу запросов API, включая пустую страницу.

01

Тестируйте без реального расхода

Тестовые ключи возвращают имитированные фикстуры с нулём единиц запросов. Они проверяют вашу интеграцию, а не создают реальные лиды компаний.

Управление ключами API
02

Держите запросы ограниченными

Запрашивайте только страницы и местоположения, нужные вашей задаче. Используйте новый ID запроса для новой работы; повторяйте неопределённые запросы с тем же вводом и ID.

Читать рекомендации по использованию
03

Добавьте переиспользуемые инструкции

Agent Skill Google Maps Data добавляет рекомендации по процессу, справочники операций и REST-запасной вариант к тем же инструментам.

Открыть Agent Skill

Открыть центр API → У тарифов Online и Extension свои квоты.

Помощь с подключением

Дойдите до следующего успешного запроса.

Используйте состояние подключения и возвращённую ошибку, чтобы выбрать следующий шаг.

Клиент подключается, но инструменты не появляются
Убедитесь, что эндпоинт — /api/mcp, а ваш клиент поддерживает удалённый Streamable HTTP с приватным заголовком Authorization. Перезагрузите подключение и проверьте, что процесс может прочитать настроенный ключ.
401 или 403
Проверьте срок действия ключа, разрешённые IP, активный доступ к рабочему пространству, разрешение scrapes:write и тариф API, разрешающий MCP. Cookies входа в браузере не аутентифицируют эндпоинт.
invalid_request
Прочитайте схему выбранного инструмента. Укажите уникальный client_request_id длиной 16–128 символов; для отзывов и фото также нужен FID из place.dataId, а не название компании или другой идентификатор места.
rate_limited или quota_exceeded
Соблюдайте retry_after для ограничений частоты. Остановитесь при исчерпании квоты API и проверьте использование API; создание ещё одного ключа не добавляет квоту.
capability_unavailable или сбой источника
Проверьте статус сервиса и возвращённую ошибку. Доступность определяется сервером. Сохраняйте отсутствующие или недоступные данные явными в вашем результате.
Таймаут или isError: true
Проверяйте ошибку инструмента, даже когда HTTP-подключение успешно. Для повторяемых сбоев сохраняйте тот же ввод и ID запроса в пределах дедлайна задачи. Следуйте указаниям по терминальным ошибкам перед началом новой попытки.

Статус сервиса Ошибки и рекомендации по повторам

Часто задаваемые вопросы

Что может сервер Google Maps MCP?

Он предоставляет search_google_maps, get_google_maps_reviews и get_google_maps_photos. Поиск возвращает до 20 компаний; отзывы — до 10 записей, фото — до 20 записей галереи на страницу. Инструменты возвращают структурированные данные напрямую.

Какие клиенты можно подключить?

Используйте версию Claude Code, Cursor, VS Code, Codex или другого клиента MCP, поддерживающую удалённый Streamable HTTP и приватный заголовок Authorization. Четыре конфигурации клиентов выше используют один эндпоинт и ключ рабочего пространства API.

Как аутентифицироваться?

Создайте ключ API со scrapes:write в вашем рабочем пространстве API и настройте его приватно как Bearer-заголовок. Cookies браузера не аутентифицируют MCP. Держите ключи вне промптов, URL и закоммиченного исходного кода.

Как отзывы и фото находят нужное место?

Передайте feature ID Maps как fid. Можно использовать place.dataId из возвращённой компании. Отзывы также принимают sort_by: 1 — по релевантности, 2 — новые, 3 — высший рейтинг, 4 — низший рейтинг. Читайте next, прежде чем рассматривать ещё одну страницу медиа.

Есть ли у MCP отдельная квота?

MCP делит квоту REST API и доступен на бесплатных и платных тарифах API. Успешная реальная страница использует одну единицу запросов, включая пустую. Тестовые учётные данные возвращают имитированные данные с нулём единиц. Квоты Online и Extension отдельные.

Нужен ли ещё и Agent Skill?

Сервер MCP работает сам по себе. Необязательный Agent Skill Google Maps Data добавляет переиспользуемые инструкции, справочники операций и помощник для REST-запасного варианта, когда настроенное подключение MCP недоступно.

Следующий шаг

Внесите данные Google Maps в ваш следующий диалог.

Создайте ключ API, подключите предпочитаемый клиент и протестируйте один сфокусированный поиск компаний.