Automação do YouTube via Rube MCP
Automatize operações do YouTube através do kit de ferramentas YouTube da Composio via Rube MCP.
Pré-requisitos
- O Rube MCP deve estar conectado (
RUBE_SEARCH_TOOLSdisponível) - Conexão ativa com o YouTube via
RUBE_MANAGE_CONNECTIONScom o kit de ferramentasyoutube - Sempre chame
RUBE_SEARCH_TOOLSprimeiro para obter os esquemas 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 o kit de ferramentasyoutube - Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir o OAuth do Google
- Confirme se o status da conexão mostra ATIVO antes de executar qualquer fluxo de trabalho
Fluxos de Trabalho 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 100 caracteres)description: Descrição do vídeo (máximo 5000 bytes)tags: Array de tags de palavras-chavecategoryId: ID da categoria do YouTube (ex.: '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 removidos automaticamente - O limite de 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 têm um limite de 500 itens no total
- A pesquisa tem um custo de cota maior (100 unidades) em comparação com endpoints de lista (1 unidade)
- O limite prático de detalhes em lote de vídeos é de ~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 (ex.: '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
- Criar nomes de playlist duplicados é permitido; 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 do 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 (ex.: '@Google')id: IDs de vídeo separados por vírgula para detalhes em loteparts: Partes do recurso a incluir (ex.: 'snippet,statistics')
Armadilhas:
- As estatísticas do canal são totais vitalícios, não por período
- Os detalhes em lote de vídeos podem retornar menos itens do que o solicitado para vídeos privados/excluídos
- Os dados de resposta podem estar aninhados sob
dataoudata_preview; analise defensivamente - contentDetails.duration usa o formato ISO 8601 (ex.: 'PT4M13S')
5. Gerenciar Inscrições e Comentários
Quando usar: O usuário deseja se inscrever 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 inscrever/cancelar inscriçãovideoId: ID do vídeo para threads de comentáriosmaxResults: Resultados por páginapageToken: Token de paginação
Armadilhas:
- Inscrever-se em um canal já inscrito pode retornar um erro
- As threads 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 do Canal
Handle para ID do 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 em busca de
nextPageToken - Passe o token como
pageTokenna próxima solicitação - Continue até que
nextPageTokenesteja ausente
Detalhes em Lote de Vídeos
- Colete IDs de vídeo de pesquisas ou listagens de playlist
- Divida em grupos de ~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ária (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 2 MB
- Recomendado: resolução 1280x720 (proporção 16:9)
Análise de Resposta:
- Os valores das estatísticas são retornados como strings, não inteiros; converta antes de fazer cálculos
- Duração usa o formato ISO 8601 (PT#H#M#S)
- As 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 de vídeos | YOUTUBE_GET_VIDEO_DETAILS_BATCH | id, parts |
| Listar playlists | YOUTUBE_LIST_USER_PLAYLISTS | maxResults, pageToken |
| Criar playlist | YOUTUBE_CREATE_PLAYLIST | (verificar esquema) |
| Adicionar à playlist | YOUTUBE_ADD_VIDEO_TO_PLAYLIST | (verificar esquema) |
| 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 esquema) |
| Listar comentários | YOUTUBE_LIST_COMMENT_THREADS | videoId |
| Atividades do canal | YOUTUBE_GET_CHANNEL_ACTIVITIES | (verificar esquema) |
Quando Usar
Esta skill é aplicável para executar o fluxo de trabalho ou ações descritas na visão geral.
Limitações
- Use esta skill apenas quando a tarefa corresponder claramente ao escopo descrito acima.
- Não trate a saída como um substituto para validação específica do ambiente, teste ou revisão de especialista.
- Pare e peça esclarecimentos se as entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.