youtube-transcript-dlp

Python의 yt-dlp를 래핑한 ytdlp-nodejs를 래핑한 라이브러리입니다. 바보같지만 안정성이 뛰어납니다.

Fetch Korean subtitles or auto-captions with yt-dlp.

Install

npm install youtube-transcript-dlp

Usage

const { getSubtitleJson, getSubtitleText } = require('youtube-transcript-dlp');

const url = 'https://www.youtube.com/watch?v=...';

// preferAuto (옵션, 기본값 true)
// true: 자동자막 -> 사용자자막
// false: 사용자자막 -> 자동자막
// options.reliability: 'safe' | 'balanced' | 'fast' (기본값 safe)
// playlist/time 파라미터(list, index, pp, t, start 등)는 단일 영상 처리 위해 제거됩니다.
const json = await getSubtitleJson(url, 'ko', true, { reliability: 'balanced' });
// Returns:
// {
//   title: string,
//   url: string,
//   language: string,
//   auto: boolean,
//   sourceExt: 'json3' | 'vtt' | 'srt',
//   extractedAt: string,
//   subtitles: Array<{ startMs: number, endMs: number, text: string }>
// }

const text = await getSubtitleText(url, 'en', false);
// Returns: string (single-line, sentences concatenated)