YouTube Analyzer 🎥

YouTube 동영상의 자막을 추출하고 AI로 분석하는 웹 애플리케이션

✨ 주요 기능

• 🔍 자막 추출: YouTube 영상의 자막을 자동으로 추출
• 🤖 AI 분석: OpenAI GPT-4를 활용한 내용 분석
• 📝 요약 생성: 핵심 내용 요약 및 주요 포인트 정리
• ✅ 할 일 목록: 영상 내용 기반 실행 가능한 작업 목록 생성

🚀 데모

라이브 데모: https://youtube-analyzer-723711118891.us-central1.run.app

🛠 기술 스택

• Frontend: Next.js 15.4.6, TypeScript, TailwindCSS
• Backend: Next.js API Routes, Python
• 자막 추출: Playwright (브라우저 자동화)
• AI: OpenAI GPT-4o-mini
• 배포: Google Cloud Run, Docker

📋 필수 요구사항

• Node.js 20.0 이상
• Python 3.8 이상
• OpenAI API 키

🔧 설치 및 실행

1. 저장소 클론

git clone https://github.com/kkopd/youtube-analyzer.git
cd youtube-analyzer

2. 의존성 설치

# Node.js 패키지 설치
npm install

# Python 가상환경 생성 및 활성화
python3 -m venv venv
source venv/bin/activate  # Mac/Linux
# Windows: venv\Scripts\activate

# Python 패키지 설치
pip install -r python_transcript_service/requirements.txt

# Playwright 브라우저 설치
playwright install chromium

3. 환경변수 설정

# .env.local 파일 생성
cp .env.example .env.local

.env.local 파일에 OpenAI API 키 추가:

OPENAI_API_KEY=your-openai-api-key-here

4. 개발 서버 실행

npm run dev

브라우저에서 http://localhost:3000 접속

📦 프로덕션 배포

Google Cloud Run 배포

1. Google Cloud 프로젝트 설정

gcloud config set project YOUR_PROJECT_ID

2. Docker 이미지 빌드 및 푸시

gcloud builds submit --config cloudbuild.yaml

3. Cloud Run 서비스 배포

gcloud run deploy youtube-analyzer \
  --image gcr.io/YOUR_PROJECT_ID/youtube-analyzer:latest \
  --region us-central1 \
  --platform managed \
  --allow-unauthenticated \
  --port 8080 \
  --memory 2Gi \
  --cpu 2 \
  --timeout 300 \
  --set-env-vars="OPENAI_API_KEY=your-api-key"

📖 사용 방법

1. YouTube 동영상 URL 입력
2. "분석 시작" 버튼 클릭
3. 자막 추출 대기 (약 30초~1분)
4. AI 분석 결과 확인
   • 요약
   • 핵심 포인트
   • 할 일 목록
   • 전체 자막

🐛 트러블슈팅

자막 추출 실패

• YouTube 영상에 자막이 있는지 확인
• 타임아웃 설정 확인 (최소 2분 권장)
• 브라우저 캐시 정리 후 재시도

AI 분석 실패

• OpenAI API 키 유효성 확인
• API 사용량 한도 확인
• 환경변수 설정 확인

배포 관련 문제

자세한 트러블슈팅 가이드는 CLAUDE.md 참조

📄 라이선스

MIT License

🤝 기여

프로젝트 기여는 언제나 환영합니다!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📞 문의

• GitHub Issues: https://github.com/kkopd/youtube-analyzer/issues
• Email: [프로젝트 관리자 이메일]

🙏 감사의 말

• OpenAI - GPT API 제공
• Playwright Team - 브라우저 자동화 도구
• Next.js Team - 프레임워크
• Claude Code - 개발 지원

---

현재 버전: v1.0.0-stable (2025.08.18)

이 프로젝트는 Claude Code와 함께 개발되었습니다 🤖