Communitygithub.com

steipete/video-transcript-downloader

yt-dlp 다운로드: 동영상, 오디오, 자막, 대본, 클립, 재생목록

video-transcript-downloader란 무엇인가요?

이 스킬은 `./scripts/vtd.js` 스크립트를 통해 YouTube 및 기타 동영상 플랫폼에서 대본(transcript)과 자막을 추출하고, 동영상/오디오/자막 파일을 다운로드하는 기능을 제공합니다. YouTube의 경우 `youtube-transcript-plus` 라이브러리를 우선 사용하여 깔끔한 대본을 가져오고, 실패 시 `yt-dlp`로 자막을 추출한 후 정리합니다. 또한 `yt-dlp`를 활용한 포맷 목록 조회, 특정 포맷 ID로 다운로드, MP4 리먹싱 등 고급 다운로드 옵션을 지원합니다. Claude Code, Cursor, Codex 등 AI 에이전트가 동영상 콘텐츠의 텍스트 정보를 빠르게 획득하거나 미디어 파일을 내려받을 때 유용합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/video-transcript-downloader

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Video Transcript Downloader

./scripts/vtd.js 는 다음 작업을 수행할 수 있습니다:

  • 대본을 깔끔한 문단으로 출력 (타임스탬프 선택 가능)
  • 동영상/오디오/자막 다운로드

대본 동작 방식:

  • YouTube: 가능한 경우 youtube-transcript-plus를 통해 가져옴
  • 그 외: yt-dlp로 자막을 추출한 후 문단으로 정리

설정

cd ~/Projects/agent-scripts/skills/video-transcript-downloader && npm ci

CLI 구문:

./scripts/vtd.js --help
./scripts/vtd.js transcript --help

하위 명령어는 --url 없이도 집중된 도움말을 지원합니다.

대본 (기본값: 깔끔한 문단)

./scripts/vtd.js transcript --url 'https://…'
./scripts/vtd.js transcript --url 'https://…' --lang en
./scripts/vtd.js transcript --url 'https://…' --timestamps
./scripts/vtd.js transcript --url 'https://…' --keep-brackets

동영상 / 오디오 / 자막 다운로드

./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads
./scripts/vtd.js audio --url 'https://…' --output-dir ~/Downloads
./scripts/vtd.js subs --url 'https://…' --output-dir ~/Downloads --lang en

포맷 (목록 + 선택)

사용 가능한 포맷 목록 보기 (포맷 ID, 해상도, 컨테이너, 오디오 전용 등):

./scripts/vtd.js formats --url 'https://…'

특정 포맷 ID로 다운로드 (예시):

./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --format 137+140

재인코딩 없이 MP4 컨테이너 선호 (가능한 경우 리먹싱):

./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --remux-video mp4

참고 사항

  • 기본 대본 출력은 하나의 문단입니다. 요청 시에만 --timestamps를 사용하세요.
  • [Music] 같은 대괄호 큐는 기본적으로 제거됩니다. --keep-brackets로 유지할 수 있습니다.
  • -- 뒤에 추가 yt-dlp 인수를 전달하여 transcript 대체, download, audio, subs, formats에 사용할 수 있습니다.
./scripts/vtd.js formats --url 'https://…' -- -v

문제 해결 (필요한 경우에만)

  • yt-dlp / ffmpeg 누락 시:
brew install yt-dlp ffmpeg
  • 확인:
yt-dlp --version
ffmpeg -version | head -n 1

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

관련 스킬