YouTube 요약기 스킬은(는) 무엇을 하나요?
YouTube 영상의 트랜스크립트를 자동으로 가져오고, 구조화된 요약을 생성하며, 전체 트랜스크립트를 메시징 플랫폼으로 전송합니다.
모드
컨텍스트에서 감지하거나 질문: "빠른 TL;DR, 전체 요약, 아니면 콘텐츠 각도가 포함된 전체 요약?"
| 모드 | 제공 내용 | 최적 사용처 |
|---|---|---|
quick | 3개 항목 TL;DR + 핵심 교훈 1개 | 빠른 소비, 클립 공유 |
standard | 전체 구조화 요약: 주장, 통찰, 교훈 | 학습, 노트 작성, 연구 |
deep | 전체 요약 + 챕터 분석 + 콘텐츠 재활용 기회 | 영상을 콘텐츠 자산으로 전환 |
기본값: standard — 간단한 요지만 원하면 quick을 사용. 영상에서 사용 가능한 콘텐츠를 추출하려면 deep을 사용.
ChatGPT보다 나은 이유
ChatGPT의 문제점: YouTube 트랜스크립트에 직접 접근할 수 없습니다. 자막을 수동으로 복사/붙여넣기하거나 타사 도구를 먼저 사용한 후 텍스트를 ChatGPT에 제공해야 합니다. 여러 단계를 거쳐야 하고 번거로우며 영상 메타데이터가 손실됩니다.
이 스킬이 제공하는 것:
- 한 단계 트랜스크립트 추출 - YouTube URL을 입력하면 자동으로 전체 트랜스크립트 획득
- 구조화된 요약 - 매번 일관된 형식(주장 → 통찰 → 교훈), 무작위 글머리 기표가 아님
- 영상 메타데이터 포함 - 제목, 채널, 조회수, 게시일이 요약에 포함
- 전체 트랜스크립트 전송 - 타임스탬프가 포함된 트랜스크립트를 파일로 저장하고 Telegram/채팅 플랫폼으로 전송
- VPS/클라우드에서 작동 - Android 클라이언트 에뮬레이션을 사용하여 YouTube의 클라우드 IP 차단 우회(yt-dlp 실패 시)
- 다국어 지원 - 요청된 언어로 자동 가져오기, 영어 폴백
직접 복제 가능: 자막을 수동으로 활성화하고, 텍스트를 복사하고, ChatGPT에 붙여넣고, 출력을 재포맷하고, 파일에 저장하고, 업로드합니다. 5-10분 소요. 이 스킬은 15-20초 만에 처리합니다.
사용 시기
다음 경우에 이 스킬을 활성화하세요:
- 사용자가 YouTube URL 공유 (youtube.com/watch, youtu.be, youtube.com/shorts)
- 사용자가 YouTube 영상 요약 또는 트랜스크립트 작성을 요청
- 사용자가 YouTube 영상 콘텐츠에 대한 정보 요청
- 연구 또는 콘텐츠 제작을 위해 영상 콘텐츠를 분석해야 하는 경우
종속성
필수: MCP YouTube Transcript 서버가 다음 위치에 설치되어야 함:
/root/clawd/mcp-server-youtube-transcript
설치되지 않은 경우 설치:
cd /root/clawd
git clone https://github.com/kimtaeyoon83/mcp-server-youtube-transcript.git
cd mcp-server-youtube-transcript
npm install && npm run build
워크플로
1. YouTube URL 감지
다음 패턴에서 비디오 ID 추출:
https://www.youtube.com/watch?v=VIDEO_IDhttps://youtu.be/VIDEO_IDhttps://www.youtube.com/shorts/VIDEO_ID- 직접 비디오 ID:
VIDEO_ID(11자)
2. 트랜스크립트 가져오기
트랜스크립트를 얻으려면 다음 명령 실행:
cd /root/clawd/mcp-server-youtube-transcript && node --input-type=module -e "
import { getSubtitles } from './dist/youtube-fetcher.js';
const result = await getSubtitles({ videoID: 'VIDEO_ID', lang: 'en' });
console.log(JSON.stringify(result, null, 2));
" > /tmp/yt-transcript.json
VIDEO_ID를 추출된 ID로 교체하세요. /tmp/yt-transcript.json에서 출력을 읽으세요.
3. 데이터 처리
JSON을 파싱하여 추출:
result.metadata.title- 영상 제목result.metadata.author- 채널 이름result.metadata.viewCount- 형식화된 조회수result.metadata.publishDate- 게시일result.actualLang- 사용된 언어result.lines- 트랜스크립트 세그먼트 배열
전체 텍스트: result.lines.map(l => l.text).join(' ')
4. 요약 생성
다음 템플릿을 사용하여 구조화된 요약 생성:
📹 **영상:** [title]
👤 **채널:** [author] | 👁️ **조회수:** [views] | 📅 **게시:** [date]
**🎯 핵심 주장:**
[1-2문장 핵심 주장/메시지]
**💡 주요 통찰:**
- [통찰 1]
- [통찰 2]
- [통찰 3]
- [통찰 4]
- [통찰 5]
**📝 주목할 점:**
- [추가 포인트 1]
- [추가 포인트 2]
**🔑 교훈:**
[실용적 적용 또는 결론]
목표:
- 핵심 주장: 최대 1-2문장
- 주요 통찰: 3-5개 글머리 기표, 각 1-2문장
- 주목할 점: 2-4개 세부 정보
- 교훈: 실행 가능한 결론
5. 전체 트랜스크립트 저장
완전한 트랜스크립트를 타임스탬프 파일로 저장:
/root/clawd/transcripts/YYYY-MM-DD_VIDEO_ID.txt
파일에 포함:
- 영상 메타데이터 헤더 (제목, 채널, URL, 날짜)
- 전체 트랜스크립트 텍스트
- 쉬운 조회를 위한 URL 참조
6. 플랫폼별 전송
채널이 Telegram인 경우:
message --action send --channel telegram --target CHAT_ID \
--filePath /root/clawd/transcripts/YYYY-MM-DD_VIDEO_ID.txt \
--caption "📄 YouTube 트랜스크립트: [title]"
채널이 기타/웹챗인 경우: 요약만 회신 (파일 첨부 없음).
7. 요약 회신
구조화된 요약을 사용자에게 응답으로 전송.
실제 사례 연구
사용자: 경쟁사 YouTube 전략을 연구하는 콘텐츠 크리에이터
과제: 주 20개 이상의 경쟁사 영상을 분석하여 트렌드 주제, 메시징 패턴, 콘텐츠 격차 식별 필요. 수동 프로세스: 영상 시청, 노트 작성, 주요 인용문 트랜스크립트. 영상당 30-45분 소요.
youtube-summarizer를 사용한 솔루션:
- 채팅에 YouTube URL 입력
- 20초 만에 구조화된 요약 획득
- 전체 트랜스크립트가 참조용으로 저장됨
- 콘텐츠 계획 문서를 위한 주요 통찰 복사
워크플로 예시:
사용자: 이 영상 분석: https://youtube.com/watch?v=abc123
[20초 후]
📹 영상: "10 AI Tools That Will Replace Your Job in 2026"
👤 채널: TechFuturist | 👁️ 조회수: 847K | 📅 게시: Jan 12, 2026
🎯 핵심 주장:
AI 도구는 예상보다 빠르게 창의적 및 지식 작업을 자동화하고 있지만, 진정한 기회는 대체가 아닌 증강에 있습니다.
💡 주요 통찰:
- 마케터의 ChatGPT 사용률이 1년 만에 12%에서 67%로 급증
- 비디오 편집 시간이 Descript 같은 AI 도구로 80% 감소
- 가장 큰 성과는 도구 결합에서 비롯됨 (Notion + Claude + Zapier)
- 기업들은 인간-AI 협업 최적화를 위해 "AI 워크플로 디자이너" 고용 중
- AI를 비밀리에 사용하는 작업자는 동료보다 40% 더 높은 성과 (BCG 연구)
📝 주목할 점:
- AI로 10배 생산성을 달성한 3개 소규모 비즈니스 사례 제시
- 과도한 자동화 경고: "AI는 쓸 수 있지만 전략적으로 생각할 수 없다"
🔑 교훈:
"AI가 나를 대체할까?"라고 묻지 말고 "AI를 어떻게 사용하여 10배 더 가치가 될까?"라고 물어보세요.
8주 후 결과:
- 절약된 시간: 주 25시간 (20개 영상에 600분에서 60분으로)
- 콘텐츠 출력: 주 3개 영상 (주 1개에서 증가)
- 더 나은 통찰: 전체 트랜스크립트 검색 가능, 시청만으로는 놓친 패턴 발견
- 경쟁 정보: 160개 이상의 경쟁사 영상 요약 데이터베이스 구축 (주요 인용문 포함)
- ROI 인용: "이 스킬은 경쟁사 연구를 잡일에서 조립 라인으로 바꿔놓았습니다."
수동 방법보다 나은 이유
| 방법 | 시간 | 메타데이터 획득 | 구조화된 출력 | 검색 가능한 아카이브 | 클라우드 친화적 |
|---|---|---|---|---|---|
| 시청 + 노트 작성 | 30-45분 | 아니요 | 아니요 | 수동 전용 | 해당 없음 |
| YouTube 트랜스크립트 기능 | 5분 | 아니요 | 아니요 | 아니요 | 예 |
| yt-dlp | 2-5분 | 예 | 아니요 | 예 | ❌ VPS에서 차단 |
| ChatGPT에 복사 | 10분 | 아니요 | 가끔 | 아니요 | 예 |
| 이 스킬 | 20초 | 예 | 예 | 예 | ✅ VPS에서 작동 |
오류 처리
트랜스크립트 가져오기 실패 시:
- 영상에 자막이 활성화되어 있는지 확인
- 요청한 언어를 사용할 수 없는 경우
lang: 'en'폴백 시도 - 트랜스크립트를 사용할 수 없음을 사용자에게 알리고 대안 제시:
- 수동 YouTube 트랜스크립트 기능 (설정 → 트랜스크립트 표시)
- 영상에 자막이 없을 수 있음
- 다른 영상 시도
MCP 서버가 설치되지 않은 경우:
- 설치 지침 제공
- 적절한 컨텍스트에서 자동 설치 제안
비디오 ID 추출 실패 시:
- 사용자에게 전체 YouTube URL 또는 비디오 ID 제공 요청
영상이 연령 제한 또는 비공개인 경우:
- 제한으로 인해 트랜스크립트에 접근할 수 없음을 사용자에게 알림
- 영상 개인정보 설정 확인 제안
예시
예시 1: 기술 튜토리얼
입력: https://youtube.com/watch?v=dQw4w9WgXcQ
출력:
📹 **영상:** "SaaS를 처음부터 구축하기: $10K MRR에서 얻은 교훈"
👤 **채널:** IndieHackerTV | 👁️ **조회수:** 124K | 📅 **게시:** Feb 1, 2026
**🎯 핵심 주장:**
대부분의 SaaS 창업자는 고객과 대화하기 전에 6개월 동안 구축하기 때문에 실패합니다. $10K MRR로 가는 길은 고객 대화가 먼저, MVP가 그 다음입니다.
**💡 주요 통찰:**
- 코드 한 줄 쓰기 전에 50명의 잠재 고객 인터뷰
- 첫 유료 고객은 Figma 목업으로 가입 (제품이 아직 구축되지 않음)
- 첫날부터 월 $99 청구 (무료 티어 없음, 할인 없음)
- 광고에 $0 지출; 모든 성장은 Twitter + Reddit 참여에서 비롯
- ICP에 맞지 않는 기능 요청에 "아니요"라고 말함으로써 9개월 만에 $10K MRR 달성
**📝 주목할 점:**
- 청구 시스템 구축 전에 Stripe 결제 링크 사용
- 첫 3명의 고객은 Twitter에서 공개적으로 그들의 문제를 해결함으로써 확보
- 주간 "공개 구축" Twitter 업데이트가 가입의 40% 유도
**🔑 교훈:**
구축하기 전에 수요를 검증하세요. 10명이 목업에 비용을 지불하지 않으면, 1,000명도 실제 제품에 비용을 지불하지 않습니다.
예시 2: 비즈니스 전략 영상
입력: https://youtu.be/abc123xyz
출력:
📹 **영상:** "Notion의 비즈니스 모델이 천재적인 이유"
👤 **채널:** SaaS Breakdowns | 👁️ **조회수:** 456K | 📅 **게시:** Jan 28, 2026
**🎯 핵심 주장:**
Notion의 성장 전략은 전통적인 SaaS를 뒤집습니다: 개인에게 제품을 무료로 제공하고, 업무에 가져갈 때 수익을 창출합니다.
**💡 주요 통찰:**
- Notion의 엔터프라이즈 거래 중 80%는 무료 플랜을 사용하는 단일 직원에서 시작
- 바텀업 채택 = 첫 $10M ARR에 영업팀 불필요
- 템플릿 마켓플레이스가 콘텐츠 플라이휠 생성 (100K+ 무료 템플릿)
- 개인 사용(무료) → 팀 사용(유료) 전환율: 23% (업계 평균: 2-5%)
- 커뮤니티 전도가 전통적인 마케팅 대체 (4M+ Reddit/Discord 회원)
**📝 주목할 점:**
- Notion의 바이럴 계수: 1.4 (모든 사용자는 평균적으로 1.4명 초대)
- 템플릿 제작자가 신규 사용자 확보의 30% 유도
- 가격 전략: 10명까지 무료 = 시작 마찰 없음
**🔑 교훈:**
먼저 개인이 사랑하는 제품을 구축하세요. 직원들이 업무에서 요구할 때 엔터프라이즈 판매가 따라올 것입니다.
품질 지침
- 간결하게: 요약은 30초 안에 훑어볼 수 있어야 함
- 정확하게: 트랜스크립트에 없는 정보를 추가하지 마세요
- 구조화되게: 일관된 형식을 사용하여 쉽게 읽을 수 있도록 하세요
- 컨텍스트에 맞게: 영상 길이에 따라 세부 수준 조정
- 짧은 영상 (<5분): 간략한 요약 (핵심 통찰 3개)
- 중간 영상 (5-30분): 표준 형식 (핵심 통찰 5개)
- 긴 영상 (>30분): 상세 분석 (통찰 7개 이상, 필요한 경우 섹션으로 분할)
- 가치 추출: 일반적인 조언이 아닌, 실행 가능한 통찰, 데이터 포인트, 반대 의견에 집중
프로 팁
더 나은 요약을 위해:
- 데이터 포인트 우선시 - 숫자, 백분율, 연구 인용이 돋보임
- 인용문 추출 - 기억에 남는 한 줄은 요약을 공유 가능하게 만듦
- 프레임워크 식별 - 영상이 방법/프로세스를 제시하면 단계 추출
- 반대 의견 발견 - 비전통적인 지혜가 일반적인 조언보다 더 가치 있음
- 증거 기록 - 예시, 사례 연구, 전후 결과가 신뢰성 추가
연구 워크플로를 위해:
- 트랜스크립트 라이브러리 구축 - 패턴 발견을 위해 주제/분야별로 정리
- 트랜스크립트 간 검색 -
grep또는 텍스트 검색을 사용하여 특정 주제 언급 찾기 - 트렌드 추적 - 여러 영상에 걸친 동일 주제 = 떠오르는 트렌드
- 프롬프트 추출 - 유용한 프레임워크/방법을 재사용 가능한 프롬프트로 저장
콘텐츠 제작을 위해:
- 콘텐츠 격차 찾기 - 어떤 질문이 제기되었지만 완전히 답변되지 않았는가?
- 상위 성과자 분석 - 높은 조회수의 영상은 어떤 구조/속도를 사용하는가?
- 후크 추출 - 트랜스크립트의 처음 30초 = 입증된 후크 패턴
- 통찰 재활용 - 영상 통찰을 Twitter 스레드, 블로그 게시물, 뉴스레터로 전환
구성
표준 모드 (기본값)
youtube-summarizer [URL]
- 영어로 트랜스크립트 가져오기
- 구조화된 요약 생성
- 트랜스크립트를 파일로 저장
- 해당하는 경우 메시징 플랫폼으로 전송
빠른 모드
youtube-summarizer [URL] --quick
- 주장 + 핵심 통찰 3개만
- 트랜스크립트 파일 저장 안 함
- 빠른 연구를 위한 더 빠른 처리
심층 모드
youtube-summarizer [URL] --deep
- 타임스탬프가 포함된 확장 요약
- 긴 영상을 위한 섹션별 분석
- 모든 주목할 인용문 포함
언어 지정
youtube-summarizer [URL] --lang es
- 지정된 언어로 트랜스크립트 가져오기
- 사용 불가능한 경우 영어로 폴백
설치 및 설정
# 1. MCP 서버 복제 및 설치
cd /root/clawd
git clone https://github.com/kimtaeyoon83/mcp-server-youtube-transcript.git
cd mcp-server-youtube-transcript
npm install && npm run build
# 2. 설치 테스트
node --input-type=module -e "
import { getSubtitles } from './dist/youtube-fetcher.js';
const result = await getSubtitles({ videoID: 'dQw4w9WgXcQ', lang: 'en' });
console.log(result.metadata.title);
"
# 3. 트랜스크립트 디렉토리 생성
mkdir -p /root/clawd/transcripts
# 4. 스킬 준비 확인
youtube-summarizer --check-setup
일반적인 문제
문제: "트랜스크립트를 사용할 수 없음"
- 원인: 영상에 자막/자막이 활성화되어 있지 않음
- 해결책: 영상 제작자에게 자막 활성화를 요청하거나 다른 영상 시도
문제: "트랜스크립트를 가져오지 못함" (VPS에서)
- 원인: YouTube API가 업데이트되었을 수 있음
- 해결책: MCP 서버 업데이트:
cd /root/clawd/mcp-server-youtube-transcript && git pull && npm install && npm run build
문제: "비디오 ID를 인식할 수 없음"
- 원인: URL 형식이 잘못되었거나 지원되지 않는 형식
- 해결책: 전체 YouTube URL 또는 비디오 ID를 제공하도록 사용자에게 요청