Communitygithub.com

benjaminasterA/antigravity-awesome-skills

Automatize tarefas do YouTube via Rube MCP (Composio): upload de vídeos, gerenciar playlists, pesquisar conteúdo, obter análises e gerenciar comentários. Sempre pesquise ferramentas primeiro para schemas atuais.

O que é antigravity-awesome-skills?

Esta skill permite automatizar operações do YouTube utilizando o toolkit do YouTube disponível através do Rube MCP (Composio). Ela oferece workflows completos para upload e gerenciamento de vídeos, pesquisa de conteúdo, gerenciamento de playlists, obtenção de análises de canais e vídeos, além de gerenciar inscrições e comentários. A skill é útil tanto para criadores de conteúdo que desejam automatizar tarefas repetitivas quanto para desenvolvedores que precisam integrar funcionalidades do YouTube em seus aplicativos. Ela suporta as plataformas Rube MCP e requer uma conexão ativa com o YouTube via OAuth. O funcionamento se baseia na chamada de ferramentas específicas do YouTube, como `YOUTUBE_UPLOAD_VIDEO`, `YOUTUBE_SEARCH_YOU_TUBE` e `YOUTUBE_GET_CHANNEL_STATISTICS`, sempre obtendo os schemas mais recentes através de `RUBE_SEARCH_TOOLS` antes de executar qualquer ação.

Funciona com~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/benjaminasterA/antigravity-awesome-skills/tree/HEAD/skills/youtube-automation

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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_CONNECTIONS com toolkit youtube
  • Sempre chame RUBE_SEARCH_TOOLS primeiro 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.

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

  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 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:

  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, 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:

  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 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:

  1. YOUTUBE_GET_CHANNEL_ID_BY_HANDLE - Resolver um handle 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...'), handle ('@handle') ou 'me'
  • forHandle: Handle do canal (por exemplo, '@Google')
  • id: IDs de vídeo separados por vírgula para detalhes em lote
  • parts: 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 data ou data_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:

  1. YOUTUBE_SUBSCRIBE_CHANNEL - Inscrever-se em um canal [Opcional]
  2. YOUTUBE_UNSUBSCRIBE_CHANNEL - Cancelar inscrição em um canal [Opcional]
  3. YOUTUBE_LIST_USER_SUBSCRIPTIONS - Listar inscrições [Opcional]
  4. YOUTUBE_LIST_COMMENT_THREADS - Listar comentários em um vídeo [Opcional]

Parâmetros principais:

  • channelId: Canal para se inscrever/cancelar inscrição
  • videoId: ID do vídeo para tópicos de comentários
  • maxResults: Resultados por página
  • pageToken: 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 pageToken na próxima solicitação
  • Continue até que nextPageToken esteja 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

TarefaSlug da FerramentaParâmetros Principais
Enviar vídeoYOUTUBE_UPLOAD_VIDEOtitle, description, tags, categoryId, privacyStatus, videoFilePath
Atualizar vídeoYOUTUBE_UPDATE_VIDEOvideo_id, title, description, tags
Definir miniaturaYOUTUBE_UPDATE_THUMBNAILvideoId, thumbnailUrl
Pesquisar YouTubeYOUTUBE_SEARCH_YOU_TUBEq, type, maxResults
Detalhes do vídeoYOUTUBE_VIDEO_DETAILSid, part
Detalhes em loteYOUTUBE_GET_VIDEO_DETAILS_BATCHid, parts
Listar playlistsYOUTUBE_LIST_USER_PLAYLISTSmaxResults, pageToken
Criar playlistYOUTUBE_CREATE_PLAYLIST(verificar schema)
Adicionar à playlistYOUTUBE_ADD_VIDEO_TO_PLAYLIST(verificar schema)
Listar itens da playlistYOUTUBE_LIST_PLAYLIST_ITEMSplaylistId, maxResults
Estatísticas do canalYOUTUBE_GET_CHANNEL_STATISTICSid/forHandle/mine
Listar vídeos do canalYOUTUBE_LIST_CHANNEL_VIDEOSchannelId, maxResults
ID do canal por handleYOUTUBE_GET_CHANNEL_ID_BY_HANDLEchannel_handle
Inscrever-seYOUTUBE_SUBSCRIBE_CHANNELchannelId
Listar inscriçõesYOUTUBE_LIST_USER_SUBSCRIPTIONS(verificar schema)
Listar comentáriosYOUTUBE_LIST_COMMENT_THREADSvideoId
Atividades do canalYOUTUBE_GET_CHANNEL_ACTIVITIES(verificar schema)

Quando Usar

Esta skill é aplicável para executar o workflow ou as ações descritas na visão geral.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas