Communitygithub.com

TeamWiseFlow/tiktok-post

브라우저를 사용하여 동영상(또는 이미지 캐러셀)을 TikTok에 업로드하고 게시합니다.

tiktok-post란 무엇인가요?

이 스킬은 AI 에이전트(예: Claude Code, Cursor, Codex)가 TikTok(국제 버전)에 동영상이나 이미지 캐러셀을 자동으로 업로드하고 게시할 수 있도록 지원합니다. 주로 동영상 제작 스킬에서 생성된 짧은 동영상을 크로스 포스팅하는 데 유용하며, 캡션, 해시태그, 커버 이미지 설정을 포함한 전체 워크플로우를 자동화합니다. TikTok의 Creator Center 업로드 페이지를 사용하며, 브라우저 도구를 통해 작동하므로 세션이 로그인되어 있어야 합니다. 업로드 실패 시의 오류 처리, 타임아웃 대처, UI 변경에 대한 적응 방법 등이 상세히 문서화되어 있어 안정적인 자동 게시가 가능합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TeamWiseFlow/wiseflow/tree/master/addons/officials/crew/selfmedia-operator/skills/tiktok-post

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

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

문서

TikTok 게시 스킬

다음 상황에서 이 스킬을 사용하세요:

  • 사용자가 TikTok(국제 버전)에 동영상을 게시하려는 경우
  • video-producer가 생성한 짧은 동영상을 크로스 포스팅해야 하는 경우
  • TikTok 게시물에 캡션, 해시태그 및 커버를 설정해야 하는 경우

전제 조건: 브라우저 세션이 tiktok.com에 로그인되어 있어야 합니다.


일반 제약 사항

  • 파일 업로드 전에 반드시 /tmp/openclaw/uploads/로 복사해야 합니다 (browser 도구 샌드박스 제한).
  • browser upload 도구가 "시간 초과 오류"를 반환할 수 있지만, 이것이 업로드 실패를 의미하지는 않습니다! 업로드 후 스냅샷으로 페이지 상태를 확인하세요 (진행률 표시줄, 처리 상태 텍스트).
  • input.files.length가 0인지 확인하여 업로드 실패 여부를 판단하지 마세요! input.files.length == 0이 업로드 실패를 의미하지 않습니다.
  • browser failed: timed out. Restart the OpenClaw gateway ... 오류가 발생하면 재시작하거나 오류를 보고할 필요가 없습니다! 30초 기다린 후 원래 페이지에서 계속 작업하세요. 그래도 작동하지 않으면 30초 더 기다리세요. 여전히 문제가 있으면 브라우저를 닫았다가 다시 열어보세요. 그래도 오류가 계속되면 그때서야 실제 오류로 간주하고 작업을 중단하고 사용자에게 알리세요.
  • 캡션 입력은 type + slowly: true를 사용하고, fill()을 사용하지 마세요.

Cookie Warmup (쿠키 준비)

먼저 https://www.tiktok.com으로 이동합니다. 로그인 페이지로 리디렉션되면 세션이 만료된 것입니다. 사용자에게 알리세요.


워크플로우: 동영상 업로드

1. https://www.tiktok.com/creator-center/upload 로 이동
   (대체: https://www.tiktok.com/upload)
2. 업로드 페이지가 로드될 때까지 기다림
3. "동영상 선택"을 클릭하거나 동영상 파일을 업로드 영역에 드래그 앤 드롭
   - 지원 형식: MP4, MOV, WebM
   - 권장: 9:16 세로, 1080×1920, 500MB 미만
   - 길이: 15초 ~ 10분
4. 업로드 및 처리가 완료될 때까지 기다림 (진행률 표시줄이 100%에 도달)
5. 캡션 영역을 클릭하고 캡션 입력:
   - 일반 텍스트 + 해시태그 (#태그 형식 사용)
   - 최대 2200자
   - 검색 가능성을 위해 관련 해시태그 3~5개 포함
6. 커버 이미지 설정:
   - "커버"를 클릭하고 동영상에서 프레임 선택
   - 또는 사용자 지정 커버 이미지 업로드
7. "게시" 버튼 클릭
8. 확인 대기 - TikTok에 "동영상이 게시되었습니다" 또는 유사 메시지 표시
9. 게시물 URL 복사 및 보고

워크플로우: 예약 게시 (가능한 경우)

위 6단계 이후:
1. 즉시 게시 대신 "예약" 토글
2. 날짜와 시간 선택 (시간대는 계정 설정에서 자동 감지)
3. "예약" 클릭

캡션 모범 사례

  • 첫 줄에 훅을 넣어 피드에서 "더보기"로 잘리기 전에 눈길을 끌도록 함
  • 해시태그는 인라인이 아닌 마지막에 추가
  • 광범위한 태그(#ai #technology)와 틈새 태그(#aitools #wiseflow) 혼합 사용
  • 해시태그 앞의 핵심 메시지는 100자 이내 유지

오류 처리

상황조치
로그인 페이지세션 만료 - 사용자에게 재로그인 요청
동영상 거부 (정책 위반)이유를 사용자에게 보고, 자동 재시도 금지
업로드 특정 %에서 멈춤최대 3분 대기, 그래도 멈추면 페이지 새로고침
캡션 너무 김먼저 해시태그를 줄이고, 그 다음 캡션을 줄임
커버 선택 실패커버 사용자 지정 건너뛰고 자동 생성 커버 사용

참고 사항

  • TikTok의 업로드 UI는 자주 변경됩니다. 버튼/요소가 없으면 의도에 따라 동등한 UI를 찾으세요.
  • 완료 후 항상 게시물 URL을 확인하세요.
  • TikTok 커뮤니티 가이드라인을 위반하는 콘텐츠를 게시하지 마세요.

관련 스킬