YouTube 콘텐츠 도구
사용 시점
사용자가 YouTube URL이나 동영상 링크를 공유하거나, 동영상 요약을 요청하거나, 자막을 요청하거나, YouTube 동영상의 콘텐츠를 추출하여 재구성하려고 할 때 사용합니다. 자막을 장별 요약, 요약문, 스레드, 블로그 게시물과 같은 구조화된 콘텐츠로 변환합니다.
YouTube 동영상에서 자막을 추출하여 유용한 형식으로 변환합니다.
설정
uv를 사용하여 의존성을 Hermes 관리 환경에 설치합니다:
uv pip install youtube-transcript-api
도우미 스크립트
SKILL_DIR은 이 SKILL.md 파일이 포함된 디렉터리입니다. 스크립트는 모든 표준 YouTube URL 형식, 짧은 링크(youtu.be), shorts, 임베드, 라이브 링크 또는 원시 11자 동영상 ID를 지원합니다.
# 메타데이터가 포함된 JSON 출력
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "https://youtube.com/watch?v=VIDEO_ID"
# 일반 텍스트 (파이프를 통한 추가 처리에 적합)
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --text-only
# 타임스탬프 포함
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --timestamps
# 특정 언어 및 대체 언어 체인 지정
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --language tr,en
출력 형식
자막을 가져온 후, 사용자가 요청한 내용에 따라 형식을 지정합니다:
- 챕터(Chapters): 주제 전환별로 그룹화하여 타임스탬프가 있는 챕터 목록 출력
- 요약(Summary): 전체 동영상에 대한 간결한 5~10문장 개요
- 챕터 요약(Chapter summaries): 각 챕터별 짧은 단락 요약이 포함된 챕터
- 스레드(Thread): 트위터/X 스레드 형식 — 번호가 매겨진 게시물, 각 최대 280자
- 블로그 게시물(Blog post): 제목, 섹션, 주요 내용이 포함된 전체 글
- 인용문(Quotes): 타임스탬프가 포함된 주요 인용문
예시 — 챕터 출력
00:00 도입 — 진행자가 문제 설명으로 시작
03:45 배경 — 선행 연구 및 기존 솔루션의 한계
12:20 핵심 방법 — 제안된 접근 방식 상세 설명
24:10 결과 — 벤치마크 비교 및 주요 시사점
31:55 Q&A — 확장성 및 다음 단계에 대한 청중 질문
작업 흐름
- 자막 가져오기:
uv run python3을 사용하여 도우미 스크립트를--text-only --timestamps옵션으로 실행합니다. - 유효성 검사: 출력이 비어 있지 않고 예상 언어인지 확인합니다. 비어 있으면
--language없이 다시 시도하여 사용 가능한 자막을 가져옵니다. 그래도 비어 있으면 사용자에게 해당 동영상에 자막이 비활성화되었을 가능성이 있다고 알립니다. - 필요시 청크 분할: 자막이 약 50,000자를 초과하면 중첩된 청크로 분할(약 40,000자, 2,000자 중첩)하여 각 청크를 요약한 후 병합합니다.
- 변환: 요청된 출력 형식으로 변환합니다. 사용자가 형식을 지정하지 않은 경우 기본적으로 요약문을 출력합니다.
- 최종 검증: 변환된 출력을 다시 읽어 일관성, 올바른 타임스탬프, 완전성을 확인한 후 제시합니다.
오류 처리
- 자막 비활성화: 사용자에게 알리고, 동영상 페이지에서 자막을 사용할 수 있는지 확인하도록 안내합니다.
- 비공개/사용 불가 동영상: 오류를 전달하고 사용자에게 URL을 확인하도록 요청합니다.
- 일치하는 언어 없음:
--language없이 다시 시도하여 사용 가능한 자막을 가져온 후, 실제 언어를 사용자에게 알립니다. - 의존성 누락:
uv pip install youtube-transcript-api를 실행하고 다시 시도합니다.