Referencia de herramientas MCP
El servidor MCP de Tube Search proporciona 9 herramientas para buscar, leer y analizar datos archivados de YouTube.
search_channel
Encuentra todos los vídeos conocidos de un canal de YouTube buscando en archivos web.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
query | string | Sí | URL del canal, @handle o Channel ID (p. ej., UC...) |
Devuelve un array de metadatos de vídeo incluyendo estado (LIVE, DELETED, CHECKING).
search_videos
Búsqueda de texto completo en títulos y descripciones de vídeos archivados.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
query | string | Sí | Consulta de búsqueda (admite lenguaje natural) |
limit | number | No | Máx. resultados (predeterminado: 20, máx.: 100) |
status | string | No | Filtrar por estado: live, deleted, all |
sort | string | No | relevance (predeterminado) o date-desc |
hasSubtitles | boolean | No | Solo vídeos con subtítulos |
hasSummary | boolean | No | Solo vídeos con resúmenes IA |
get_video
Obtener metadatos de un vídeo específico.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
videoId | string | Sí | ID del vídeo de YouTube (11 caracteres) |
Devuelve: title, description, channelId, channelTitle, duration, uploadDate, viewCount, status, thumbnailUrl, subtitleStatus, hasSummary.
get_subtitles
Obtener la transcripción completa de un vídeo como texto legible.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
videoId | string | Sí | ID del vídeo de YouTube |
Devuelve la transcripción sin marcas de tiempo, formateada en párrafos legibles. Funciona tanto para vídeos activos como eliminados que tengan subtítulos archivados.
get_summary
Obtener el resumen generado por IA de un vídeo.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
videoId | string | Sí | ID del vídeo de YouTube |
Devuelve: tldr, keyPoints (con marcas de tiempo), detailedSummary, tags, language. Devuelve un error si no existe resumen — usa generate_summary para crear uno.
generate_summary
Generar un resumen IA para un vídeo que tenga subtítulos.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
videoId | string | Sí | ID del vídeo de YouTube |
Inicia la generación y espera hasta completarse (hasta 60 s). Devuelve el resumen si el vídeo ya tiene uno. Cuenta para tu límite diario de generación de resúmenes.
browse_summaries
Explorar resúmenes IA existentes con filtros opcionales.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
tag | string | No | Filtrar por etiqueta (p. ej., "music", "education") |
channelId | string | No | Filtrar por canal |
language | string | No | Filtrar por idioma (p. ej., "en", "es") |
page | number | No | Número de página (predeterminado: 1) |
limit | number | No | Resultados por página (predeterminado: 20) |
get_video_status_history
Ver el historial de cambios de estado de un vídeo.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
videoId | string | Sí | ID del vídeo de YouTube |
Devuelve un array de transiciones de estado: [{ status, previousStatus, changedAt, source }], las más recientes primero.
get_usage
Consultar los contadores actuales de uso de la API y los límites restantes.
Sin parámetros. Devuelve los contadores y límites actuales para búsquedas, consultas FTS, descargas de subtítulos y generaciones de resúmenes.