Communitygithub.com

ASoudy/AGS

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

AGS란 무엇인가요?

이 스킬은 Rube MCP 플랫폼을 통해 TikTok API를 완전 자동화하는 AI 에이전트 도구입니다. 개발자나 AI 에이전트 사용자는 사전 정의된 도구 체인을 통해 동영상 업로드 및 게시, 사진 게시, 게시 상태 확인, 사용자 프로필 및 통계 조회 등의 작업을 수행할 수 있습니다. Rube MCP가 연결되어 있어야 하며 `RUBE_SEARCH_TOOLS`로 현재 도구 스키마를 먼저 가져오고, `RUBE_MANAGE_CONNECTIONS`로 TikTok OAuth 인증을 완료해야 합니다. 이 스킬은 Claude Code, Cursor, Codex 등 Rube MCP를 MCP 서버로 지원하는 모든 클라이언트에서 사용할 수 있으며, TikTok의 제한 사항(파일 형식, 크기, 캡션 길이, 속도 제한 등)과 분할 단계(업로드 후 게시)를 명확히 안내하여 안정적인 자동화를 지원합니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/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 가져오기: 클라이언트 설정에 https://rube.app/mcp를 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. 완료될 때까지 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_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 20 individual skills — each has its own dedicated page.

ASoudy/AGS

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

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

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

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

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

ASoudy/AGS

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

ASoudy/AGS

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.

ASoudy/AGS

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

관련 스킬