Automação do YouTube via Rube MCP
Automatize operações do YouTube através do toolkit do YouTube da Composio via Rube MCP.
Pré-requisitos
- Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
- Conexão ativa com o YouTube via
RUBE_MANAGE_CONNECTIONScom toolkityoutube - Sempre chame
RUBE_SEARCH_TOOLSprimeiro para obter os schemas atuais das ferramentas
Configuração
Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.
- Verifique se o Rube MCP está disponível confirmando que
RUBE_SEARCH_TOOLSresponde - Chame
RUBE_MANAGE_CONNECTIONScom toolkityoutube - Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Google
- Confirme que o status da conexão mostra ATIVO antes de executar qualquer workflow
Workflows Principais
1. Enviar e Gerenciar Vídeos
Quando usar: O usuário deseja enviar um vídeo ou atualizar metadados de vídeo
Sequência de ferramentas:
YOUTUBE_UPLOAD_VIDEO- Enviar um novo vídeo [Obrigatório]YOUTUBE_UPDATE_VIDEO- Atualizar título, descrição, tags, privacidade [Opcional]YOUTUBE_UPDATE_THUMBNAIL- Definir uma miniatura personalizada [Opcional]
Parâmetros principais:
title: Título do vídeo (máximo de 100 caracteres)description: Descrição do vídeo (máximo de 5000 bytes)tags: Array de tags de palavras-chavecategoryId: ID da categoria do YouTube (por exemplo, '22' para Pessoas e Blogs)privacyStatus: 'public', 'private' ou 'unlisted'videoFilePath: Objeto com{name, mimetype, s3key}para o arquivo de vídeo
Armadilhas:
- UPLOAD_VIDEO consome alta cota; prefira UPDATE_VIDEO para alterações apenas de metadados
- videoFilePath deve ser um objeto com s3key, não um caminho de arquivo bruto ou URL
- O total de tags não deve exceder 500 caracteres incluindo separadores
- Os colchetes angulares
< >nas tags são automaticamente removidos - O limite da descrição é de 5000 bytes, não caracteres (caracteres multibyte contam mais)
2. Pesquisar Conteúdo do YouTube
Quando usar: O usuário deseja encontrar vídeos, canais ou playlists
Sequência de ferramentas:
YOUTUBE_SEARCH_YOU_TUBE- Pesquisar conteúdo [Obrigatório]YOUTUBE_VIDEO_DETAILS- Obter detalhes completos de um vídeo específico [Opcional]YOUTUBE_GET_VIDEO_DETAILS_BATCH- Obter detalhes de vários vídeos [Opcional]
Parâmetros principais:
q: Consulta de pesquisa (suporta frases exatas, exclusões, handles de canais)type: 'video', 'channel' ou 'playlist'maxResults: Resultados por página (1-50)pageToken: Para paginação
Armadilhas:
- O endpoint de pesquisa retorna apenas a parte 'snippet'; use VIDEO_DETAILS para estatísticas
- Os resultados da pesquisa são limitados a 500 itens no total
- A pesquisa tem um custo de cota mais alto (100 unidades) em comparação com endpoints de lista (1 unidade)
- O limite prático de detalhes de vídeo em lote é de aproximadamente 50 IDs por chamada; divida conjuntos maiores
3. Gerenciar Playlists
Quando usar: O usuário deseja criar playlists ou gerenciar o conteúdo de playlists
Sequência de ferramentas:
YOUTUBE_LIST_USER_PLAYLISTS- Listar playlists existentes do usuário [Opcional]YOUTUBE_CREATE_PLAYLIST- Criar uma nova playlist [Opcional]YOUTUBE_ADD_VIDEO_TO_PLAYLIST- Adicionar um vídeo a uma playlist [Opcional]YOUTUBE_LIST_PLAYLIST_ITEMS- Listar vídeos em uma playlist [Opcional]
Parâmetros principais:
playlistId: ID da playlist ('PL...' para criada pelo usuário, 'UU...' para uploads)part: Partes do recurso a incluir (por exemplo, 'snippet,contentDetails')maxResults: Itens por página (1-50)pageToken: Token de paginação da resposta anterior
Armadilhas:
- NÃO passe IDs de canal ('UC...') como IDs de playlist; converta 'UC' para 'UU' para uploads
- Playlists grandes exigem paginação via pageToken; siga nextPageToken até que esteja ausente
- items[].id não é o videoId; use items[].snippet.resourceId.videoId
- Nomes de playlist duplicados são permitidos; verifique as playlists existentes primeiro
4. Obter Análises de Canal e Vídeo
Quando usar: O usuário deseja analisar o desempenho do canal ou métricas de vídeo
Sequência de ferramentas:
YOUTUBE_GET_CHANNEL_ID_BY_HANDLE- Resolver um handle para ID de canal [Pré-requisito]YOUTUBE_GET_CHANNEL_STATISTICS- Obter contagens de inscritos/visualizações/vídeos do canal [Obrigatório]YOUTUBE_LIST_CHANNEL_VIDEOS- Listar todos os vídeos de um canal [Opcional]YOUTUBE_GET_VIDEO_DETAILS_BATCH- Obter estatísticas por vídeo [Opcional]YOUTUBE_GET_CHANNEL_ACTIVITIES- Obter atividades recentes do canal [Opcional]
Parâmetros principais:
channelId: ID do canal ('UC...'), handle ('@handle') ou 'me'forHandle: Handle do canal (por exemplo, '@Google')id: IDs de vídeo separados por vírgula para detalhes em loteparts: Partes do recurso a incluir (por exemplo, 'snippet,statistics')
Armadilhas:
- As estatísticas do canal são totais vitalícios, não por período
- Detalhes de vídeo em lote podem retornar menos itens do que o solicitado para vídeos privados/excluídos
- Os dados de resposta podem estar aninhados em
dataoudata_preview; analise defensivamente - contentDetails.duration usa o formato ISO 8601 (por exemplo, 'PT4M13S')
5. Gerenciar Inscrições e Comentários
Quando usar: O usuário deseja inscrever-se em canais ou visualizar comentários de vídeos
Sequência de ferramentas:
YOUTUBE_SUBSCRIBE_CHANNEL- Inscrever-se em um canal [Opcional]YOUTUBE_UNSUBSCRIBE_CHANNEL- Cancelar inscrição em um canal [Opcional]YOUTUBE_LIST_USER_SUBSCRIPTIONS- Listar inscrições [Opcional]YOUTUBE_LIST_COMMENT_THREADS- Listar comentários em um vídeo [Opcional]
Parâmetros principais:
channelId: Canal para se inscrever/cancelar inscriçãovideoId: ID do vídeo para tópicos de comentáriosmaxResults: Resultados por páginapageToken: Token de paginação
Armadilhas:
- Inscrever-se em um canal já inscrito pode retornar um erro
- Tópicos de comentários retornam comentários de nível superior com até 5 respostas cada
- Os comentários podem estar desabilitados em alguns vídeos
- Cancelar inscrição requer o ID da inscrição, não o ID do canal
Padrões Comuns
Resolução de ID de Canal
Handle para ID de Canal:
1. Chame YOUTUBE_GET_CHANNEL_ID_BY_HANDLE com '@handle'
2. Extraia channelId da resposta
3. Use em operações subsequentes do canal
Playlist de Uploads:
1. Obtenha o ID do canal (começa com 'UC')
2. Substitua o prefixo 'UC' por 'UU' para obter o ID da playlist de uploads
3. Use com LIST_PLAYLIST_ITEMS para enumerar todos os vídeos
Paginação
- Defina
maxResults(máx. 50 por página) - Verifique a resposta por
nextPageToken - Passe o token como
pageTokenna próxima solicitação - Continue até que
nextPageTokenesteja ausente
Detalhes de Vídeo em Lote
- Colete IDs de vídeo de pesquisa ou listagens de playlists
- Divida em grupos de aproximadamente 50 IDs
- Chame GET_VIDEO_DETAILS_BATCH por grupo
- Mescle os resultados entre os grupos
Armadilhas Conhecidas
Gerenciamento de Cota:
- A API do YouTube tem um limite de cota diário (padrão de 10.000 unidades)
- Upload = 1600 unidades; pesquisa = 100 unidades; lista = 1 unidade
- Prefira endpoints de lista em vez de pesquisa quando possível
- Monitore o uso da cota para evitar atingir os limites diários
Formatos de ID:
- IDs de vídeo: strings alfanuméricas de 11 caracteres
- IDs de canal: começam com 'UC' seguido de 22 caracteres
- IDs de playlist: começam com 'PL' (usuário) ou 'UU' (uploads)
- Não confunda IDs de canal com IDs de playlist
Miniaturas:
- Miniaturas personalizadas exigem verificação telefônica do canal
- Devem ser JPG, PNG ou GIF; abaixo de 2MB
- Recomendado: resolução 1280x720 (proporção 16:9)
Análise de Respostas:
- Os valores de estatísticas são retornados como strings, não inteiros; converta antes de fazer cálculos
- A duração usa o formato ISO 8601 (PT#H#M#S)
- Respostas em lote podem agrupar dados sob chaves diferentes
Referência Rápida
| Tarefa | Slug da Ferramenta | Parâmetros Principais |
|---|---|---|
| Enviar vídeo | YOUTUBE_UPLOAD_VIDEO | title, description, tags, categoryId, privacyStatus, videoFilePath |
| Atualizar vídeo | YOUTUBE_UPDATE_VIDEO | video_id, title, description, tags |
| Definir miniatura | YOUTUBE_UPDATE_THUMBNAIL | videoId, thumbnailUrl |
| Pesquisar YouTube | YOUTUBE_SEARCH_YOU_TUBE | q, type, maxResults |
| Detalhes do vídeo | YOUTUBE_VIDEO_DETAILS | id, part |
| Detalhes em lote | YOUTUBE_GET_VIDEO_DETAILS_BATCH | id, parts |
| Listar playlists | YOUTUBE_LIST_USER_PLAYLISTS | maxResults, pageToken |
| Criar playlist | YOUTUBE_CREATE_PLAYLIST | (verificar schema) |
| Adicionar à playlist | YOUTUBE_ADD_VIDEO_TO_PLAYLIST | (verificar schema) |
| Listar itens da playlist | YOUTUBE_LIST_PLAYLIST_ITEMS | playlistId, maxResults |
| Estatísticas do canal | YOUTUBE_GET_CHANNEL_STATISTICS | id/forHandle/mine |
| Listar vídeos do canal | YOUTUBE_LIST_CHANNEL_VIDEOS | channelId, maxResults |
| ID do canal por handle | YOUTUBE_GET_CHANNEL_ID_BY_HANDLE | channel_handle |
| Inscrever-se | YOUTUBE_SUBSCRIBE_CHANNEL | channelId |
| Listar inscrições | YOUTUBE_LIST_USER_SUBSCRIPTIONS | (verificar schema) |
| Listar comentários | YOUTUBE_LIST_COMMENT_THREADS | videoId |
| Atividades do canal | YOUTUBE_GET_CHANNEL_ACTIVITIES | (verificar schema) |
Quando Usar
Esta skill é aplicável para executar o workflow ou as ações descritas na visão geral.