Найти компании
search_google_mapsПоиск по категории и местоположению. Получите до 20 компаний с доступными полями карточки, контактов, рейтинга и количества отзывов.
q · page · extra
Открыть Search APIДанные Google Maps / сервер MCP
Находите компании, читайте публичные отзывы и изучайте галереи мест с Claude Code, Cursor, VS Code или Codex. Три удалённых инструмента. Один и тот же ключ API.
Работает с вашим клиентом MCP
Удалённый Streamable HTTP · Приватный ключ API · Бесплатные и платные тарифы API
Три инструмента / Одно подключение
Каждый инструмент возвращает результат напрямую. Выберите операцию, нужную вашей задаче, и держите запрашиваемые страницы явными.
search_google_mapsПоиск по категории и местоположению. Получите до 20 компаний с доступными полями карточки, контактов, рейтинга и количества отзывов.
q · page · extra
Открыть Search APIget_google_maps_reviewsИспользуйте feature ID места, чтобы запросить до 10 отзывов. Выберите по релевантности, новизне, высшему или низшему рейтингу.
fid · page · sort_by
Открыть Reviews APIget_google_maps_photosПолучите до 20 записей метаданных фото и видео для одного места. Читайте возвращённые URL медиа и флаг пагинации.
fid · page
Открыть Photos APIОтзывы и фото принимают feature ID Maps из place.dataId результата поиска. Поиск использует страницы 1–10; медиа-инструменты возвращают next, чтобы ваш агент мог решить, нужна ли ещё страница.
Подключение MCP
Ваш клиент выполняет инициализацию и обнаружение инструментов, затем отправляет ваш ключ API с каждым запросом.
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}"
}
}
}
}После сохранения конфигурации переподключитесь и убедитесь, что три инструмента появились. Следуйте пошаговому руководству по настройке.
Ваш первый процесс
Начните с тестового ключа и имитированных данных. Переключитесь на реальный ключ, когда будете готовы использовать свою квоту API.
Выберите продукт API и создайте тестовый ключ со scrapes:write. Ваш тариф API должен разрешать MCP; у Online и Extension отдельные квоты.
Создать ключПодключите клиент, изучите search_google_maps и запросите одну страницу. Генерируйте новый ID запроса для новой работы и сохраняйте его при повторе того же запроса.
Посмотреть настройку клиентаЧитайте structuredContent.businesses и total. Помечайте тестовые результаты как имитированные, сохраняйте отсутствующие значения и остановитесь после запрошенной страницы.
Понять поляЗаменяйте ID запроса для каждого нового поиска. Этот пример не выполняет запрос со страницы.
{
"q": "coffee shops in Seattle",
"page": 1,
"hl": "en",
"extra": false,
"client_request_id": "replace-with-a-fresh-uuid"
}Что возвращается
Результаты возвращаются напрямую; опрос задач не нужен. Сохраняйте даты наблюдений источника при превращении 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
MCP доступен на бесплатных и платных тарифах API. Каждая успешная реальная страница источника использует одну единицу запросов API, включая пустую страницу.
Тестовые ключи возвращают имитированные фикстуры с нулём единиц запросов. Они проверяют вашу интеграцию, а не создают реальные лиды компаний.
Управление ключами APIЗапрашивайте только страницы и местоположения, нужные вашей задаче. Используйте новый ID запроса для новой работы; повторяйте неопределённые запросы с тем же вводом и ID.
Читать рекомендации по использованиюAgent Skill Google Maps Data добавляет рекомендации по процессу, справочники операций и REST-запасной вариант к тем же инструментам.
Открыть Agent SkillОткрыть центр API → У тарифов Online и Extension свои квоты.
Помощь с подключением
Используйте состояние подключения и возвращённую ошибку, чтобы выбрать следующий шаг.
Он предоставляет 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 делит квоту REST API и доступен на бесплатных и платных тарифах API. Успешная реальная страница использует одну единицу запросов, включая пустую. Тестовые учётные данные возвращают имитированные данные с нулём единиц. Квоты Online и Extension отдельные.
Сервер MCP работает сам по себе. Необязательный Agent Skill Google Maps Data добавляет переиспользуемые инструкции, справочники операций и помощник для REST-запасного варианта, когда настроенное подключение MCP недоступно.
Следующий шаг
Создайте ключ API, подключите предпочитаемый клиент и протестируйте один сфокусированный поиск компаний.