유튜브 다운로더
yt-dlp와 ffmpeg로 유튜브 영상·음원과 m3u8 스트림을 고화질로 안정적으로 내려받는 스킬.
이미지·영상중급★ 1,323⑂ 212AI 점수 8/10마지막 업데이트: 2026. 8. 8.
무엇을 해주나
- 유튜브 영상을 최대 4K 화질로 다운로드하고, MP4로 병합해 저장합니다.
- 영상에서 음원만 MP3로 추출하거나 자막을 함께 받아옵니다.
- Mux·Vimeo 등에서 쓰는 HLS(m3u8) 스트림을 인증 헤더(Referer/Origin/User-Agent)와 함께 ffmpeg로 받아옵니다.
- 실무에서 자주 만나는 실패 상황을 자동으로 복구합니다: 360p만 보이는 문제,
nsig extraction failed, "봇이 아님을 확인하세요", 403 Forbidden, 프래그먼트/SSL 오류 등. - PO Token 프로바이더(Docker bgutil 또는 브라우저 기반 WPC)를 자동으로 띄워 고화질 포맷 접근을 확보합니다.
- 비개발자를 기본 사용자로 가정해, 명령어를 시키지 않고 Claude가 직접 실행한 뒤 썸네일·제목·파일 경로·용량을 사람 말로 보고합니다.
이런 분께 추천
- 강의·세미나 영상을 오프라인으로 보관해야 하는 학습자·연구자
- 팟캐스트나 인터뷰를 MP3로 뽑아 이동 중에 듣고 싶은 분
- yt-dlp를 써봤지만 360p만 나오거나 403 오류에 막혀 포기한 경험이 있는 분
- 유료 강의 플랫폼(본인이 수강 중인)의 m3u8 스트림을 보관해야 하는 분
- 다운로드 후 바로 전사(STT)까지 연결하고 싶은 콘텐츠 제작자
활용 예시
- 한 줄 요청: "이 링크 영상 1080p로 받아줘 https://youtu.be/XXXX" → 메타데이터 확인 → PO Token 프로바이더 자동 기동 → MP4 병합 →
~/Downloads/제목.mp4경로와 용량 보고. - 오디오만: "이 인터뷰 MP3로만 뽑아줘" →
-x --audio-format mp3로 음원 추출 후, 이어서 자동 전사를 제안. - 보호된 HLS: "maven.com 강의 영상 m3u8인데 403 떠" → DevTools에서 얻은 rendition URL과 Referer 헤더를 ffmpeg에 넣고, 오디오/비디오가 분리된 경우 각각 받아
-c copy로 병합.
⚠️ 다운로드 권한이 있는 콘텐츠에만 사용하세요. 브라우저 쿠키 사용 시 로그인 세션에 접근하게 되므로 허용 전에 확인이 필요합니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 daymade/claude-code-skills 의 youtube-downloader 폴더를 내 ~/.claude/skills/youtube-downloader/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/daymade/claude-code-skills.git /tmp/daymade-skills && mkdir -p ~/.claude/skills && cp -r /tmp/daymade-skills/youtube-downloader ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 사전 준비물 설치: 터미널에서
brew install yt-dlp ffmpeg(macOS) 또는pip install --upgrade yt-dlp를 실행합니다. yt-dlp는 반드시 2025.10.22 이상 최신 버전이어야 합니다. - 스킬 폴더 준비:
mkdir -p ~/.claude/skills명령으로 스킬 디렉터리를 만듭니다. - 저장소 내려받기:
git clone https://github.com/daymade/claude-code-skills.git /tmp/daymade-skills - 스킬 복사:
cp -r /tmp/daymade-skills/youtube-downloader ~/.claude/skills/ - (선택) 고화질용 PO Token 플러그인:
head -1 $(which yt-dlp)로 파이썬 경로를 확인한 뒤,<해당파이썬> -m pip install bgutil-ytdlp-pot-provider를 실행합니다. Docker가 설치돼 있으면 스킬이 자동으로 활용합니다. - Claude Code 재시작 후 "이 유튜브 영상 받아줘" 처럼 요청하면 스킬이 자동으로 호출됩니다.
- 동작 확인:
yt-dlp -F "https://youtu.be/영상ID"결과에 137(1080p)이나 313(4K) 포맷이 보이면 고화질 세팅이 정상입니다.
GitHub에서 원본 보기 ↗라이선스: MIT