Справочник MCP-инструментов
MCP-сервер Tube Search предоставляет 10 инструментов для поиска, чтения и анализа архивных данных YouTube.
search_channel
Поиск всех известных видео YouTube-канала в веб-архивах.
| Параметр | Тип | Обязат. | Описание |
|---|---|---|---|
query | string | Да | URL канала, @handle или Channel ID (UC...) |
Возвращает массив метаданных видео со статусами (LIVE, DELETED, CHECKING).
search_videos
Полнотекстовый поиск по названиям и описаниям архивных видео.
| Параметр | Тип | Обязат. | Описание |
|---|---|---|---|
query | string | Да | Поисковый запрос |
limit | number | Нет | Макс. результатов (по умолч.: 20, макс.: 100) |
status | string | Нет | Фильтр по статусу: live, deleted, all |
sort | string | Нет | relevance (по умолч.) или date-desc |
hasSubtitles | boolean | Нет | Только видео с субтитрами |
hasSummary | boolean | Нет | Только видео с AI-саммари |
get_video
Получить метаданные конкретного видео.
| Параметр | Тип | Обязат. | Описание |
|---|---|---|---|
videoId | string | Да | ID видео YouTube (11 символов) |
Возвращает: title, description, channelId, channelTitle, duration, uploadDate, viewCount, status, thumbnailUrl, subtitleStatus, hasSummary. Для видео, обогащённых через наш пайплайн происхождения данных Yandex.Video, ответ также содержит вложенный объект yandex с ключами internal_id, attribution, preview_url и scanned_at — см. подраздел «Происхождение обогащения через Yandex» ниже.
Происхождение обогащения через Yandex
Когда get_video возвращает вложенный объект yandex, поле yandex.attribution принимает одно из трёх значений уровня доверия. Используйте таблицу ниже, чтобы решить, можно ли цитировать факт о видео напрямую или требуется подтверждение из другого источника.
Уровень (значение yandex.attribution) | Рекомендованное действие | Обоснование |
|---|---|---|
db_match | Можно цитировать | YouTube ID уже присутствовал в нашей БД с привязкой к данному каналу; Yandex дополнил недостающие поля метаданных (title, duration, upload_date) через NULL-заполнение. Максимальная уверенность. |
yt_dlp_confirmed | Можно цитировать | YouTube ID впервые обнаружен через Yandex; yt-dlp независимо подтвердил привязку к каналу по живым метаданным YouTube. Подтверждение из двух независимых источников. |
name_unique_anchor_passed | Требуется подтверждение | YouTube ID впервые обнаружен через Yandex; yt-dlp не сработал или истёк таймаут; привязка основана на эвристиках уникальности имени и якорной верификации (не менее 2 из K совпадений названий LIVE-видео). Слабый сигнал — перед цитированием подтвердите фактом из другого источника. |
Когда yandex.preview_url не равен null, он указывает на короткий (~5 с) анимированный MP4-превью, зеркалированный из снапшота Yandex — полезен для визуального подтверждения того, как выглядело удалённое видео, но не эквивалентен исходному полному видеоконтенту. Когда preview_url равен null, поля метаданных (title, duration, uploadDate) и attribution остаются валидными; не сработало только зеркалирование превью.
get_subtitles
Получить полную транскрипцию видео в виде читаемого текста.
| Параметр | Тип | Обязат. | Описание |
|---|---|---|---|
videoId | string | Да | ID видео YouTube |
Возвращает транскрипцию без таймкодов, отформатированную в читаемые абзацы. Работает для живых и удалённых видео с архивными субтитрами.
get_summary
Получить AI-саммари видео.
| Параметр | Тип | Обязат. | Описание |
|---|---|---|---|
videoId | string | Да | ID видео YouTube |
Возвращает: tldr, keyPoints (с таймкодами), detailedSummary, tags, language. Если саммари нет — используйте generate_summary.
generate_summary
Сгенерировать AI-саммари для видео с субтитрами.
| Параметр | Тип | Обязат. | Описание |
|---|---|---|---|
videoId | string | Да | ID видео YouTube |
Запускает генерацию и ждёт завершения (до 60 сек). Возвращает существующее саммари, если оно уже есть. Расходует дневной лимит на генерацию саммари.
generate_stenogram
Сгенерировать приватную стенограмму (дословный диалог с разметкой спикеров) из транскрипта видео. Требуется L3+ (тариф MCP + API). Результат хранится в вашем пользовательском пространстве и виден только вам.
| Параметр | Тип | Обязат. | Описание |
|---|---|---|---|
videoId | string | Да | ID видео YouTube (11 символов) |
language | enum | Нет | auto (по умолч.), en, ru, es, de, pt |
Возвращает: { stenogram, metadata: { llmModel, tokensUsed, promptVersion, generatedAt, language, generationTimeMs } }. Требует готовый транскрипт (архивные или AI-субтитры). Отправляет notifications/progress, если клиент передал progress-токен. Расходует apiStenogramsPerDay (общий счётчик с REST-роутом).
browse_summaries
Просмотр существующих AI-саммари с фильтрами.
| Параметр | Тип | Обязат. | Описание |
|---|---|---|---|
tag | string | Нет | Фильтр по тегу (напр. "music", "education") |
channelId | string | Нет | Фильтр по каналу |
language | string | Нет | Фильтр по языку (напр. "en", "ru") |
page | number | Нет | Номер страницы (по умолч.: 1) |
limit | number | Нет | Результатов на страницу (по умолч.: 20) |
get_video_status_history
Просмотр истории изменений статуса видео.
| Параметр | Тип | Обязат. | Описание |
|---|---|---|---|
videoId | string | Да | ID видео YouTube |
Возвращает массив переходов статуса: [{ status, previousStatus, changedAt, source }], новейшие первыми.
get_usage
Проверить текущие счётчики использования API и оставшиеся лимиты.
Без параметров. Возвращает текущие счётчики и лимиты для поисков, FTS-запросов, скачиваний субтитров и генераций саммари.