Referência de ferramentas MCP
O servidor MCP do Tube Search fornece 9 ferramentas para pesquisar, ler e analisar dados arquivados do YouTube.
search_channel
Encontre todos os vídeos conhecidos de um canal do YouTube pesquisando em arquivos web.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query | string | Sim | URL do canal, @handle ou Channel ID (ex.: UC...) |
Retorna um array de metadados de vídeo incluindo status (LIVE, DELETED, CHECKING).
search_videos
Pesquisa de texto completo em títulos e descrições de vídeos arquivados.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query | string | Sim | Consulta de pesquisa (suporta linguagem natural) |
limit | number | Não | Máx. resultados (padrão: 20, máx.: 100) |
status | string | Não | Filtrar por status: live, deleted, all |
sort | string | Não | relevance (padrão) ou date-desc |
hasSubtitles | boolean | Não | Apenas vídeos com legendas |
hasSummary | boolean | Não | Apenas vídeos com resumos IA |
get_video
Obter metadados de um vídeo específico.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
videoId | string | Sim | ID do vídeo do YouTube (11 caracteres) |
Retorna: title, description, channelId, channelTitle, duration, uploadDate, viewCount, status, thumbnailUrl, subtitleStatus, hasSummary.
get_subtitles
Obter a transcrição completa de um vídeo como texto legível.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
videoId | string | Sim | ID do vídeo do YouTube |
Retorna a transcrição sem marcações de tempo, formatada em parágrafos legíveis. Funciona para vídeos ativos e excluídos que possuam legendas arquivadas.
get_summary
Obter o resumo gerado por IA de um vídeo.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
videoId | string | Sim | ID do vídeo do YouTube |
Retorna: tldr, keyPoints (com marcações de tempo), detailedSummary, tags, language. Retorna um erro se não existir resumo — use generate_summary para criar um.
generate_summary
Gerar um resumo IA para um vídeo que tenha legendas.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
videoId | string | Sim | ID do vídeo do YouTube |
Inicia a geração e aguarda a conclusão (até 60 s). Retorna o resumo se o vídeo já tiver um. Conta para seu limite diário de geração de resumos.
browse_summaries
Explorar resumos IA existentes com filtros opcionais.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
tag | string | Não | Filtrar por tag (ex.: "music", "education") |
channelId | string | Não | Filtrar por canal |
language | string | Não | Filtrar por idioma (ex.: "en", "pt") |
page | number | Não | Número da página (padrão: 1) |
limit | number | Não | Resultados por página (padrão: 20) |
get_video_status_history
Visualizar o histórico de alterações de status de um vídeo.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
videoId | string | Sim | ID do vídeo do YouTube |
Retorna um array de transições de status: [{ status, previousStatus, changedAt, source }], mais recentes primeiro.
get_usage
Verificar os contadores atuais de uso da API e os limites restantes.
Sem parâmetros. Retorna os contadores e limites atuais para pesquisas, consultas FTS, downloads de legendas e gerações de resumos.