리본랩스 스킬팩
무료 · 퍼블릭 도메인 · 클로드 코드 스킬

4K 로 받았다고 생각하셨죠?
파일은 1080p 입니다

yt-dlp 는 URL 하나로 영상과 소리를 받는 도구입니다. 지원 사이트가 1,731개, 별이 187,390개 입니다(2026-08-28 기준). 깔리는 건 한 줄이라 아무도 그걸 못 하는 게 아닙니다 — 막히는 건 아무도 말해 주지 않는 조건 네 가지에서입니다.

※ 이 페이지는 yt-dlp 프로젝트와 관계가 없습니다. 도구는 별개의 오픈소스이고 라이선스는 Unlicense (퍼블릭 도메인 헌정) 입니다. 저희가 드리는 건 도구가 아니라 조건표입니다.

클로드 코드에서 바로 실행하기

터미널을 따로 열지 않아도 됩니다. 클로드 코드 안에서 둘 중 하나면 됩니다.

1
명령 앞에 ! 붙이기 — 제일 확실합니다
!npx --yes reborn-ytdlpkit
맨 앞의 ! 까지 함께 붙여넣으세요. 클로드를 거치지 않고 곧장 설치가 돕니다.
중간의 --yes 도 빼지 마세요 — 이게 없으면 «받아도 되나요?» 하고 묻는 자리에서 아무 말 없이 멈춥니다.
2
클로드에게 그냥 말하기
reborn-ytdlpkit 설치해줘
클로드가 명령을 대신 돌리고, 막히면 이유까지 봐 줍니다.
3
둘 다 안 되면 검은 창에서 — 클로드를 아예 거치지 않습니다
npx --yes reborn-ytdlpkit
윈도우 — 윈도우키를 누르고 cmd 라고 친 뒤 엔터. 맥 — command+스페이스 누르고 터미널 엔터.
어느 폴더에서 하셔도 상관없습니다 — 스킬은 항상 내 계정 폴더(~/.claude/skills)에 깔립니다. 여기서는 ! 를 빼세요.

먼저 컴퓨터에 Node.js 가 있어야 합니다. 없으면 위 명령이 아예 안 뜁니다 — nodejs.org 에서 큰 초록 버튼을 누르고 계속 «다음»만 누르시면 됩니다(3분). 클로드 코드를 쓰고 계시면 이미 있습니다.
클로드가 “실행하지 않겠습니다”라고 하면 1번을 쓰세요. 이제 막 나온 설치기라 클로드가 낯선 것으로 보고 막는 것이고, 그 판단 자체는 옳습니다. ! 를 붙이면 클로드에게 부탁하지 않고 바로 돌아갑니다.
폰이나 브라우저의 클로드 화면에서는 안 됩니다 — 그 창은 인터넷 저쪽의 임시 서버라 깔아도 내 컴퓨터에 남지 않습니다. 내 컴퓨터의 클로드 코드나 터미널에서 해 주세요.

깔고 나면 클로드 코드를 껐다 켜야 스킬이 잡힙니다.

① 깔기만 해서는 4K 가 안 나옵니다

유튜브는 1080p 를 넘는 화질에서 영상과 소리를 별도 파일로 내보냅니다. 둘을 합치는 데 ffmpeg 가 필요합니다. 공식 README 가 그대로 적어 뒀습니다.

ffmpeg and ffprobe - Required for merging separate video and audio files

★그런데 오류가 나지 않습니다

ffmpeg 가 없으면 오류로 멈추지 않고 합칠 필요 없는 낮은 화질로 조용히 떨어집니다. 「4K 를 받았다」고 생각하는데 파일은 1080p 입니다.

yt-dlp 저장소 README.md · Strongly recommended 절

먼저 이걸 쳐 보세요

ffmpeg -version

응답이 없으면 이게 원인입니다.

그리고 이걸 깝니다

macOS · brew install ffmpeg

Windows · winget install Gyan.FFmpeg

파이썬 패키지 ffmpeg 이 아닙니다. 바이너리입니다.

yt-dlp -F <URL> 로 화질 목록을 먼저 찍어 보면 실제로 무엇이 있는지 보입니다.

② 이름이 비슷한 걸 깝니다

더 유명한 이름이라서, 혹은 npm 이 손에 익어서 손이 먼저 갑니다. yt-dlp 는 파이썬 도구이고, 원조의 포크입니다.

pip install -U yt-dlp
이것입니다. 설치가 끝나면 `yt-dlp <URL>` 한 줄로 받습니다.필요한 것 — 파이썬 3.10 이상 (PyPI 의 requires_python 이 >=3.10 입니다)
pip install youtube-dl
원조 youtube-dl 이 깔립니다. PyPI 최신판이 2021-12-16 에 멈춰 있어 오늘 유튜브에서 대체로 실패합니다.이름이 더 유명해서 손이 먼저 갑니다. yt-dlp 는 바로 그 프로젝트의 포크입니다.
npm i yt-dlp
npm 의 yt-dlp 는 이 프로젝트가 낸 것이 아닙니다. 2023년에 올라온 남의 래퍼이고 2024년 이후 갱신이 없습니다.클로드 코드를 쓰다 보면 npm 이 손에 익어서 그리로 갑니다. 이건 파이썬 도구입니다.
pip install ffmpeg
필요한 건 ffmpeg 「바이너리」인데 이건 이름만 같은 파이썬 패키지입니다. 깔아도 화질이 안 올라갑니다.공식 README 가 이 함정을 대문자로 따로 적어 둘 만큼 자주 밟습니다.

다른 길도 있습니다 — macOS brew install yt-dlp · Windows winget install yt-dlp.yt-dlp · 바이너리 저장소 Releases 에서 yt-dlp.exe / yt-dlp_macos 를 직접 받기

③ 유튜브만 이상하게 실패한다면

유튜브를 온전히 받으려면 자바스크립트 실행기가 하나 더 필요합니다. 공식 README 원문입니다.

yt-dlp-ejs - Required for full YouTube support
deno (공식 권장)node.jsbunQuickJS

클로드 코드를 쓰고 계시면 node 는 이미 있습니다. 그대로 쓰면 됩니다.

이건 예전에 없던 조건입니다. 오래된 설치 안내글을 그대로 따라 하면 유튜브에서만 이상하게 실패합니다.

④ 받았다고 내 것이 되지는 않습니다

Unlicense 는 「이 도구」가 퍼블릭 도메인이라는 뜻입니다. 내려받은 영상의 권리는 그대로 원저작자에게 있습니다.

괜찮습니다
내가 올린 내 영상 회수, 공개 라이선스 자료, 저작권이 풀린 자료, 사적 이용 범위의 백업.
다른 이야기입니다
받은 영상을 다시 올리거나, 팔거나, 내 콘텐츠에 그대로 얹는 것. 도구의 라이선스가 콘텐츠의 라이선스를 바꾸지 않습니다.

받기 전에 그 영상을 어디에 쓸 것인지를 먼저 정하세요. 도구는 그걸 대신 판단해 주지 않습니다.

안 되면 제일 먼저 할 것

검색부터 하지 마세요. 플랫폼이 내부 방식을 바꾸면 yt-dlp 가 뒤따라 고칩니다. 낡은 판은 그 수정이 없습니다. 실패의 대부분은 이것 하나입니다.

pip install -U yt-dlp최신 2026.08.19 (2026-08-28 기준)

자주 쓰는 한 줄

화질 지정

yt-dlp -f "bestvideo+bestaudio" <URL>

소리만

yt-dlp -x --audio-format mp3 <URL>

재생목록 통째

yt-dlp -o "%(playlist_index)s-%(title)s.%(ext)s" <재생목록URL>

자막까지

yt-dlp --write-auto-subs --sub-langs ko,en <URL>

먼저 살펴보기

yt-dlp -F <URL>

이 스킬이 하지 않는 말

무엇을 안 말하는지가 원장의 절반입니다. 이유까지 같이 적어 뒀습니다.

받으면 그 영상은 내 것이 된다 도구가 퍼블릭 도메인인 것과 영상의 저작권은 별개입니다. 원본 릴스가 이렇게 말하지만 사실이 아닙니다.youtube-dl 을 쓰세요 PyPI 최신판이 2021-12-16 에서 멈췄습니다. 오늘 유튜브에서 대체로 실패합니다.깔기만 하면 4K 가 받아진다 ffmpeg 바이너리가 없으면 조용히 낮은 화질로 떨어집니다. 오류도 안 납니다.1,731개 사이트 어디서든 받는다 목록에 있는 것과 지금 받을 수 있는 것은 다릅니다. 로그인·지역 제한은 그대로 남습니다.npm 으로 깔면 된다 npm 의 yt-dlp 는 이 프로젝트가 낸 것이 아닙니다. 파이썬으로 까세요.

1,731 은 「목록에 이름이 올라 있는 사이트」의 수입니다. 로그인이 필요하거나 지역이 잠긴 자료는 목록에 있어도 못 받습니다.

깔면 이렇게 씁니다

클로드에게 그냥 말하세요 — "이 영상 받아줘" 또는 "yt-dlp 4K 가 안 돼"

npx --yes reborn-ytdlpkit doctor이 컴퓨터에 조건이 갖춰졌는지 실제로 잽니다
npx --yes reborn-ytdlpkit how맞는 설치 명령과 틀린 명령을 나란히
npx --yes reborn-ytdlpkit facts원장 전체를 터미널에

확인일 2026-08-28 · GitHub API(stargazers_count) · PyPI JSON API · 저장소 master 의 README.md 와 supportedsites.md 를 그대로 읽어 셌습니다.