Communitygithub.com

YouTube 자동화 (Rube MCP 기반)

Rube MCP (Composio)를 통해 YouTube 작업을 자동화합니다: 동영상 업로드, 재생목록 관리, 콘텐츠 검색, 분석, 댓글 처리. 항상 먼저 도구를 검색하여 최신 스키마를 확인하세요.

YouTube 자동화 (Rube MCP 기반)란 무엇인가요?

이 스킬은 Rube MCP를 통해 Composio의 YouTube 툴킷에 접근하여 YouTube 작업을 자동화하는 방법을 제공합니다. 개발자는 동영상 업로드 및 메타데이터 업데이트, 재생목록 생성 및 관리, 콘텐츠 검색, 채널 및 동영상 통계 조회, 구독 및 댓글 관리 기능을 사용할 수 있습니다. 주요 주의사항으로는 YouTube API 할당량 관리 (업로드는 1600, 검색은 100, 목록 조회는 1 단위 소모), 다양한 ID 형식 (동영상: 11자, 채널: UC+22자, 재생목록: PL/UU), 동영상 파일 경로는 반드시 s3key를 포함한 객체여야 하는 점, ISO 8601 기간 형식 등이 포함됩니다. 모든 작업 전에 RUBE_SEARCH_TOOLS를 호출하여 최신 도구 스키마를 확인하는 것이 권장됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Desesbraker/agentes-vip/tree/HEAD/full%20skill/plugins/antigravity-awesome-skills-claude/skills/youtube-automation

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Rube MCP를 통한 YouTube 자동화

Composio의 YouTube 툴킷을 Rube MCP를 통해 자동화합니다.

필수 조건

  • Rube MCP가 연결되어 있어야 합니다 (RUBE_SEARCH_TOOLS 사용 가능)
  • RUBE_MANAGE_CONNECTIONS를 통해 youtube 툴킷으로 활성 YouTube 연결 필요
  • 항상 먼저 RUBE_SEARCH_TOOLS를 호출하여 현재 도구 스키마를 확인하세요

설정

Rube MCP 가져오기: 클라이언트 설정에 MCP 서버로 https://rube.app/mcp를 추가하세요. API 키가 필요하지 않습니다. 엔드포인트만 추가하면 작동합니다.

  1. RUBE_SEARCH_TOOLS가 응답하는지 확인하여 Rube MCP가 사용 가능한지 확인합니다.
  2. RUBE_MANAGE_CONNECTIONS를 youtube 툴킷으로 호출합니다.
  3. 연결이 ACTIVE 상태가 아니면, 반환된 인증 링크를 따라 Google OAuth를 완료합니다.
  4. 워크플로우를 실행하기 전에 연결 상태가 ACTIVE인지 확인합니다.

핵심 워크플로우

1. 동영상 업로드 및 관리

사용 시기: 사용자가 동영상을 업로드하거나 동영상 메타데이터를 업데이트하려는 경우

도구 순서:

  1. YOUTUBE_UPLOAD_VIDEO - 새 동영상 업로드 [필수]
  2. YOUTUBE_UPDATE_VIDEO - 제목, 설명, 태그, 공개 범위 업데이트 [선택]
  3. YOUTUBE_UPDATE_THUMBNAIL - 맞춤 썸네일 설정 [선택]

주요 매개변수:

  • title: 동영상 제목 (최대 100자)
  • description: 동영상 설명 (최대 5000바이트)
  • tags: 키워드 태그 배열
  • categoryId: YouTube 카테고리 ID (예: '22'는 사람과 블로그)
  • privacyStatus: 'public', 'private', 또는 'unlisted'
  • videoFilePath: 동영상 파일을 위한 {name, mimetype, s3key} 객체

주의사항:

  • UPLOAD_VIDEO는 높은 할당량을 소모합니다. 메타데이터만 변경하는 경우 UPDATE_VIDEO를 선호하세요.
  • videoFilePath는 s3key를 포함한 객체여야 하며, 원시 파일 경로나 URL이 아니어야 합니다.
  • 태그 총 길이는 구분자를 포함하여 500자를 초과할 수 없습니다.
  • 태그의 꺾쇠괄호 < >는 자동으로 제거됩니다.
  • 설명 제한은 5000바이트이며, 문자 수가 아닙니다 (멀티바이트 문자는 더 많이 차지합니다).

2. YouTube 콘텐츠 검색

사용 시기: 사용자가 동영상, 채널 또는 재생목록을 찾으려는 경우

도구 순서:

  1. YOUTUBE_SEARCH_YOU_TUBE - 콘텐츠 검색 [필수]
  2. YOUTUBE_VIDEO_DETAILS - 특정 동영상의 전체 세부정보 가져오기 [선택]
  3. YOUTUBE_GET_VIDEO_DETAILS_BATCH - 여러 동영상의 세부정보 가져오기 [선택]

주요 매개변수:

  • q: 검색어 (정확한 구문, 제외어, 채널 핸들 지원)
  • type: 'video', 'channel', 또는 'playlist'
  • maxResults: 페이지당 결과 수 (1-50)
  • pageToken: 페이지 매김용

주의사항:

  • 검색 엔드포인트는 'snippet' 부분만 반환합니다. 통계는 VIDEO_DETAILS를 사용하세요.
  • 검색 결과는 총 500개 항목으로 제한됩니다.
  • 검색은 목록 엔드포인트(1 단위)보다 높은 할당량(100 단위)을 소모합니다.
  • BATCH 동영상 세부정보는 호출당 약 50개 ID로 제한됩니다. 더 큰 집합은 분할하세요.

3. 재생목록 관리

사용 시기: 사용자가 재생목록을 생성하거나 재생목록 콘텐츠를 관리하려는 경우

도구 순서:

  1. YOUTUBE_LIST_USER_PLAYLISTS - 사용자의 기존 재생목록 나열 [선택]
  2. YOUTUBE_CREATE_PLAYLIST - 새 재생목록 생성 [선택]
  3. YOUTUBE_ADD_VIDEO_TO_PLAYLIST - 동영상을 재생목록에 추가 [선택]
  4. YOUTUBE_LIST_PLAYLIST_ITEMS - 재생목록의 동영상 나열 [선택]

주요 매개변수:

  • playlistId: 재생목록 ID ('PL...'은 사용자 생성, 'UU...'는 업로드)
  • part: 포함할 리소스 부분 (예: 'snippet,contentDetails')
  • maxResults: 페이지당 항목 수 (1-50)
  • pageToken: 이전 응답의 페이지 매김 토큰

주의사항:

  • 채널 ID('UC...')를 재생목록 ID로 전달하지 마세요. 업로드의 경우 'UC'를 'UU'로 변환하세요.
  • 큰 재생목록은 pageToken을 통한 페이지 매김이 필요합니다. nextPageToken이 없을 때까지 따르세요.
  • items[].id는 videoId가 아닙니다. items[].snippet.resourceId.videoId를 사용하세요.
  • 중복 재생목록 이름 생성이 허용됩니다. 먼저 기존 재생목록을 확인하세요.

4. 채널 및 동영상 분석

사용 시기: 사용자가 채널 성능이나 동영상 메트릭을 분석하려는 경우

도구 순서:

  1. YOUTUBE_GET_CHANNEL_ID_BY_HANDLE - 핸들을 채널 ID로 변환 [전제 조건]
  2. YOUTUBE_GET_CHANNEL_STATISTICS - 채널 구독자/조회수/동영상 수 가져오기 [필수]
  3. YOUTUBE_LIST_CHANNEL_VIDEOS - 채널의 모든 동영상 나열 [선택]
  4. YOUTUBE_GET_VIDEO_DETAILS_BATCH - 동영상별 통계 가져오기 [선택]
  5. YOUTUBE_GET_CHANNEL_ACTIVITIES - 최근 채널 활동 가져오기 [선택]

주요 매개변수:

  • channelId: 채널 ID ('UC...'), 핸들 ('@handle'), 또는 'me'
  • forHandle: 채널 핸들 (예: '@Google')
  • id: 일괄 세부정보를 위한 쉼표로 구분된 동영상 ID
  • parts: 포함할 리소스 부분 (예: 'snippet,statistics')

주의사항:

  • 채널 통계는 전체 기간 누적이며, 특정 기간별이 아닙니다.
  • BATCH 동영상 세부정보는 비공개/삭제된 동영상의 경우 요청보다 적은 항목을 반환할 수 있습니다.
  • 응답 데이터는 data 또는 data_preview 아래에 중첩될 수 있습니다. 방어적으로 파싱하세요.
  • contentDetails.duration은 ISO 8601 형식을 사용합니다 (예: 'PT4M13S').

5. 구독 및 댓글 관리

사용 시기: 사용자가 채널을 구독하거나 동영상 댓글을 보려는 경우

도구 순서:

  1. YOUTUBE_SUBSCRIBE_CHANNEL - 채널 구독 [선택]
  2. YOUTUBE_UNSUBSCRIBE_CHANNEL - 채널 구독 취소 [선택]
  3. YOUTUBE_LIST_USER_SUBSCRIPTIONS - 구독 목록 나열 [선택]
  4. YOUTUBE_LIST_COMMENT_THREADS - 동영상의 댓글 나열 [선택]

주요 매개변수:

  • channelId: 구독/구독 취소할 채널
  • videoId: 댓글 스레드의 동영상 ID
  • maxResults: 페이지당 결과 수
  • pageToken: 페이지 매김 토큰

주의사항:

  • 이미 구독 중인 채널을 구독하면 오류가 반환될 수 있습니다.
  • 댓글 스레드는 각각 최대 5개의 답글이 있는 최상위 댓글을 반환합니다.
  • 일부 동영상에서는 댓글이 비활성화될 수 있습니다.
  • 구독 취소에는 채널 ID가 아닌 구독 ID가 필요합니다.

일반적인 패턴

채널 ID 변환

핸들을 채널 ID로:

1. '@handle'로 YOUTUBE_GET_CHANNEL_ID_BY_HANDLE 호출
2. 응답에서 channelId 추출
3. 이후 채널 작업에 사용

업로드 재생목록:

1. 채널 ID 가져오기 ('UC'로 시작)
2. 'UC' 접두사를 'UU'로 바꾸어 업로드 재생목록 ID 생성
3. LIST_PLAYLIST_ITEMS와 함께 사용하여 모든 동영상 열거

페이지 매김

  • maxResults 설정 (페이지당 최대 50개)
  • 응답에서 nextPageToken 확인
  • 다음 요청에 pageToken으로 토큰 전달
  • nextPageToken이 없을 때까지 계속

일괄 동영상 세부정보

  • 검색 또는 재생목록 목록에서 동영상 ID 수집
  • 약 50개 ID 그룹으로 분할
  • 청크당 GET_VIDEO_DETAILS_BATCH 호출
  • 청크 간 결과 병합

알려진 문제점

할당량 관리:

  • YouTube API에는 일일 할당량 제한이 있습니다 (기본 10,000 단위).
  • 업로드 = 1600 단위; 검색 = 100 단위; 목록 = 1 단위
  • 가능하면 검색보다 목록 엔드포인트를 선호하세요.
  • 할당량 사용량을 모니터링하여 일일 제한에 도달하지 않도록 하세요.

ID 형식:

  • 동영상 ID: 11자 영숫자 문자열
  • 채널 ID: 'UC'로 시작하고 22자가 뒤따름
  • 재생목록 ID: 'PL'(사용자) 또는 'UU'(업로드)로 시작
  • 채널 ID와 재생목록 ID를 혼동하지 마세요.

썸네일:

  • 맞춤 썸네일은 채널 전화 인증이 필요합니다.
  • JPG, PNG 또는 GIF여야 하며, 2MB 미만이어야 합니다.
  • 권장: 1280x720 해상도 (16:9 화면비)

응답 파싱:

  • 통계 값은 정수가 아닌 문자열로 반환됩니다. 수학 연산 전에 변환하세요.
  • 기간은 ISO 8601 형식을 사용합니다 (PT#H#M#S).
  • 일괄 응답은 데이터를 다른 키 아래에 래핑할 수 있습니다.

빠른 참조

작업도구 슬러그주요 매개변수
동영상 업로드YOUTUBE_UPLOAD_VIDEOtitle, description, tags, categoryId, privacyStatus, videoFilePath
동영상 업데이트YOUTUBE_UPDATE_VIDEOvideo_id, title, description, tags
썸네일 설정YOUTUBE_UPDATE_THUMBNAILvideoId, thumbnailUrl
YouTube 검색YOUTUBE_SEARCH_YOU_TUBEq, type, maxResults
동영상 세부정보YOUTUBE_VIDEO_DETAILSid, part
일괄 동영상 세부정보YOUTUBE_GET_VIDEO_DETAILS_BATCHid, parts
재생목록 나열YOUTUBE_LIST_USER_PLAYLISTSmaxResults, pageToken
재생목록 생성YOUTUBE_CREATE_PLAYLIST(스키마 확인)
재생목록에 추가YOUTUBE_ADD_VIDEO_TO_PLAYLIST(스키마 확인)
재생목록 항목 나열YOUTUBE_LIST_PLAYLIST_ITEMSplaylistId, maxResults
채널 통계YOUTUBE_GET_CHANNEL_STATISTICSid/forHandle/mine
채널 동영상 나열YOUTUBE_LIST_CHANNEL_VIDEOSchannelId, maxResults
핸들로 채널 IDYOUTUBE_GET_CHANNEL_ID_BY_HANDLEchannel_handle
구독YOUTUBE_SUBSCRIBE_CHANNELchannelId
구독 목록YOUTUBE_LIST_USER_SUBSCRIPTIONS(스키마 확인)
댓글 나열YOUTUBE_LIST_COMMENT_THREADSvideoId
채널 활동YOUTUBE_GET_CHANNEL_ACTIVITIES(스키마 확인)

사용 시기

이 스킬은 개요에 설명된 워크플로우나 작업을 실행할 때 사용할 수 있습니다.

Individual skills in this repo

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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.

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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 悬停效果

Desesbraker/agentes-vip

Best practices for Remotion - Video creation in React

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

Desesbraker/agentes-vip

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

Desesbraker/agentes-vip

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

Desesbraker/agentes-vip

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

Desesbraker/agentes-vip

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

Desesbraker/agentes-vip

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.

Desesbraker/agentes-vip

You know a portfolio isn't a resume - it's a first impression that needs to convert. You balance creativity with usability. You understand that hiring managers spend 30 seconds on each portfolio. You make those 30 seconds count. You help people stand out without being gimmicky.

관련 스킬