유튜브 라이브 방송 자동 요약 시스템 - 연간 730시간 절약 프로젝트
매일 2-3시간 방송을 10분으로 압축! Claude Code와 함께 만든 첫 자동화 시스템
🎯 한줄 요약
매일 2-3시간 유튜브 라이브 방송을 듣지 않고도 출연진, 주요 주제, 키워드를 자동으로 파악하는 AI 요약 시스템을 Claude Code로 구현했습니다.
💡 이런 분들께 도움돼요
관심 있는 팟캐스트/유튜브가 있지만 시간이 부족한 분
긴 영상에서 핵심만 빠르게 파악하고 싶은 분
비개발자지만 AI로 반복 업무를 자동화하고 싶은 분
Claude Code로 첫 프로젝트를 시작하는 분
📖 소개: 시도하고자 했던 것과 그 이유
문제 상황
매일 2-3시간 유튜브 라이브 방송을 전부 듣는 게 버거워서 시작했습니다. 방송 전체를 듣지 않으면 핵심 내용을 놓칠까 봐 걱정되었고, 듣자니 시간이 너무 많이 걸렸습니다. 특히 출연진이 누구인지, 어떤 내용을 말했는지 파악하는 게 가장 불편했습니다.
목표
방송 전체를 듣지 않고도 핵심 내용 파악
출연진과 주요 발언 자동 분류
관심 있는 부분만 선별해서 듣기
연간 약 730시간 절약 (하루 2시간 × 365일)
🛠️ 진행 방법: 어떤 도구를 사용했고, 어떻게 활용했나요?
사용한 도구
Claude Code - 전체 설계 및 구현
YouTube Data API - 영상 정보 수집
youtube-transcript-api - 자막 추출 (자동 생성 자막 포함)
Claude API - AI 기반 요약 생성
Python 3.13 - 스크립트 실행 환경
진행 단계
1단계: 요구사항 명확화 (/clarify)
/clarify "매일 유튜브 방송 영상의 자막과 설명글을 추출하여 출연진별로 발언 내용을 요약하고 정리하는 작업"
Claude가 4가지 질문을 통해 요구사항을 구체화했습니다:
작업 빈도: 매일
불편한 점: 출연진 파악, 발언 내용 분류
기대 효과: 선택적 청취, 시간 절약
외부 연동: Notion/Google Docs
2단계: Plan Mode로 설계
Claude가 자동으로 Plan Mode에 진입해서:
기존 코드베이스 탐색 (YouTube Collector Skill 발견)
3단계 구현 계획 수립 (Phase 1, 2, 3)
필요한 파일 목록 정리
검증 방법 제시
설계 결과:
Phase 1 (MVP): 자막 추출 → AI 요약 → 로컬 저장
Phase 2: 웹 크롤링 + Notion 연동
Phase 3: GitHub Actions 자동화 + 주간 리포트
3단계: Phase 1 MVP 구현
생성된 파일:
.env- API 키 관리ai_summarizer.py- Claude API 기반 요약 생성broadcast_summarizer.py- 통합 실행 스크립트youtube-summarizer-setup.md- 비개발자용 가이드
실행 방법:
# 1. 채널 등록
python3 register_channel.py --channel-handle @gyeomsonisnothing
# 2. 최신 영상 요약 생성
python3 broadcast_summarizer.py --channel-handle @gyeomsonisnothing --max-results 1
4단계: 실제 테스트
테스트 영상:
채널: 김어준의 겸손은힘들다 뉴스공장
자막 길이: 52,311자
처리 시간: 약 1분
생성된 요약 결과:
출연진 6명 자동 파악
주요 주제 5개 분류
키워드 15개 추출
들을만한 부분 5개 추천
겪었던 시행착오와 해결 과정
문제 1: "자막이 없다"는 오류
처음엔 YouTube 자막이 없다고 나와서 막막했습니다.
해결: 유튜브 화면을 보니 자동 생성 자막이 있는 걸 발견했고, 이를 Claude에게 알려줬습니다. Claude가 youtube-transcript-api의 API 버전 문제를 찾아내고, 직접 테스트하면서 자동 생성 자막을 가져올 수 있도록 코드를 수정했습니다.
# 수정 전 (작동 안 함)
transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
# 수정 후 (작동함)
api = YouTubeTranscriptApi()
transcript = api.fetch(video_id, languages=['ko', 'en'])
문제 2: Claude API 모델 이름 오류
claude-3-5-sonnet-20241022 모델이 404 오류를 반환했습니다.
해결: Claude가 직접 여러 모델을 테스트해서 작동하는 모델(claude-sonnet-4-20250514)을 찾아냈습니다.
문제 3: Python 환경 문제
터미널에서 python3 실행 시 패키지를 찾지 못하는 오류가 발생했습니다.
해결: Claude가 전체 Python 경로(/Users/.../miniconda3/bin/python3)를 사용하도록 명령어를 수정했습니다.
🎯 결과와 배운 점
최종 결과
Phase 1 MVP를 완성해서 실제로 유튜브 영상(52,311자 자막)을 요약하는 데 성공했습니다:
✅ 출연진 6명 자동 파악
✅ 주요 주제 5가지 분류
✅ 키워드 15개 추출
✅ Markdown 파일 자동 생성
시간 절감 효과:
현재: 방송 청취 2-3시간
자동화 후: 요약 확인 10분
연간 절감: 약 730시간 (약 30일)
가장 중요하게 배운 점
1. MVP부터 시작하자
처음부터 완벽하게 만들려고 하지 말고 Phase 1, 2, 3으로 나눠서 단계적으로 접근하니 압도되지 않고 진행할 수 있었습니다.
2. AI 협업의 현실
범용적인 실습 예제는 쉽게 만들어지지만, 실제 프로젝트는 세부적인 지침과 설정을 잘 입력해서 원하는 방향으로 개발해 나가는 것이 상당한 인 내심을 요구했습니다.
3. AI도 실수하지만 함께 해결한다
자동 생성 자막을 찾는 과정이나 API 사용법 등 삽질을 하다가도 스스로 잘못된 점을 찾아 다시 궤도로 돌아오는 것을 보니 예전보다는 많이 똑똑해졌다는 생각이 들었습니다. 동시에 아직은 세심하게 가이드하고 중요한 부분을 검증해주는 역할이 AI 협업에서 무척 중요하다는 점을 느꼈습니다.
🚀 향후 계획
Phase 2: 고도화 (2주차)
[ ] humblefactory.co.kr 웹사이트 크롤링 추가
[ ] 인터뷰 전문과 자막 통합
[ ] Notion API 연동으로 자동 저장
[ ] 관심 키워드 하이라이트 기능
Phase 3: 완전 자동화 (3주차)
[ ] GitHub Actions로 매일 자동 실행
[ ] 주간 트렌드 리포트 생성
[ ] Slack/이메일 알림 추가
추가 자동화 계획
이 프로젝트로 자신감을 얻어서, 다른 반복 업무도 자동화할 계획입니다:
주식 거래 일지 작성
바이낸스 알파 마켓 코인 거래 점수 획득
📚 재사용 가능한 프롬프트
1. 요구사항 명확화 프롬프트
/clarify "반복 업무 설명"
예시:
/clarify "매일 유튜브 방송 영상의 자막을 추출하여 출연진별로 발언 내용을 요약하고 정리하는 작업"
이 명령어가 자동으로:
작업 빈도 확인
불편한 점 파악
기대 효과 정의
외부 연동 필요 여부 확인
Task 정의서 자동 생성
2. AI 요약 프롬프트 (핵심)
prompt = f"""
다음은 "{video_title}" (방송일: {video_date}) 유튜브 라이브 방송의 전체 자막입니다.
<transcript>
{transcript_text}
</transcript>
다음 형식으로 요약해주세요:
## 출연진
- [이름] (역할)
## 주요 주제 및 타임라인
1. **[주제명]** (예상 시간대)
- 발언자: [이름]
- 핵심 내용: ...
## 출연진별 주요 발언
### [출연진 이름]
- **[주제]**: 발언 요약...
## 주요 키워드
- #키워드1 #키워드2 ...
## 들을만한 부분 (관심도 높은 순)
1. **[주제]** - 이유: ...
"""
3. Python 환경 문제 해결
패키지를 찾지 못할 때:
# 전체 경로 사용
/Users/사용자명/miniconda3/bin/python3 script.py
# 또는 which python3로 경로 확인
which python3
🔗 도움 받은 자료
gpters 20기 프리랜서 자동화 템플릿
이 프로젝트 템플릿이 정말 유용했습니다:
주 요 명령어:
/setup-workspace- 프로필 설정 및 초기 환경 구성/clarify- 요구사항 명확화/ai-case-writer- 사례글 자동 작성
특징:
비개발자도 따라할 수 있는 단계별 가이드
Plan Mode로 체계적인 설계
YouTube Collector Skill 기본 제공
추천 이유: 4주 만에 자동화 사례 3개를 완성하는 것을 목표로 하며, Claude Code 입문자에게 최적화된 템플릿입니다.
💬 마치며
비개발자였던 제가 하루 만에 실제로 작동하는 자동화 시스템을 만들 수 있었던 건 Claude Code 덕분입니다.
가장 인상적이었던 점은:
막히면 스스로 해결책을 찾아가는 Claude의 문제 해결 능력
Plan Mode로 체계적으로 설계하는 방식
비개발자도 이해할 수 있는 친절한 가이드
앞으로 Phase 2, 3를 진행하면서 더 발전된 시스템을 만들어 다시 공유하겠습니다!
질문이나 비슷한 프로젝트를 시도하시는 분들은 댓글로 소통해요! 🚀
작성일: 2026-01-18 작성자: 강수혁 프로젝트 저장소: gpters-20th-duwls-templates-main
