Communitygithub.com

ASoudy/AGS

Automatize tarefas do YouTube via Rube MCP (Composio): enviar vídeos, gerenciar playlists, pesquisar conteúdo, obter análises e gerenciar comentários.

O que é AGS?

Esta skill automatiza operações do YouTube por meio do kit de ferramentas YouTube da Composio, acessado via Rube MCP. Ela permite que um agente de IA execute tarefas como upload de vídeos, atualização de metadados, gerenciamento de playlists, pesquisa de conteúdo, obtenção de análises de canais e vídeos, e gerenciamento de inscrições e comentários. A skill é útil para desenvolvedores e usuários que desejam integrar automação do YouTube em seus fluxos de trabalho, economizando tempo e evitando tarefas manuais repetitivas. Ela funciona exigindo que o Rube MCP esteja conectado e que uma conexão ativa com o YouTube seja estabelecida por meio da ferramenta `RUBE_MANAGE_CONNECTIONS`. É crucial sempre pesquisar primeiro as ferramentas disponíveis com `RUBE_SEARCH_TOOLS` para obter os esquemas atuais, garantindo que os parâmetros corretos sejam usados. As principais funcionalidades incluem upload e gerenciamento de vídeos, pesquisa, gerenciamento de playlists, análises de canais e gerenciamento de comentários, com orientações sobre armadilhas comuns, gerenciamento de cota da API e formatação de IDs.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/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 kit de ferramentas YouTube da Composio via Rube MCP.

Pré-requisitos

  • O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
  • Conexão ativa com o YouTube via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas youtube
  • Sempre chame RUBE_SEARCH_TOOLS primeiro 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.

  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 concluir o OAuth do Google
  4. 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:

  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 100 caracteres)
  • description: Descrição do vídeo (máximo 5000 bytes)
  • tags: Array de tags de palavras-chave
  • categoryId: 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:

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

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

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

  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 inscrever/cancelar inscrição
  • videoId: ID do vídeo para threads 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
  • 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 pageToken na próxima solicitação
  • Continue até que nextPageToken esteja 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

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 lote de vídeosYOUTUBE_GET_VIDEO_DETAILS_BATCHid, parts
Listar playlistsYOUTUBE_LIST_USER_PLAYLISTSmaxResults, pageToken
Criar playlistYOUTUBE_CREATE_PLAYLIST(verificar esquema)
Adicionar à playlistYOUTUBE_ADD_VIDEO_TO_PLAYLIST(verificar esquema)
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 esquema)
Listar comentáriosYOUTUBE_LIST_COMMENT_THREADSvideoId
Atividades do canalYOUTUBE_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.

Individual skills in this repo

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

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Habilidades Relacionadas