Jane-xiaoer/claude-skill-video-transcribe

VideoTranscribe

AI 기반 동영상/오디오 전사 도구. 자막이 있으면 자막을 추출하고, 없으면 AI로 받아쓰기합니다. YouTube, Bilibili, 로컬 파일을 모두 지원합니다.

기능

• 로컬 파일 전사: MP4, MOV, MP3, M4A 등 지원, ffmpeg가 자동으로 오디오 추출
• URL 전사: YouTube, Bilibili, 小宇宙(Xiaoyuzhou) 등 yt-dlp가 지원하는 모든 플랫폼
• 자막 우선 전략: 자막이 있으면 바로 추출(빠르고 API 비용 0), 없으면 오디오를 다운로드하여 전사
• 두 가지 엔진: Gemini 2.5 Flash(구두점 포함, 권장) / mlx-whisper(로컬 오프라인)
• 내용 요약: 세 가지 모드 – 빠른 요약 / 구조화된 노트 / 콘텐츠 재창작

빠른 시작

# 로컬 동영상 전사
python3 Tools/transcribe.py --input "video.mp4"

# YouTube 동영상 전사
python3 Tools/transcribe.py --input "https://youtu.be/xxx"

# Bilibili 동영상 전사
python3 Tools/transcribe.py --input "https://www.bilibili.com/video/BVxxx"

# 로컬 mlx-whisper 사용 (오프라인)
python3 Tools/transcribe.py --input "video.mp4" --engine mlx

# 출력 경로 지정
python3 Tools/transcribe.py --input "video.mp4" --output ~/Desktop/result.txt

의존성 설치

# 필수
pip3 install google-genai    # Gemini 엔진 (권장)
brew install yt-dlp ffmpeg   # 오디오 처리

# 선택 사항 (로컬 오프라인 엔진)
pip3 install mlx-whisper     # Apple Silicon 전용

API Key 설정

Gemini 엔진은 API Key가 필요하며, Google AI Studio에서 무료로 신청 가능합니다:

# 방법 1: 환경 변수
export GEMINI_API_KEY="your-key"

# 방법 2: 파일에 작성 (PAI 사용자 권장)
echo 'GEMINI_API_KEY=your-key' >> ~/.shared-skills/api-registry/.env

엔진 비교

다양한 AI Agent 연동

직접 호출 (모든 플랫폼 공통)

모든 AI Agent는 run.sh를 실행하거나 Python 스크립트를 직접 호출하면 됩니다:

# 공통 진입점 (권장)
bash /path/to/VideoTranscribe/run.sh --input "video.mp4"

# 또는 스크립트 직접 호출
python3 /path/to/VideoTranscribe/Tools/transcribe.py --input "video.mp4"

Claude Code

이 디렉토리를 ~/.shared-skills/에 넣고 자연어로 바로 트리거:

"이 동영상을 텍스트로 변환해줘"

"이 YouTube 링크 내용을 전사해줘"

OpenClaw / Codex / Gemini CLI

에이전트의 도구 호출 또는 bash 실행에서 직접 작성:

bash ~/.shared-skills/VideoTranscribe/run.sh --input "{{ input_url_or_path }}"

스크립트가 자동으로 Gemini API Key를 로드하고 전사 결과를 반환합니다.

파일 구조

VideoTranscribe/
├── SKILL.md              # Claude Code skill 진입점
├── Workflows/
│   ├── Transcribe.md     # 전사 워크플로우
│   └── Extract.md        # 요약 워크플로우 (3가지 모드)
└── Tools/
    └── transcribe.py     # 핵심 스크립트

라이선스

MIT