tiktok-video-skill은(는) 무엇을 하나요?
AI 에이전트(Claude Code, Cursor, Codex 등)를 위한 원샷 틱톡/더우인 숏폼 영상 생성 스킬입니다. 스크립트, 무료 스톡 에셋, 이중 언어 TTS, 가라오케 자막, 배경 음악, ffmpeg 구성을 한 번에 처리합니다. API 키가 전혀 필요 없습니다.
작동 방식
- 에이전트가 주제를 입력받음 — 예:
create한국 음식에 대한 비디오 - 스킬 파이프라인 실행:
generate_script(topic, lang="en")— 영어/한국어로 짧은 내레이션 스크립트를 생성함search_stock_videos(keywords, max_results=6)— Pexels API(키 없음, 딜레이 포함)를 통해 무료 스톡 클립을 가져옴generate_tts(text, lang="en")—pyttsx3또는 시스템 TTS를 사용해 음성을 합성함generate_subtitles(audio_path, script)— 오디오 타이밍을 기준으로 동기화된 자막.srt파일을 출력함create_karakoe_subtitles(srt_path)— 동적 스타일(단어별 하이라이트)의 가라오케 자막.ass파일을 생성함search_bgm(genre, mood)— 무료 배경 음악 트랙을 검색함 (선택 사항)compose_video(...)— 위의 모든 것을 단일.mp4로 결합하는 ffmpeg 명령을 조립함
- 최종 출력:
workspace/video_<timestamp>/final.mp4및 모든 중간 산출물
주요 기능
- 원샷 실행 — 영상을 생성하려면 하나의 쉘 명령어만 필요함
- 무료 미디어 — Pexels/기타 무료 스톡 소스 사용; API 키 불필요
- 이중 언어 — 영어 및 한국어 스크립트/TTS 지원
- 가라오케 스타일 — 단어가 말해짐에 따라 텍스트가 하이라이트됨
- 완전 로컬 —
ffmpeg,python3,pyttsx3시스템 TTS에 의존 - 클리어런스 프리 — 라이선스 걱정 없음 (모든 에셋은 CC0/공개 도메인)
전제 조건
python3.8+ffmpeg(PATH에 설치 및 등록)- Python 패키지:
pyttsx3,requests,json,os,time,subprocess- 설치:
pip install pyttsx3 requests
- 설치:
- (선택 사항)
tqdm— 진행률 표시용
CLI 사용법
# 기본 사용법 (영어)
python assistant.py create "[TikTok 비디오 주제]"
# 언어 지정
python assistant.py create "한국 여행" --lang ko
# 맞춤 BGM
python assistant.py create "로피 음악" --bgm-genre 로파이
에이전트 통합
이 스킬은 다음을 위해 설계되었습니다:
- Claude Code —
claude명령어 모드에서python assistant.py create ...실행 - Cursor — 터미널 패널을 통해 직접 명령어 실행
- Codex CLI — 에이전트에
run또는exec도구가 있는 경우 - 일반 LLM 셸 — 출력을 구문 분석하고
workspace/디렉토리를 표시하도록 지시
참고: 에이전트는 대형 모델에 assistant.py의 함수 서명(인수/반환값)을 제공해야 합니다. 이는 일반적으로 에이전트가 저장소를 클로닝하거나 SKILL.md를 읽을 때 자동으로 발생합니다.
출력 디렉토리 구조
workspace/
├── video_1712345678/
│ ├── script.txt
│ ├── clips/
│ │ ├── clip_01.mp4
│ │ ├── clip_02.mp4
│ │ └── ...
│ ├── audio/
│ │ ├── tts.mp3
│ │ └── bgm.mp3
│ ├── subtitles/
│ │ ├── output.srt
│ │ └── karaoke.ass
│ └── final.mp4
└── ...
구성
파일 상단의 assistant.py에서 다음을 설정합니다:
DEFAULT_LANG—"en"또는"ko"MAX_CLIPS— 영화당 사용할 스톡 클립 최대 개수 (기본값:6)TARGET_DURATION— 초 단위 목표 비디오 길이 (기본값:30)PEXELS_API_KEY— 비워 두면 무료 계층 사용(제한적, 속도 제한 포함)
라이선스
MIT — 자유롭게 사용, 수정, 재배포하세요.