---
slug: "claude-skill-youtube-kr-subtitle"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/Koomook/claude-skill-youtube-kr-subtitle@main/README.md"
repo: "https://github.com/Koomook/claude-skill-youtube-kr-subtitle"
source_file: "README.md"
branch: "main"
---
# YouTube Korean Subtitle Auto-Insertion Service

YouTube 영상에 한글 자막을 자동으로 만들어 넣는 프로젝트입니다. Claude가 영상을 다운로드하고, 영어 자막을 이해한 후 맥락을 고려하여 한글로 번역하고, 최종적으로 영상에 자막을 직접 합성합니다.

## 이 프로젝트의 특별한 점

일반적인 자동 번역 도구와 달리, 이 프로젝트는 **Claude의 이해 능력**을 활용합니다. 단순히 문장을 번역하는 것이 아니라, 영상의 주제를 파악하고 관련 정보를 웹에서 찾아보며, 전문 용어를 일관되게 번역하고, 문화적 맥락을 고려합니다.

### 어떻게 작동하나요?

Claude Code에서 프로젝트를 열고 이렇게 말하면 됩니다:
```
"이 유튜브 영상에 한글 자막 넣어줘: https://youtube.com/watch?v=..."
```

그러면 Claude가 자동으로 전체 과정을 진행합니다.

## 무엇을 할 수 있나요?

**자동 영상 처리**
- YouTube 영상과 영어 자막을 자동으로 가져옵니다
- 자막의 기술적 문제(겹치는 타이밍, 중복 등)를 자동으로 해결합니다
- 완성된 영상에는 한글 자막이 영구적으로 합성되어 있습니다

**똑똑한 번역**
- Claude가 영상의 제목, 설명, 내용을 모두 분석합니다
- 웹에서 관련 정보를 찾아 전문 용어를 정확히 번역합니다
- 영상의 분위기(교육적, 캐주얼, 공식적 등)에 맞춰 번역 스타일을 조절합니다
- 한국어로 자연스럽게 읽히도록 문장 구조를 재구성합니다

**품질 보장**
- 번역 전후의 자막 개수가 정확히 일치하는지 검증합니다
- 전문 용어의 일관성을 유지합니다
- 자막 타이밍과 번역이 정확히 동기화됩니다

## 시작하기

### 필요한 것

- Python 3.7 이상이 설치되어 있어야 합니다
- FFmpeg이 설치되어 있어야 합니다 (영상 처리 도구)
- Claude Code에서 이 프로젝트를 열어야 합니다

자세한 설정 방법은 `.claude/skills/youtube-kr-subtitle/SKILL.md` 파일을 참고하세요.

## 작동 원리

이 프로젝트는 크게 6단계로 작동합니다:

**1단계: 영상 가져오기**
YouTube에서 영상과 영어 자막을 다운로드합니다. 영상의 제목, 설명, 길이 같은 정보도 함께 수집합니다.

**2단계: 자막 정리**
YouTube 자막은 종종 기술적 문제가 있습니다. 타이밍이 겹치거나, 같은 내용이 반복되거나, 너무 짧게 쪼개져 있는 경우가 많습니다. 이 단계에서 이런 문제들을 자동으로 해결하고, 자막을 자연스러운 문장 단위로 묶습니다.

**3단계: 맥락 파악**
Claude가 영상을 분석합니다. 어떤 주제인지, 어떤 전문 용어가 사용되는지, 어떤 분위기인지 파악합니다. 

[중요] 반드시 웹에서 관련 정보를 찾아봅니다.

**4단계: 번역**
단순 기계 번역이 아닌, 맥락을 이해한 번역을 합니다. 전문 용어는 일관되게 번역하고, 영상의 분위기에 맞게 문체를 조절하며, 한국어로 자연스럽게 읽히도록 문장을 재구성합니다.

**5단계: 자막 파일 생성**
번역된 내용을 원본 자막의 타이밍 정보와 결합하여 한글 자막 파일을 만듭니다.

**6단계: 영상 합성**
FFmpeg을 사용하여 한글 자막을 영상에 직접 합성합니다. 완성된 영상은 자막이 영구적으로 포함되어 있어 별도의 자막 파일 없이도 볼 수 있습니다.

## 기술적 특징

**자막 타이밍 문제 자동 해결**
YouTube 자동 생성 자막은 "롤링 캡션" 방식을 사용하여 의도적으로 타이밍이 겹칩니다. 이 프로젝트는 이를 자동으로 감지하고 수정하여 깔끔한 자막을 만듭니다.

**번역 품질 검증**
번역 전후의 자막 개수가 정확히 일치하는지 자동으로 확인합니다. 이를 통해 자막과 타이밍이 어긋나는 것을 방지합니다.

**자동 문장 병합**
너무 짧게 쪼개진 자막을 자연스러운 문장 단위로 묶어줍니다. 이렇게 하면 번역 품질이 더 좋아지고, 자막을 읽기도 편해집니다.

## 현재 제한사항

- 영어 자막이 있는 영상만 처리할 수 있습니다 (자동 생성 자막도 가능)
- 자막이 전혀 없는 영상은 현재 지원하지 않습니다
- 긴 영상은 처리 시간이 오래 걸릴 수 있습니다

## 프로젝트 구조

프로젝트 파일은 다음과 같이 구성되어 있습니다:

- `.claude/skills/youtube-kr-subtitle/` - Claude Code 스킬의 핵심 부분
  - `SKILL.md` - 상세한 사용 방법과 워크플로우 설명
  - `scripts/` - 각 단계를 처리하는 Python 스크립트들
- `downloads/` - 다운로드한 영상과 원본 자막 임시 저장소
- `output/` - 한글 자막이 합성된 최종 영상 저장소

## 더 알아보기

기술적인 세부사항이나 스크립트 사용법이 궁금하다면 `.claude/skills/youtube-kr-subtitle/SKILL.md` 파일을 참고하세요. 각 단계의 상세한 설명과 예시가 포함되어 있습니다.

## 저작권 관련

이 프로젝트는 교육 및 공익 목적으로 제공됩니다. 원본 영상의 저작권은 원저작권자에게 있으며, YouTube 시스템을 통해 저작권 허가를 확인합니다. 본 도구는 교육, 동기부여, 아이디어 공유 등의 목적으로 사용되며, YouTube 수익은 전혀 발생하지 않습니다.

삭제, 수정 등 요청사항이 있으시면 문의해주시기 바랍니다.