Google Shopping — FlashData

Поиск товаров, продавцов и ценовых обозначений в Google Shopping. Сбор сопоставимых снимков предложений с идентификаторами товаров и ссылками на источники.

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

Пример задачи

Составьте таблицу для сравнения предложений беспроводных наушников: укажите названия товаров и продавцов, ссылки и исходные ценовые обозначения. Не объединяйте разные валюты и отметьте предложения без цены.

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

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

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

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

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

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

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

{
  "name": "google_shopping",
  "arguments": {
    "query": "wireless headphones",
    "gl": "us",
    "hl": "en",
    "num": 10
  }
}

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

Изучите results[0].shopping. Свяжите данные с ранее сохранённым снимком по productId или ссылке, затем сравните исходные строки цен и сохраните название, источник и время получения данных.

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

{
  "source": "google_shopping",
  "status": "done",
  "results": [
    {
      "shopping": [
        {
          "title": "wireless headphones",
          "link": "https://example.com/research",
          "snippet": "Search fixture",
          "position": 1,
          "productId": "product-1",
          "price": "$49.00",
          "source": "Example merchant"
        }
      ]
    }
  ],
  "created_at": "2026-10-12T00:00:00Z",
  "http_status": 200,
  "request_id": "fixture-request"
}

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

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

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

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

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