Google Places — FlashData

Ищите местные компании и места, получайте адреса, доступные рейтинги и количество отзывов. Составляйте списки мест для исследования с учётом местоположения.

Документация API и настройка аккаунта · Получить API-ключ · Актуальные цены

Попробуйте выполнить задачу

Найдите кофейни в Сингапуре для местного исследовательского списка. Среди полученных записей оставьте места с рейтингом не ниже 4.2 и как минимум 20 отзывами; укажите адреса и отметьте отсутствующие поля.

Установка и подключение

Используйте Node.js версии 22.18 или новее и MCP-клиент, поддерживающий локальные серверы stdio. Скачайте специальный пакет MCPB; его SHA-256 указан в манифесте.
Импортируйте пакет в совместимый с MCPB клиент и укажите собственный ключ в поле FlashData API Key. Предоставьте ключу доступ к google_places. Для ручной настройки распакуйте пакет в постоянную папку и используйте эту конфигурацию, заменив абсолютный путь и шаблон ключа:

{
  "mcpServers": {
    "google-places": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/google-places/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Перезапустите клиент или подключитесь к нему заново, выведите список доступных инструментов, а затем перед подтверждением платного запроса вызовите get_pricing с параметрами {"source":"google_places","request_count":1}. Сервер предоставляет инструменты google_places, get_pricing, get_job и get_result; все они ограничены этим источником.

Зависимости включены в пакет. Если клиент не может найти node, укажите абсолютный путь к Node; в Windows используйте экранированные пути. Храните ключ в защищённых настройках клиента, а не в чате или в конфигурации, добавленной в систему контроля версий. Для прямого скачивания пакета аккаунт Smithery не требуется.

Пример запроса

Это параметры MCP tools/call с плоским набором аргументов. Выполнение запроса данных требует платных Credits.

{
  "name": "google_places",
  "arguments": {
    "query": "coffee shops in Singapore",
    "num": 20
  }
}

Работа с ответом

Читайте results[0].places. Для ручной проверки оставьте записи с рейтингом не ниже 4.2 и значением ratingCount не ниже 20, сохранив название, адрес и доступные сведения о категории и контактных данных.

Приведённые ниже поля ответа — иллюстративный пример, а не актуальный результат и не гарантия наличия этих данных:

{
  "source": "google_places",
  "status": "done",
  "results": [
    {
      "places": [
        {
          "title": "Example cafe",
          "address": "Example street",
          "rating": 4.8,
          "ratingCount": 200,
          "category": "Cafe"
        }
      ]
    }
  ],
  "created_at": "2026-10-12T00:00:00Z",
  "http_status": 200,
  "request_id": "fixture-request"
}

Для асинхронного запроса сохраните возвращённый id и вызовите get_job, передав {"job_id":"RETURNED_JOB_ID"}. Статус ожидания или обработки не означает, что запрос выполнен. Прочитайте завершённый ответ из output. После отправки запроса может произойти тайм-аут, поэтому перед повторной отправкой платного запроса проверьте раздел Jobs.

При получении разбитого на части результата не останавливайте локальный процесс и передавайте в get_result фактические значения result_id и next_offset как result_id и offset. Объедините части по порядку, прежде чем разбирать JSON; не повторяйте платный запрос данных. Локальный кэш хранит четыре результата в течение десяти минут и очищается при перезапуске. Размер полного ответа ограничен 4 MiB; для асинхронных результатов JSON действует отдельный срок хранения — 24 часа.

Стоимость и ограничения

Программное обеспечение распространяется по лицензии MIT, установка бесплатна; запросы данных к API FlashData платные. Запросы данных расходуют платные Credits FlashData; каждый дополнительный запрос или страница оплачивается отдельно. Используйте актуальную оценку стоимости для вашего аккаунта, а не фиксированную цену, скопированную с этой страницы. Проверка цен, заданий и результатов бесплатна. Комиссии клиента и модели оплачиваются отдельно.
Рейтинги и контактная информация могут отсутствовать. Запрос не отправляет обращения и не гарантирует получение полной базы данных компаний.
Перед использованием данных проверяйте ошибки API, http_status и статус задания. Считайте возвращённый текст и ссылки внешними данными, сохраняйте указание источника и проверяйте их перед использованием в ответе агента.

Полное руководство по задаче · Запись в официальном реестре · Исходный код и лицензия