Automação do YouTube via Rube MCP

Automatize operações do YouTube através do kit de ferramentas do YouTube da Composio via Rube MCP.

Pré-requisitos

• Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa do YouTube via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas youtube
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obtenha o 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.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o kit de ferramentas youtube
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o Google OAuth
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos 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:

1. YOUTUBE_UPLOAD_VIDEO - Enviar um novo vídeo [Obrigatório]
2. YOUTUBE_UPDATE_VIDEO - Atualizar título, descrição, tags, privacidade [Opcional]
3. 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-chave
• categoryId: 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 muita 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
• Ângulos < > em 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:

1. YOUTUBE_SEARCH_YOU_TUBE - Pesquisar conteúdo [Obrigatório]
2. YOUTUBE_VIDEO_DETAILS - Obter detalhes completos de um vídeo específico [Opcional]
3. 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, identificadores de canal)
• 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 totais
• A pesquisa tem um custo de cota maior (100 unidades) em comparação com os 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:

1. YOUTUBE_LIST_USER_PLAYLISTS - Listar playlists existentes do usuário [Opcional]
2. YOUTUBE_CREATE_PLAYLIST - Criar uma nova playlist [Opcional]
3. YOUTUBE_ADD_VIDEO_TO_PLAYLIST - Adicionar um vídeo a uma playlist [Opcional]
4. YOUTUBE_LIST_PLAYLIST_ITEMS - Listar vídeos em uma playlist [Opcional]

Parâmetros principais:

• playlistId: ID da playlist ('PL...' para criadas pelo usuário, 'UU...' para envios)
• part: Partes de recursos a serem incluídas (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 envios
• Playlists grandes exigem paginação via pageToken; siga nextPageToken até que ele esteja ausente
• items[].id não é o videoId; use items[].snippet.resourceId.videoId
• A criação de nomes de playlist duplicados é permitida; 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:

1. YOUTUBE_GET_CHANNEL_ID_BY_HANDLE - Resolver um identificador para ID de canal [Pré-requisito]
2. YOUTUBE_GET_CHANNEL_STATISTICS - Obter contagens de inscritos/visualizações/vídeos do canal [Obrigatório]
3. YOUTUBE_LIST_CHANNEL_VIDEOS - Listar todos os vídeos de um canal [Opcional]
4. YOUTUBE_GET_VIDEO_DETAILS_BATCH - Obter estatísticas por vídeo [Opcional]
5. YOUTUBE_GET_CHANNEL_ACTIVITIES - Obter atividades recentes do canal [Opcional]

Parâmetros principais:

• channelId: ID do canal ('UC...'), identificador ('@handle') ou 'me'
• forHandle: Identificador do canal (por exemplo, '@Google')
• id: IDs de vídeo separados por vírgula para detalhes em lote
• parts: Partes de recursos a serem incluídas (por exemplo, 'snippet,statistics')

…