Communitygithub.com

Nabil-MEDIOUNI/ytextract

🎬 Playwright 기반 CLI 및 AI 에이전트 스킬을 사용하여 YouTube의 '자막 표시' 패널을 통해 단일 동영상 또는 재생 목록의 YouTube 트랜스크립트를 추출합니다.

ytextract란 무엇인가요?

이 스킬은 개발자와 AI 에이전트(Claude Code, Cursor 등)가 YouTube 동영상 또는 재생 목록의 트랜스크립트(자막)를 프로그래매틱하게 추출할 수 있도록 지원합니다. Playwright를 사용하여 YouTube 페이지의 '자막 표시' UI 패널을 자동으로 조작하므로, 공식 YouTube Data API v3 없이도 작동합니다. 단일 동영상 또는 전체 재생 목록을 처리할 수 있으며, 추출된 트랜스크립트는 타임스탬프 포함 세그먼트로 반환되어 AI 요약, 콘텐츠 분석, 검색 색인 생성 등 다양한 용도로 재사용 가능합니다. CLI 명령어로 직접 실행하거나 AI 에이전트 스킬로 통합하여 사용하며, Playwright 브라우저 자동화를 내부적으로 처리하므로 사용자는 간단한 파라미터만 전달하면 됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add Nabil-MEDIOUNI/ytextract

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

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

문서

ytextract은(는) 무엇을 하나요?

🎬 Playwright 기반 CLI 및 AI 에이전트 스킬을 사용하여 YouTube의 '자막 표시' 패널을 통해 단일 동영상 또는 재생 목록의 YouTube 트랜스크립트를 추출합니다.

개요

ytextract는 YouTube 동영상의 트랜스크립트(자막)를 자동으로 추출하는 도구입니다. Playwright를 사용하여 YouTube 웹 인터페이스와 상호작용하며, 별도의 API 키 없이도 작동합니다.

주요 기능

  • 단일 YouTube 동영상 트랜스크립트 추출
  • YouTube 재생 목록 전체 트랜스크립트 추출
  • 타임스탬프가 포함된 세그먼트 형식
  • CLI 명령어 및 AI 에이전트 스킬 지원

사용 방법

CLI

npx ytextract <video-url>

재생 목록

npx ytextract <playlist-url>

AI 에이전트 (Claude Code 등)

스킬을 AI 에이전트에 추가한 후, 다음과 같이 호출합니다:

@ytextract https://www.youtube.com/watch?v=example

의존성

  • Node.js 18+
  • Playwright (Chromium 브라우저)

설치

npm install -g ytextract
npx playwright install chromium

출력 형식

추출된 트랜스크립트는 다음과 같은 JSON 형식으로 반환됩니다:

[
  {
    "text": "안녕하세요, 오늘 영상에 오신 것을 환영합니다",
    "start": 0.0,
    "duration": 2.5
  },
  {
    "text": "이 채널은 기술 리뷰에 관한 내용입니다",
    "start": 2.5,
    "duration": 3.0
  }
]

라이선스

MIT

관련 스킬