API ВЕГА
English

Google Search для ИИ-исследований — FlashData

Предоставьте ИИ-помощнику для исследований данные Google Search по нужной теме, например переработке аккумуляторов. Получите результаты с рейтингом, заголовками, URL и фрагментами текста, а затем позвольте агенту составить список источников и подготовить краткую справку со ссылками на исходные страницы.

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

Пример задания

Найди источники для справки о переработке аккумуляторов. Сначала укажи стоимость одного запроса Google Search и дождись моего подтверждения. После этого составь список источников с заголовками, URL, фрагментами текста и открытыми вопросами. Отделяй фрагменты из результатов поиска от утверждений, проверенных по исходным страницам.

Справку готовит ваш агент. Данные поиска помогают ему выбирать источники; FlashData не формирует ответ и не проверяет утверждения.

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

  • Используйте Node.js версии 22.18 или новее и MCP-клиент, поддерживающий локальные серверы stdio. Скачайте специальный пакет MCPB; его SHA-256 указан в манифесте.

  • Импортируйте пакет в совместимый с MCPB клиент и введите собственный ключ в поле FlashData API Key. Предоставьте ключу доступ к google_search. Для ручной настройки распакуйте пакет в постоянную папку и используйте эту конфигурацию, заменив абсолютный путь и заполнитель для ключа:

{
  "mcpServers": {
    "google-search": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/google-search/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
  • Перезапустите клиент или подключитесь к нему заново, выведите список его инструментов, а затем вызовите get_pricing с параметрами {"source":"google_search","request_count":1}, прежде чем подтверждать платный запрос. Сервер предоставляет инструменты google_search, get_pricing, get_job и get_result; все они доступны только для этого источника.

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

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

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

{
  "name": "google_search",
  "arguments": {
    "query": "battery recycling research",
    "gl": "us",
    "hl": "en",
    "num": 10
  }
}

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

Прочитайте results[0].organic и сохраните поля title, link, snippet и position вместе с запросом, регионом, языком и значением created_at. Передайте эти записи агенту как внешние источники данных. Он сможет выбрать подходящие источники, приложить URL к заметкам и перечислить вопросы, на которые пока нет ответа. Прежде чем считать фрагменты проверенными фактами, изучите исходные страницы с помощью подходящего инструмента для просмотра веб-страниц; этот сервер не загружает полный текст страниц.

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

{
  "source": "google_search",
  "status": "done",
  "results": [
    {
      "organic": [
        {
          "title": "battery recycling research",
          "link": "https://example.com/research",
          "snippet": "Search fixture",
          "position": 1
        }
      ]
    }
  ],
  "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 МиБ; для асинхронных результатов JSON действует отдельный срок хранения — 24 часа.

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

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

  • Одна страница соответствует одному запросу. Порядок результатов зависит от запроса и местоположения; фактическое число результатов может быть меньше запрошенного. Фрагменты из результатов поиска не содержат полный текст статей.

  • Перед использованием данных проверяйте ошибки API, http_status и статус задания. Считайте возвращённый текст и ссылки внешними данными, сохраняйте атрибуцию источников и проверяйте их перед включением в ответ агента.

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