Rube MCP를 통한 TikTok 자동화
Composio의 TikTok 툴킷을 Rube MCP를 통해 사용하여 TikTok 콘텐츠 제작 및 프로필 작업을 자동화합니다.
전제 조건
- Rube MCP가 연결되어 있어야 합니다 (
RUBE_SEARCH_TOOLS사용 가능) RUBE_MANAGE_CONNECTIONS를 통해tiktok툴킷으로 활성 TikTok 연결 필요- 항상
RUBE_SEARCH_TOOLS를 먼저 호출하여 현재 도구 스키마를 확인하세요
설정
Rube MCP 가져오기: 클라이언트 설정에 https://rube.app/mcp를 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. 완료될 때까지 publish_id로 TIKTOK_FETCH_PUBLISH_STATUS 폴링
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 |
사용 시기
이 스킬은 개요에 설명된 워크플로우 또는 작업을 실행하는 데 적용할 수 있습니다.
제한 사항
- 이 스킬은 작업이 위에 설명된 범위와 명확하게 일치하는 경우에만 사용하세요.
- 출력물을 환경별 검증, 테스트 또는 전문가 검토의 대체 수단으로 취급하지 마세요.
- 필수 입력, 권한, 안전 경계 또는 성공 기준이 누락된 경우 중단하고 명확히 요청하세요.