⌨️ CLI / 터미널

YouTube 스크립트 CLI: 터미널에서 스크립트 추출

명령줄에서 바로 YouTube 스크립트를 추출하세요. curl 한 줄 명령, NPM 패키지 또는 Python SDK로 셸 스크립트, CI/CD 파이프라인, 자동화 워크플로에 스크립트 추출 기능을 통합할 수 있습니다.

API 키 받기 →API 문서

CURL로 빠르게 시작하기

터미널에서 스크립트를 가져오는 가장 빠른 방법은 curl 명령 한 줄입니다.

Terminal

curl -H "x-api-key: YOUR_API_KEY" \
  "https://youtubetranscript.dev/api/v2/transcript?video=dQw4w9WgXcQ"

NPM 패키지 사용하기

더 복잡한 워크플로에는 Node.js 스크립트에서 NPM 패키지를 사용하세요.

JavaScript / Node.js

import { YouTubeTranscript } from "youtube-transcript-api";

const yt = new YouTubeTranscript({ apiKey: process.env.API_KEY });

const result = await yt.getTranscript("dQw4w9WgXcQ");
console.log(result.data?.transcript.text);

PYTHON SDK 사용하기

Python 스크립트는 데이터 처리 및 분석 파이프라인에 적합합니다.

Python

from youtubetranscript import YouTubeTranscript
import os

yt = YouTubeTranscript(os.environ["API_KEY"])

result = yt.transcribe("dQw4w9WgXcQ")
print(result.text)

CLI 팁과 요령

jq로 파이프해 JSON 처리하기

jq로 JSON 응답에서 특정 필드를 추출하세요.

curl -H "x-api-key: KEY" \
  "https://youtubetranscript.dev/api/v2/transcript?video=ID" \
  | jq '.text'

파일로 저장하기

출력을 리디렉션해 스크립트를 파일로 바로 저장하세요.

curl -H "x-api-key: KEY" \
  "https://youtubetranscript.dev/api/v2/transcript?video=ID" \
  > transcript.txt

xargs로 일괄 처리하기

파일에 있는 여러 동영상 URL을 처리하세요.

cat urls.txt | xargs -I{} curl -H "x-api-key: KEY" \
  "https://youtubetranscript.dev/api/v2/transcript?video={}"

셸 스크립트와 연동하기

더 큰 워크플로의 일부로 스크립트를 추출하고 처리하는 자동화 스크립트를 구축하세요.

활용 사례

CI/CD 파이프라인

GitHub Actions, GitLab CI, Jenkins의 콘텐츠 처리 파이프라인에서 스크립트를 추출하세요.

리서치 스크립트

학술 연구, 콘텐츠 분석, 데이터셋 구축을 위해 동영상 URL을 일괄 처리하세요.

콘텐츠 자동화

cron 작업, 셸 스크립트, Makefile로 스크립트 추출을 자동화하세요.

개발자 워크플로

개발 중에 터미널을 벗어나지 않고 빠르게 스크립트를 추출하세요.

자주 묻는 질문

명령줄에서 YouTube 스크립트를 추출할 수 있나요?+

네. YouTubeTranscript.dev API와 curl을 사용하면 명령 한 줄로 스크립트를 추출할 수 있습니다. 더 복잡한 CLI 워크플로에는 NPM 패키지나 Python SDK를 사용할 수도 있습니다.

CLI를 사용하려면 API 키가 필요한가요?+

네. YouTubeTranscript.dev 계정 설정에서 API 키를 발급받으세요. curl 요청에 x-api-key 헤더로 포함하면 됩니다.

파일에 있는 여러 동영상을 처리할 수 있나요?+

네. 텍스트 파일에 동영상 URL을 한 줄에 하나씩 넣고 xargs나 간단한 반복문으로 모두 처리하세요. API는 플랜의 요청 한도 내에서 동시 요청을 처리합니다.

CLI는 어떤 출력 형식을 지원하나요?+

API는 기본적으로 JSON을 반환하며, jq로 처리할 수 있습니다. format 파라미터로 특정 형식(text, SRT, VTT)을 요청할 수도 있습니다.

터미널에서 추출을 시작하세요

curl 명령 한 줄이면 첫 스크립트를 받을 수 있습니다.

API 키 받기 →