API ВЕГА
English

Google Video Search — FlashData

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

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

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

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

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

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

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

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

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

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

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

{
  "name": "google_videos",
  "arguments": {
    "query": "battery recycling process",
    "num": 10
  }
}

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

Изучите results[0].videos. Сгруппируйте результаты по имени хоста в каждой ссылке, сохранив название, длительность, источник и исходный URL, чтобы составить каталог источников.

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

{
  "source": "google_videos",
  "status": "done",
  "results": [
    {
      "videos": [
        {
          "title": "battery recycling process",
          "link": "https://example.com/research",
          "snippet": "Search fixture",
          "position": 1,
          "source": "Example",
          "duration": "01:30"
        }
      ]
    }
  ],
  "created_at": "2026-10-12T00:00:00Z",
  "http_status": 200,
  "request_id": "fixture-request"
}

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

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

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

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

  • Это поиск видео Google, а не YouTube Search. В результатах содержатся метаданные поиска, а не медиафайлы.

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

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