Справочник MCP-инструментов
MCP-сервер Tube Search предоставляет 9 инструментов для поиска, чтения и анализа архивных данных 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.
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 сек). Возвращает существующее саммари, если оно уже есть. Расходует дневной лимит на генерацию саммари.
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-запросов, скачиваний субтитров и генераций саммари.