Communitygithub.com

BEKO2210/Firstbrain

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

Firstbrain란 무엇인가요?

이 스킬은 Rube MCP의 TikTok 툴킷을 활용하여 TikTok 콘텐츠 제작 및 계정 관리를 완전히 자동화합니다. 개발자는 동영상 업로드 및 게시, 사진 게시, 동영상 목록 조회, 사용자 프로필 및 통계 확인, 게시 상태 확인 등의 작업을 프로그래밍 방식으로 수행할 수 있습니다. 이 스킬은 Rube MCP와 함께 작동하며, 항상 `RUBE_SEARCH_TOOLS`를 먼저 호출하여 최신 도구 스키마를 가져오도록 설계되었습니다. 주요 워크플로우는 단계별로 명확하게 구분되어 있으며(예: 동영상 업로드 후 게시는 별도 단계), 각 작업의 필수 파라미터, 주의사항, 한계점(예: 동영상 형식, 크기 제한, 속도 제한, OAuth 토큰 만료)을 상세히 설명합니다. 따라서 개발자는 이 스킬을 통해 TikTok API의 복잡성을 추상화하고 안정적인 콘텐츠 관리 파이프라인을 구축할 수 있습니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/BEKO2210/Firstbrain/tree/HEAD/03%20-%20Resources/Skills/tiktok-automation

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

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

문서

Rube MCP를 통한 TikTok 자동화

Composio의 TikTok 툴킷을 Rube MCP를 통해 사용하여 TikTok 콘텐츠 생성 및 프로필 작업을 자동화합니다.

사전 조건

  • Rube MCP가 연결되어 있어야 함 (RUBE_SEARCH_TOOLS 사용 가능)
  • 툴킷 tiktok을 사용한 RUBE_MANAGE_CONNECTIONS를 통한 활성 TikTok 연결
  • 항상 RUBE_SEARCH_TOOLS를 먼저 호출하여 최신 도구 스키마를 확인

설정

Rube MCP 가져오기: 클라이언트 설정에 https://rube.app/mcp를 MCP 서버로 추가합니다. API 키가 필요 없으며, 엔드포인트만 추가하면 작동합니다.

  1. RUBE_SEARCH_TOOLS가 응답하는지 확인하여 Rube MCP가 사용 가능한지 확인합니다.
  2. 툴킷 tiktok을 사용하여 RUBE_MANAGE_CONNECTIONS를 호출합니다.
  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, 제목, 생성 시간, 공유 URL, 길이 등)가 포함됩니다.
  • 페이지네이션은 커서 기반 방식을 사용합니다. 응답에서 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

사용 시기

이 스킬은 개요에 설명된 워크플로우나 작업을 실행하는 데 사용할 수 있습니다.

연결

  • 도메인: [[Kommunikation & Content]]
  • 카테고리: [[Social Media]]
  • 탐색: [[Skills Uebersicht]], [[Home]]

Individual skills in this repo

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

BEKO2210/Firstbrain

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

BEKO2210/Firstbrain

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

BEKO2210/Firstbrain

One sentence - what this skill does and when to invoke it

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

BEKO2210/Firstbrain

Expert in building portfolios that actually land jobs and clients -

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

BEKO2210/Firstbrain

Best practices for Remotion - Video creation in React

BEKO2210/Firstbrain

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

BEKO2210/Firstbrain

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

BEKO2210/Firstbrain

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

BEKO2210/Firstbrain

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

BEKO2210/Firstbrain

One sentence - what this skill does and when to invoke it

BEKO2210/Firstbrain

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

BEKO2210/Firstbrain

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

관련 스킬