Communitygithub.com

benjaminasterA/antigravity-awesome-skills

Rube MCP(Composio)를 통해 TikTok 작업을 자동화합니다: 동영상 업로드/게시, 사진 게시, 콘텐츠 관리, 사용자 프로필/통계 조회. 항상 먼저 도구를 검색하여 최신 스키마를 확인하세요.

antigravity-awesome-skills란 무엇인가요?

이 스킬은 Rube MCP(Composio)의 TikTok 툴킷을 통해 TikTok 콘텐츠 제작 및 프로필 관리를 자동화합니다. 동영상 업로드 후 게시, 사진 게시, 게시된 동영상 목록 조회, 사용자 프로필 및 통계 확인, 게시 상태 확인 등의 워크플로우를 제공합니다. 각 워크플로우는 명확한 도구 시퀀스와 주의사항을 포함하며, 특히 동영상 업로드와 게시가 별도 단계로 구성되어 있습니다. 이 스킬은 Rube MCP 클라이언트 환경에서 사용되며, 먼저 RUBE_SEARCH_TOOLS를 호출하여 최신 도구 스키마를 확보한 후 TikTok 연결을 설정해야 합니다. OAuth 인증, 속도 제한, 콘텐츠 요구사항(MP4/JPEG 등)에 대한 세부 지침도 포함되어 있어 안정적인 자동화를 지원합니다.

지원 대상~Claude Code~Codex CLI✓Cursor✓Antigravity
npx skills add https://github.com/benjaminasterA/antigravity-awesome-skills/tree/HEAD/skills/tiktok-automation

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

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

문서

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 키가 필요하지 않습니다. 엔드포인트만 추가하면 작동합니다.

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

핵심 워크플로우

1. 동영상 업로드 및 게시

사용 시기: 사용자가 동영상을 업로드하고 TikTok에 게시하려는 경우

도구 시퀀스:

  1. TIKTOK_UPLOAD_VIDEO 또는 TIKTOK_UPLOAD_VIDEOS - 동영상 파일 업로드 [필수]
  2. TIKTOK_FETCH_PUBLISH_STATUS - 업로드/처리 상태 확인 [필수]
  3. TIKTOK_PUBLISH_VIDEO - 업로드된 동영상 게시 [필수]

업로드 주요 매개변수:

  • video: s3key, mimetype, name을 포함한 동영상 파일 객체
  • title: 동영상 제목/캡션

게시 주요 매개변수:

  • publish_id: 업로드 단계에서 반환된 ID
  • title: 동영상 캡션 텍스트
  • 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에 사진을 게시하려는 경우

도구 시퀀스:

  1. TIKTOK_POST_PHOTO - 사진 업로드 및 게시 [필수]
  2. TIKTOK_FETCH_PUBLISH_STATUS - 처리 상태 확인 [선택]

주요 매개변수:

  • photo: s3key, mimetype, name을 포함한 사진 파일 객체
  • title: 사진 캡션 텍스트
  • privacy_level: 게시물의 프라이버시 설정

주의사항:

  • 사진 게시는 비교적 새로운 TikTok 기능입니다. 계정 유형에 따라 가용성이 다를 수 있습니다.
  • 지원 형식: JPEG, PNG, WebP
  • 이미지 크기 및 치수 제한이 적용됩니다. 현재 TikTok 가이드라인을 확인하세요.

3. 동영상 목록 및 관리

사용 시기: 사용자가 게시된 동영상을 확인하려는 경우

도구 시퀀스:

  1. TIKTOK_LIST_VIDEOS - 사용자가 게시한 동영상 목록 조회 [필수]

주요 매개변수:

  • max_count: 페이지당 반환할 동영상 수
  • cursor: 다음 페이지를 위한 페이지네이션 커서

주의사항:

  • 인증된 사용자 자신의 동영상만 반환됩니다.
  • 응답에는 동영상 메타데이터(id, title, create_time, share_url, duration 등)가 포함됩니다.
  • 페이지네이션은 커서 기반 방식입니다. 응답에서 has_more와 cursor를 확인하세요.
  • 최근 게시된 동영상은 목록에 즉시 나타나지 않을 수 있습니다.

4. 사용자 프로필 및 통계 조회

사용 시기: 사용자가 자신의 TikTok 프로필 정보나 계정 통계를 확인하려는 경우

도구 시퀀스:

  1. TIKTOK_GET_USER_PROFILE - 전체 프로필 정보 가져오기 [필수]
  2. TIKTOK_GET_USER_STATS - 계정 통계 가져오기 [선택]
  3. TIKTOK_GET_USER_BASIC_INFO - 기본 사용자 정보 가져오기 [대안]

주요 매개변수: (필수 매개변수 없음; 인증된 사용자의 데이터를 반환)

주의사항:

  • 프로필 데이터는 인증된 사용자만 조회 가능합니다. 다른 사용자의 프로필은 볼 수 없습니다.
  • 통계에는 팔로워 수, 팔로잉 수, 동영상 수, 받은 좋아요 수가 포함됩니다.
  • GET_USER_PROFILE은 GET_USER_BASIC_INFO보다 더 자세한 정보를 반환합니다.
  • 통계는 약간의 지연이 있을 수 있으며 실시간이 아닙니다.

5. 게시 상태 확인

사용 시기: 사용자가 콘텐츠 업로드 또는 게시 작업의 상태를 확인하려는 경우

도구 시퀀스:

  1. 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_VIDEOvideo, title
여러 동영상 업로드TIKTOK_UPLOAD_VIDEOSvideos
동영상 게시TIKTOK_PUBLISH_VIDEOpublish_id, title, privacy_level
사진 게시TIKTOK_POST_PHOTOphoto, title, privacy_level
동영상 목록 조회TIKTOK_LIST_VIDEOSmax_count, cursor
프로필 가져오기TIKTOK_GET_USER_PROFILE(없음)
사용자 통계 가져오기TIKTOK_GET_USER_STATS(없음)
기본 정보 가져오기TIKTOK_GET_USER_BASIC_INFO(없음)
게시 상태 확인TIKTOK_FETCH_PUBLISH_STATUSpublish_id

사용 시기

이 스킬은 개요에 설명된 워크플로우 또는 작업을 실행하는 데 적용됩니다.

Individual skills in this repo

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

관련 스킬