Communitygithub.com

YouTube 요약기 스킬

YouTube URL을 감지하여 자동으로 트랜스크립트를 가져오고, 구조화된 요약을 생성하며, 전체 트랜스크립트를 메시징 플랫폼으로 전송합니다. 메타데이터, 핵심 통찰, 다운로드 가능한 트랜스크립트를 제공합니다.

YouTube 요약기 스킬란 무엇인가요?

이 스킬은 YouTube 영상의 트랜스크립트를 자동으로 가져와 구조화된 요약(핵심 주장, 주요 통찰, 실용적 결론 포함)을 생성하고, 타임스탬프가 포함된 전체 트랜스크립트를 파일로 저장한 후 Telegram과 같은 메시징 플랫폼으로 전송합니다. 사용자가 YouTube URL을 공유하거나 요약/트랜스크립트 작성을 요청할 때 활성화됩니다. 'quick'(3줄 TL;DR), 'standard'(전체 구조화 요약), 'deep'(챕터별 분석 및 콘텐츠 재활용 기회)의 세 가지 모드를 지원하며, 기본 모드는 'standard'입니다. 이 스킬은 yt-dlp가 VPS/클라우드 환경에서 차단될 때 Android 클라이언트 에뮬레이션을 통해 우회하며, MCP YouTube Transcript 서버를 설치하여 작동합니다. 다국어를 지원하며(요청된 언어로 가져오고 영어로 폴백), 메타데이터(제목, 채널, 조회수, 게시일)를 포함한 일관된 출력을 제공합니다. 수동 방법(5-10분) 대비 15-20초 만에 작업을 완료하여, 경쟁사 분석, 콘텐츠 연구, 학습에 이상적입니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ever-just/agentskills/tree/HEAD/skills/white-paper-writing/ai-marketing-skills/youtube-summarizer

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

YouTube 요약기 스킬은(는) 무엇을 하나요?

YouTube 영상의 트랜스크립트를 자동으로 가져오고, 구조화된 요약을 생성하며, 전체 트랜스크립트를 메시징 플랫폼으로 전송합니다.

모드

컨텍스트에서 감지하거나 질문: "빠른 TL;DR, 전체 요약, 아니면 콘텐츠 각도가 포함된 전체 요약?"

모드제공 내용최적 사용처
quick3개 항목 TL;DR + 핵심 교훈 1개빠른 소비, 클립 공유
standard전체 구조화 요약: 주장, 통찰, 교훈학습, 노트 작성, 연구
deep전체 요약 + 챕터 분석 + 콘텐츠 재활용 기회영상을 콘텐츠 자산으로 전환

기본값: standard — 간단한 요지만 원하면 quick을 사용. 영상에서 사용 가능한 콘텐츠를 추출하려면 deep을 사용.


ChatGPT보다 나은 이유

ChatGPT의 문제점: YouTube 트랜스크립트에 직접 접근할 수 없습니다. 자막을 수동으로 복사/붙여넣기하거나 타사 도구를 먼저 사용한 후 텍스트를 ChatGPT에 제공해야 합니다. 여러 단계를 거쳐야 하고 번거로우며 영상 메타데이터가 손실됩니다.

이 스킬이 제공하는 것:

  1. 한 단계 트랜스크립트 추출 - YouTube URL을 입력하면 자동으로 전체 트랜스크립트 획득
  2. 구조화된 요약 - 매번 일관된 형식(주장 → 통찰 → 교훈), 무작위 글머리 기표가 아님
  3. 영상 메타데이터 포함 - 제목, 채널, 조회수, 게시일이 요약에 포함
  4. 전체 트랜스크립트 전송 - 타임스탬프가 포함된 트랜스크립트를 파일로 저장하고 Telegram/채팅 플랫폼으로 전송
  5. VPS/클라우드에서 작동 - Android 클라이언트 에뮬레이션을 사용하여 YouTube의 클라우드 IP 차단 우회(yt-dlp 실패 시)
  6. 다국어 지원 - 요청된 언어로 자동 가져오기, 영어 폴백

직접 복제 가능: 자막을 수동으로 활성화하고, 텍스트를 복사하고, 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_ID
  • https://youtu.be/VIDEO_ID
  • https://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를 사용한 솔루션:

  1. 채팅에 YouTube URL 입력
  2. 20초 만에 구조화된 요약 획득
  3. 전체 트랜스크립트가 참조용으로 저장됨
  4. 콘텐츠 계획 문서를 위한 주요 통찰 복사

워크플로 예시:

사용자: 이 영상 분석: 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-dlp2-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개 이상, 필요한 경우 섹션으로 분할)
  • 가치 추출: 일반적인 조언이 아닌, 실행 가능한 통찰, 데이터 포인트, 반대 의견에 집중

프로 팁

더 나은 요약을 위해:

  1. 데이터 포인트 우선시 - 숫자, 백분율, 연구 인용이 돋보임
  2. 인용문 추출 - 기억에 남는 한 줄은 요약을 공유 가능하게 만듦
  3. 프레임워크 식별 - 영상이 방법/프로세스를 제시하면 단계 추출
  4. 반대 의견 발견 - 비전통적인 지혜가 일반적인 조언보다 더 가치 있음
  5. 증거 기록 - 예시, 사례 연구, 전후 결과가 신뢰성 추가

연구 워크플로를 위해:

  1. 트랜스크립트 라이브러리 구축 - 패턴 발견을 위해 주제/분야별로 정리
  2. 트랜스크립트 간 검색 - grep 또는 텍스트 검색을 사용하여 특정 주제 언급 찾기
  3. 트렌드 추적 - 여러 영상에 걸친 동일 주제 = 떠오르는 트렌드
  4. 프롬프트 추출 - 유용한 프레임워크/방법을 재사용 가능한 프롬프트로 저장

콘텐츠 제작을 위해:

  1. 콘텐츠 격차 찾기 - 어떤 질문이 제기되었지만 완전히 답변되지 않았는가?
  2. 상위 성과자 분석 - 높은 조회수의 영상은 어떤 구조/속도를 사용하는가?
  3. 후크 추출 - 트랜스크립트의 처음 30초 = 입증된 후크 패턴
  4. 통찰 재활용 - 영상 통찰을 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를 제공하도록 사용자에게 요청

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

ever-just/agentskills

> Declarative animations for React. Springs, gestures, layout animations, and page transitions. GPU-accelerated, production-ready.

ever-just/agentskills

> Create animated logos, icons, and micro-interactions as lightweight Lottie JSON files. No After Effects needed — build animations entirely in code.

ever-just/agentskills

> A TypeScript library using generators to program animations with a real-time editor. Ideal for explainer videos, code walkthroughs, and educational content.

ever-just/agentskills

> Add animated subtitles and captions to Remotion videos from .SRT files. TikTok-style word-by-word highlights, karaoke effects, and more.

ever-just/agentskills

> Create videos programmatically using React components. The most mature framework for code-driven video production.

ever-just/agentskills

> Copy-paste video components for Remotion. Intros, text effects, transitions, and full scene templates. Like shadcn/ui but for video.

ever-just/agentskills

Extract actionable intelligence from video content across YouTube, Vimeo, and company websites. Video reveals what text sources cannot: facility scale, team composition, product demonstrations, signage, event attendance, and operational reality.

ever-just/agentskills

Optimize and embed an existing video as a fast, crisp, autoplaying hero/background/loop on a website. Use when adding or replacing a video on a marketing site and it is too heavy, will not autoplay (especially on mobile/Safari), shows a codec error, or looks soft — to transcode it to web-safe H.264 with the right pixel format, faststart, retina-aware sizing, and a poster frame, then embed and verify it actually plays. This is optimization + embedding of footage you already have, not creating/animating a video (for that use remotion/moviepy/motion-canvas). Use when the user says "add this video to the site", "the hero video is too big / won't play / isn't crisp", "replace the homepage video", or "make this loop on the landing page".

ever-just/agentskills

Full conversion audit for any homepage or landing page. Use when someone asks to "review my homepage," "audit my landing page," "why isn't my page converting," "check my website," or wants feedback on their marketing page. Requires URL or screenshot before proceeding.

관련 스킬