Communitygithub.com

ASoudy/AGS

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

AGS란 무엇인가요?

이 스킬은 Rube MCP 서버를 통해 Composio의 YouTube 툴킷에 접근하여 YouTube 관련 작업을 자동화하는 방법을 제공합니다. Rube MCP가 연결되어 있고 RUBE_SEARCH_TOOLS로 최신 도구 스키마를 먼저 확인한 후, RUBE_MANAGE_CONNECTIONS로 YouTube 연결을 활성화해야 합니다. 주요 워크플로로는 동영상 업로드 및 메타데이터 업데이트, YouTube 콘텐츠 검색 및 상세 정보 조회, 재생목록 생성 및 관리, 채널 및 동영상 분석 정보 확인, 구독 및 댓글 관리 등이 포함됩니다. 특히 할당량 관리(업로드 1600단위, 검색 100단위, 목록 1단위)와 ID 형식(동영상 11자, 채널 'UC...', 재생목록 'PL...')의 차이를 이해하는 것이 중요하며, 응답 데이터가 data 또는 data_preview 아래 중첩될 수 있으므로 방어적으로 파싱해야 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/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. youtube 툴킷으로 RUBE_MANAGE_CONNECTIONS 호출
  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'는 People & Blogs)
  • 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단위)
  • 업로드 = 1,600단위; 검색 = 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 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.

관련 스킬