클로드 커스텀 커맨드로 유튜브 영상 다운로드부터 자막까지 자동화하기

---
description: 참고 영상을 다운로드해 제목·설명·자막(스크립트) txt와 함께 저장한다 (프리미어 편집 호환 코덱으로)
---

다음 URL의 영상을 참고용으로 다운로드한다: $ARGUMENTS

사전 준비 (없으면 먼저 설치 안내):
- yt-dlp, ffmpeg/ffprobe, python이 설치되어 있고 PATH에 등록되어 있어야 함

절차:
1. URL이 없으면 사용자에게 물어본다.
2. 저장 폴더 확인 — 사용자가 폴더를 지정하지 않았다면 어디에 저장할지 먼저 물어본다 (임의 경로에 추측해서 저장 금지). 폴더가 없으면 생성한다 (mkdir -p "<폴더>").
3. 영상 제목 먼저 가져오기 (다운로드 전에 파일명을 정하기 위해):
   yt-dlp --print "%(title)s" --skip-download "<URL>"
4. 파일명 규칙: <오늘날짜 YYYYMMDD>_<영상 제목>
   - 제목에서 파일명에 못 쓰는 문자(\ / : * ? " < > |)는 _로 치환
   - 너무 길면 적당히 잘라서 사용 (80자 내외)
   - 예: 20260816_이영상제목요약.mp4
5. 유튜브는 기본으로 AV1 코덱을 주는데, 프리미어는 AV1 편집 지원이 불안정해서 열리지 않는 경우가 있다. 그래서 처음부터 H.264(avc1) 포맷을 우선 요청해서 위에서 정한 파일명으로 저장한다:
   yt-dlp -f "bestvideo[vcodec^=avc1]+bestaudio/best[vcodec^=avc1]/best" --merge-output-format mp4 -o "<저장폴더>/<파일명>.%(ext)s" "<URL>"
6. 다운로드 완료 후 코덱을 확인한다 (avc1 포맷이 아예 없어서 AV1으로만 받아진 경우 대비):
   ffprobe -v error -select_streams v:0 -show_entries stream=codec_name -of default=noprint_wrappers=1:nokey=1 "<받은 파일>"
7. 코덱이 av1이면 H.264로 재인코딩한다 (파일명에 _H264 접미사):
   ffmpeg -y -i "<원본>.mp4" -c:v libx264 -crf 18 -preset medium -pix_fmt yuv420p -c:a aac -b:a 192k "<원본>_H264.mp4"
8. 제목·설명 txt 저장 — 영상과 같은 파일명(확장자만 .txt)으로, 제목과 설명란을 같이 저장한다:
   yt-dlp --print "%(title)s" --print "%(description)s" --skip-download "<URL>" > "<저장폴더>/<파일명>.txt"
9. 스크립트(자막) 받아서 같은 txt 아래에 합치기:
   - 한국어 자막을 받는다 (수동 자막 있으면 그거, 없으면 자동 생성 자막). 다른 언어가 필요하면 ko를 원하는 언어 코드로 바꾼다:
     yt-dlp --write-subs --write-auto-subs --sub-langs ko --sub-format vtt --skip-download -o "<저장폴더>/<파일명>.%(ext)s" "<URL>"
   - 생성된 <파일명>.ko.vtt가 있으면, 타임스탬프·태그를 제거하고 중복 줄(자동 자막 특유의 롤링 중복)을 정리해서 순수 텍스트로 변환한 뒤 .txt 파일 맨 아래에 '=== 스크립트(자막) ===' 구분선과 함께 이어붙인다:
     python -c "
import sys, re
lines = open(sys.argv[1], encoding='utf-8').read().splitlines()
out = []
prev = None
for line in lines:
    line = line.strip()
    if not line or line == 'WEBVTT' or '-->' in line or line.isdigit() or line.startswith(('NOTE','Kind:','Language:')):
        continue
    line = re.sub(r'<[^>]+>', '', line)
    if line and line != prev:
        out.append(line)
        prev = line
print('\n'.join(out))
" "<저장폴더>/<파일명>.ko.vtt" >> "<저장폴더>/<파일명>.txt"
     (append 전에 echo -e "\n=== 스크립트(자막) ===\n"도 같이 >> 해서 구분선을 넣는다)
   - 변환 후 원본 .vtt 파일은 삭제한다 (rm).
   - 자막이 아예 없는 영상이면 이 단계는 조용히 건너뛴다 (에러로 취급하지 않음).
10. 여러 URL이 주어지면 하나씩 순서대로 처리한다 (각 영상마다 제목을 새로 가져와서 파일명을 새로 만든다 — "차례로" 저장).
11. 완료 후 실제 저장된 영상 파일 경로·용량·최종 코덱과, 함께 저장된 txt 파일 경로(스크립트 포함 여부도)를 사용자에게 보고한다 (마크다운 링크로).