Rube MCP를 통한 YouTube 자동화
Composio의 YouTube 툴킷을 Rube MCP를 통해 YouTube 작업을 자동화합니다.
필수 조건
- Rube MCP가 연결되어 있어야 합니다 (
RUBE_SEARCH_TOOLS사용 가능) RUBE_MANAGE_CONNECTIONS를 통해youtube툴킷으로 YouTube 연결이 활성화되어 있어야 합니다- 항상
RUBE_SEARCH_TOOLS를 먼저 호출하여 현재 도구 스키마를 확인하세요
설정
Rube MCP 가져오기: 클라이언트 설정에서 https://rube.app/mcp를 MCP 서버로 추가하세요. API 키가 필요하지 않습니다. 엔드포인트만 추가하면 작동합니다.
RUBE_SEARCH_TOOLS가 응답하는지 확인하여 Rube MCP가 사용 가능한지 확인합니다.RUBE_MANAGE_CONNECTIONS를youtube툴킷으로 호출합니다.- 연결이 ACTIVE 상태가 아니면 반환된 인증 링크를 따라 Google OAuth를 완료합니다.
- 워크플로를 실행하기 전에 연결 상태가 ACTIVE인지 확인합니다.
핵심 워크플로
1. 동영상 업로드 및 관리
사용 시기: 사용자가 동영상을 업로드하거나 동영상 메타데이터를 업데이트하려는 경우
도구 순서:
YOUTUBE_UPLOAD_VIDEO- 새 동영상 업로드 [필수]YOUTUBE_UPDATE_VIDEO- 제목, 설명, 태그, 공개 설정 업데이트 [선택]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가 있는 객체여야 하며, raw 파일 경로나 URL이 아니어야 합니다.
- 태그 전체 길이는 구분자를 포함하여 500자를 초과할 수 없습니다.
- 태그의 꺾쇠 괄호
< >는 자동으로 제거됩니다. - 설명 제한은 5000바이트이며, 문자 수가 아닙니다(멀티바이트 문자는 더 많이 차지합니다).
2. YouTube 콘텐츠 검색
사용 시기: 사용자가 동영상, 채널 또는 재생목록을 찾으려는 경우
도구 순서:
YOUTUBE_SEARCH_YOU_TUBE- 콘텐츠 검색 [필수]YOUTUBE_VIDEO_DETAILS- 특정 동영상의 전체 세부 정보 가져오기 [선택]YOUTUBE_GET_VIDEO_DETAILS_BATCH- 여러 동영상의 세부 정보 가져오기 [선택]
주요 파라미터:
q: 검색어 (정확한 구문, 제외어, 채널 핸들 지원)type: 'video', 'channel' 또는 'playlist'maxResults: 페이지당 결과 수 (1-50)pageToken: 페이지네이션용 토큰
주의사항:
- 검색 엔드포인트는 'snippet' 부분만 반환합니다. 통계 정보는 VIDEO_DETAILS를 사용하세요.
- 검색 결과는 최대 500개 항목으로 제한됩니다.
- 검색은 목록 엔드포인트(1단위)보다 높은 쿼터 비용(100단위)이 듭니다.
- BATCH 동영상 세부 정보 호출은 ID 약 50개가 실용적인 한계입니다. 더 큰 세트는 분할하세요.
3. 재생목록 관리
사용 시기: 사용자가 재생목록을 만들거나 재생목록 내용을 관리하려는 경우
도구 순서:
YOUTUBE_LIST_USER_PLAYLISTS- 사용자의 기존 재생목록 나열 [선택]YOUTUBE_CREATE_PLAYLIST- 새 재생목록 생성 [선택]YOUTUBE_ADD_VIDEO_TO_PLAYLIST- 동영상을 재생목록에 추가 [선택]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. 채널 및 동영상 분석 데이터 가져오기
사용 시기: 사용자가 채널 성능이나 동영상 지표를 분석하려는 경우
도구 순서:
YOUTUBE_GET_CHANNEL_ID_BY_HANDLE- 핸들을 채널 ID로 변환 [필수 조건]YOUTUBE_GET_CHANNEL_STATISTICS- 채널 구독자/조회수/동영상 수 가져오기 [필수]YOUTUBE_LIST_CHANNEL_VIDEOS- 채널의 모든 동영상 나열 [선택]YOUTUBE_GET_VIDEO_DETAILS_BATCH- 동영상별 통계 가져오기 [선택]YOUTUBE_GET_CHANNEL_ACTIVITIES- 최근 채널 활동 가져오기 [선택]
주요 파라미터:
channelId: 채널 ID ('UC...'), 핸들 ('@handle') 또는 'me'forHandle: 채널 핸들 (예: '@Google')id: 배치 세부 정보를 위한 쉼표로 구분된 동영상 IDparts: 포함할 리소스 부분 (예: 'snippet,statistics')
주의사항:
- 채널 통계는 전체 기간 누계이며, 특정 기간별 수치가 아닙니다.
- BATCH 동영상 세부 정보는 비공개/삭제된 동영상의 경우 요청된 것보다 적은 항목을 반환할 수 있습니다.
- 응답 데이터는
data또는data_preview아래에 중첩될 수 있습니다. 방어적으로 파싱하세요. - contentDetails.duration은 ISO 8601 형식(예: 'PT4M13S')을 사용합니다.
5. 구독 및 댓글 관리
사용 시기: 사용자가 채널을 구독하거나 동영상 댓글을 보려는 경우
도구 순서:
YOUTUBE_SUBSCRIBE_CHANNEL- 채널 구독 [선택]YOUTUBE_UNSUBSCRIBE_CHANNEL- 채널 구독 취소 [선택]YOUTUBE_LIST_USER_SUBSCRIPTIONS- 구독 목록 조회 [선택]YOUTUBE_LIST_COMMENT_THREADS- 동영상 댓글 목록 조회 [선택]
주요 파라미터:
channelId: 구독/구독 취소할 채널videoId: 댓글 스레드의 동영상 IDmaxResults: 페이지당 결과 수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_VIDEO | title, description, tags, categoryId, privacyStatus, videoFilePath |
| 동영상 업데이트 | YOUTUBE_UPDATE_VIDEO | video_id, title, description, tags |
| 썸네일 설정 | YOUTUBE_UPDATE_THUMBNAIL | videoId, thumbnailUrl |
| YouTube 검색 | YOUTUBE_SEARCH_YOU_TUBE | q, type, maxResults |
| 동영상 세부 정보 | YOUTUBE_VIDEO_DETAILS | id, part |
| 배치 동영상 세부 정보 | YOUTUBE_GET_VIDEO_DETAILS_BATCH | id, parts |
| 재생목록 나열 | YOUTUBE_LIST_USER_PLAYLISTS | maxResults, pageToken |
| 재생목록 생성 | YOUTUBE_CREATE_PLAYLIST | (스키마 확인) |
| 재생목록에 추가 | YOUTUBE_ADD_VIDEO_TO_PLAYLIST | (스키마 확인) |
| 재생목록 항목 나열 | YOUTUBE_LIST_PLAYLIST_ITEMS | playlistId, maxResults |
| 채널 통계 | YOUTUBE_GET_CHANNEL_STATISTICS | id/forHandle/mine |
| 채널 동영상 나열 | YOUTUBE_LIST_CHANNEL_VIDEOS | channelId, maxResults |
| 핸들로 채널 ID | YOUTUBE_GET_CHANNEL_ID_BY_HANDLE | channel_handle |
| 구독 | YOUTUBE_SUBSCRIBE_CHANNEL | channelId |
| 구독 목록 | YOUTUBE_LIST_USER_SUBSCRIPTIONS | (스키마 확인) |
| 댓글 나열 | YOUTUBE_LIST_COMMENT_THREADS | videoId |
| 채널 활동 | YOUTUBE_GET_CHANNEL_ACTIVITIES | (스키마 확인) |