Rube MCP를 통한 TikTok 자동화
Composio의 TikTok 툴킷을 Rube MCP를 통해 사용하여 TikTok 콘텐츠 제작 및 프로필 작업을 자동화합니다.
전제 조건
- Rube MCP가 연결되어 있어야 합니다 (
RUBE_SEARCH_TOOLS사용 가능) RUBE_MANAGE_CONNECTIONS를 통해tiktok툴킷으로 TikTok 연결이 활성화되어 있어야 합니다- 항상 먼저
RUBE_SEARCH_TOOLS를 호출하여 현재 도구 스키마를 확인합니다
설정
Rube MCP 가져오기: 클라이언트 설정에서 MCP 서버로 https://rube.app/mcp를 추가하세요. API 키가 필요하지 않습니다. 엔드포인트만 추가하면 작동합니다.
RUBE_SEARCH_TOOLS가 응답하는지 확인하여 Rube MCP가 사용 가능한지 확인합니다RUBE_MANAGE_CONNECTIONS를tiktok툴킷으로 호출합니다- 연결이 ACTIVE 상태가 아니면 반환된 인증 링크를 따라 TikTok OAuth를 완료합니다
- 워크플로우를 실행하기 전에 연결 상태가 ACTIVE로 표시되는지 확인합니다
핵심 워크플로우
1. 동영상 업로드 및 게시
사용 시기: 사용자가 동영상을 업로드하고 TikTok에 게시하려는 경우
도구 시퀀스:
TIKTOK_UPLOAD_VIDEO또는TIKTOK_UPLOAD_VIDEOS- 동영상 파일 업로드 [필수]TIKTOK_FETCH_PUBLISH_STATUS- 업로드/처리 상태 확인 [필수]TIKTOK_PUBLISH_VIDEO- 업로드된 동영상 게시 [필수]
업로드 주요 매개변수:
video:s3key,mimetype,name을 포함한 동영상 파일 객체title: 동영상 제목/캡션
게시 주요 매개변수:
publish_id: 업로드 단계에서 반환된 IDtitle: 동영상 캡션 텍스트privacy_level: 'PUBLIC_TO_EVERYONE', 'MUTUAL_FOLLOW_FRIENDS', 'FOLLOWER_OF_CREATOR', 'SELF_ONLY'disable_duet: 듀엣 기능 비활성화disable_stitch: 스티치 기능 비활성화disable_comment: 댓글 비활성화
주의사항:
- 동영상 업로드와 게시는 별도의 두 단계입니다. 먼저 업로드한 후 게시하세요.
- 업로드 후 게시하기 전에 FETCH_PUBLISH_STATUS를 폴링하여 처리가 완료될 때까지 기다리세요.
- 동영상은 TikTok 요구사항(MP4/WebM 형식, 최대 10분, 최대 4GB)을 충족해야 합니다.
- 캡션/제목에는 문자 제한이 있습니다. 현재 TikTok 가이드라인을 확인하세요.
- 프라이버시 수준 문자열은 대소문자를 구분하며 정확히 일치해야 합니다.
- 동영상 크기에 따라 처리 시간이 30~120초 정도 소요될 수 있습니다.
2. 사진 게시
사용 시기: 사용자가 TikTok에 사진을 게시하려는 경우
도구 시퀀스:
TIKTOK_POST_PHOTO- 사진 업로드 및 게시 [필수]TIKTOK_FETCH_PUBLISH_STATUS- 처리 상태 확인 [선택]
주요 매개변수:
photo:s3key,mimetype,name을 포함한 사진 파일 객체title: 사진 캡션 텍스트privacy_level: 게시물의 프라이버시 설정
주의사항:
- 사진 게시는 비교적 새로운 TikTok 기능입니다. 계정 유형에 따라 가용성이 다를 수 있습니다.
- 지원 형식: JPEG, PNG, WebP
- 이미지 크기 및 치수 제한이 적용됩니다. 현재 TikTok 가이드라인을 확인하세요.
3. 동영상 목록 및 관리
사용 시기: 사용자가 게시된 동영상을 확인하려는 경우
도구 시퀀스:
TIKTOK_LIST_VIDEOS- 사용자가 게시한 동영상 목록 조회 [필수]
주요 매개변수:
max_count: 페이지당 반환할 동영상 수cursor: 다음 페이지를 위한 페이지네이션 커서
주의사항:
- 인증된 사용자 자신의 동영상만 반환됩니다.
- 응답에는 동영상 메타데이터(id, title, create_time, share_url, duration 등)가 포함됩니다.
- 페이지네이션은 커서 기반 방식입니다. 응답에서
has_more와cursor를 확인하세요. - 최근 게시된 동영상은 목록에 즉시 나타나지 않을 수 있습니다.
4. 사용자 프로필 및 통계 조회
사용 시기: 사용자가 자신의 TikTok 프로필 정보나 계정 통계를 확인하려는 경우
도구 시퀀스:
TIKTOK_GET_USER_PROFILE- 전체 프로필 정보 가져오기 [필수]TIKTOK_GET_USER_STATS- 계정 통계 가져오기 [선택]TIKTOK_GET_USER_BASIC_INFO- 기본 사용자 정보 가져오기 [대안]
주요 매개변수: (필수 매개변수 없음; 인증된 사용자의 데이터를 반환)
주의사항:
- 프로필 데이터는 인증된 사용자만 조회 가능합니다. 다른 사용자의 프로필은 볼 수 없습니다.
- 통계에는 팔로워 수, 팔로잉 수, 동영상 수, 받은 좋아요 수가 포함됩니다.
GET_USER_PROFILE은GET_USER_BASIC_INFO보다 더 자세한 정보를 반환합니다.- 통계는 약간의 지연이 있을 수 있으며 실시간이 아닙니다.
5. 게시 상태 확인
사용 시기: 사용자가 콘텐츠 업로드 또는 게시 작업의 상태를 확인하려는 경우
도구 시퀀스:
TIKTOK_FETCH_PUBLISH_STATUS- 상태 업데이트를 위해 폴링 [필수]
주요 매개변수:
publish_id: 이전 업로드/게시 작업의 게시 ID
주의사항:
- 상태 값에는 처리 중, 성공, 실패 상태가 포함됩니다.
- 속도 제한을 피하기 위해 적절한 간격(5~10초)으로 폴링하세요.
- 실패한 게시에는 응답에 오류 세부 정보가 포함됩니다.
- 콘텐츠 심사로 인해 처리 후 지연 또는 거부가 발생할 수 있습니다.
일반적인 패턴
동영상 게시 흐름
1. TIKTOK_UPLOAD_VIDEO로 동영상 업로드 -> publish_id 획득
2. TIKTOK_FETCH_PUBLISH_STATUS로 publish_id를 사용하여 완료될 때까지 폴링
3. 상태가 준비 완료이면 TIKTOK_PUBLISH_VIDEO를 최종 설정으로 호출
4. 선택적으로 게시를 확인하기 위해 상태를 다시 폴링
페이지네이션
- 이전 응답의
cursor를 사용하여 다음 페이지로 이동 has_more부울 값을 확인하여 추가 결과 존재 여부 판단max_count는 페이지 크기를 제어
알려진 주의사항
콘텐츠 요구사항:
- 동영상: MP4/WebM, 최대 4GB, 최대 10분
- 사진: JPEG/PNG/WebP
- 캡션: 지역별로 문자 제한이 다릅니다
- 콘텐츠는 TikTok 커뮤니티 가이드라인을 준수해야 합니다
인증:
- OAuth 토큰에는 범위가 있습니다. video.upload 및 video.publish가 승인되었는지 확인하세요.
- 토큰이 만료됩니다. 401 오류로 작업이 실패하면 다시 인증하세요.
속도 제한:
- TikTok API는 애플리케이션별로 엄격한 속도 제한이 있습니다.
- 429 응답 시 지수 백오프를 구현하세요.
- 업로드 작업에는 일일 제한이 있습니다.
응답 파싱:
- 응답 데이터는
data또는data.data아래에 중첩될 수 있습니다. - 대체 패턴을 사용하여 방어적으로 파싱하세요.
- 게시 ID는 문자열입니다. 반환된 그대로 정확히 사용하세요.
빠른 참조
| 작업 | 도구 슬러그 | 주요 매개변수 |
|---|---|---|
| 동영상 업로드 | TIKTOK_UPLOAD_VIDEO | video, title |
| 여러 동영상 업로드 | TIKTOK_UPLOAD_VIDEOS | videos |
| 동영상 게시 | TIKTOK_PUBLISH_VIDEO | publish_id, title, privacy_level |
| 사진 게시 | TIKTOK_POST_PHOTO | photo, title, privacy_level |
| 동영상 목록 조회 | TIKTOK_LIST_VIDEOS | max_count, cursor |
| 프로필 가져오기 | TIKTOK_GET_USER_PROFILE | (없음) |
| 사용자 통계 가져오기 | TIKTOK_GET_USER_STATS | (없음) |
| 기본 정보 가져오기 | TIKTOK_GET_USER_BASIC_INFO | (없음) |
| 게시 상태 확인 | TIKTOK_FETCH_PUBLISH_STATUS | publish_id |
사용 시기
이 스킬은 개요에 설명된 워크플로우 또는 작업을 실행하는 데 적용됩니다.