vibecut-youtube-description

vibecut-youtube-description 스킬

CapCut 자막 → 영상 흐름 파악 → 유튜브 제목 + 설명 + 챕터 자동 생성 파이프라인.

핵심 처리 흐름

CapCut draft_info.json
   ├─ [1] 프로젝트·타임라인 결정 → 전체 자막 추출 (타임스탬프 + 텍스트)
   ├─ [2] 영상 정보 확인 (GitHub 링크, 커뮤니티 링크 등) — config 있으면 자동, 없으면 질문
   ├─ [3] 제목 3가지 생성
   ├─ [4] 설명 생성 (후크 → 요약 → 링크 → 📌 다루는 내용 → ⏱️ CHAPTERS)
   └─ [5] youtube_description.txt 저장

실행 절차

1단계: 프로젝트 결정 + 자막 추출

경로는 하드코딩하지 않고 설정(~/.vibecut/config.json의 capcut_projects_dir, 또는 VIBECUT_CAPCUT_DIR)에서 읽습니다. 프로젝트 이름을 모르면 최근 프로젝트를 나열합니다.

SCRIPTS=$(python3 -c "import json,os; print(json.load(open(os.path.expanduser('~/.vibecut/config.json'))).get('scripts_dir',''))")
uv run "${SCRIPTS}/find_project.py" --recent 5      # <프로젝트 경로>\t<타임라인 이름들>
PROJECT="<CapCut 프로젝트 경로>"
TIMELINE="<타임라인 이름 또는 빈 문자열>"           # 타임라인이 여러 개면 지정 필수

uv run python - "${PROJECT}" "${TIMELINE}" "${SCRIPTS}" <<'PYEOF'
import json, sys
from pathlib import Path
project, timeline, scripts = sys.argv[1:4]
sys.path.insert(0, scripts)
from capcut_editor import draft_path_for, resolve_timeline

proj = Path(project)
tl, _ = resolve_timeline(proj, timeline or None)
draft = json.loads(draft_path_for(proj, tl).read_text(encoding="utf-8"))
mat_map = {t["id"]: t for t in draft["materials"].get("texts", [])}

# 자막 트랙 = type이 text인 트랙 중 세그먼트가 가장 많은 것 (tracks[1] 고정 가정 금지)
text_tracks = [t for t in draft["tracks"] if t.get("type") == "text" and t.get("segments")]
if not text_tracks:
    raise SystemExit("❌ 자막 트랙이 없습니다 — 먼저 vibecut-add-subtitles 를 실행하세요")
track = max(text_tracks, key=lambda t: len(t["segments"]))

subs = []
for seg in sorted(track["segments"], key=lambda s: s["target_timerange"]["start"]):
    mat = mat_map.get(seg["material_id"])
    if not mat:
        continue
    text = json.loads(mat["content"]).get("text", "").strip()
    if text:
        subs.append((seg["target_timerange"]["start"] / 1e6, text))
for st, text in subs:
    m, s = divmod(int(st), 60)
    print(f"  {m:02d}:{s:02d}  {text}")
print(f"\n자막 {len(subs)}줄, 영상 길이 {draft['duration']/1e6/60:.1f}분")
PYEOF