youtube-summarizer

# YouTube Summarizer Skill

Automatically fetch transcripts from YouTube videos, generate structured summaries, and deliver full transcripts to messaging platforms.

## When to Use

Activate this skill when:
- User shares a YouTube URL (youtube.com/watch, youtu.be, youtube.com/shorts)
- User asks to summarize or transcribe a YouTube video
- User requests information about a YouTube video's content

## Dependencies

**Required:** MCP YouTube Transcript server must be installed at:
`/root/clawd/mcp-server-youtube-transcript`

If not present, install it:
```bash
cd /root/clawd
git clone https://github.com/kimtaeyoon83/mcp-server-youtube-transcript.git
cd mcp-server-youtube-transcript
npm install && npm run build
```

## Workflow

### 1. Detect YouTube URL
Extract video ID from these patterns:
- `https://www.youtube.com/watch?v=VIDEO_ID`
- `https://youtu.be/VIDEO_ID`
- `https://www.youtube.com/shorts/VIDEO_ID`
- Direct video ID: `VIDEO_ID` (11 characters)

### 2. Fetch Transcript
Run this command to get the transcript:
```bash
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
```

Replace `VIDEO_ID` with the extracted ID. Read the output from `/tmp/yt-transcript.json`.

### 3. Process the Data

Parse the JSON to extract:
- `result.metadata.title` - Video title
- `result.metadata.author` - Channel name
- `result.metadata.viewCount` - Formatted view count
- `result.metadata.publishDate` - Publication date
- `result.actualLang` - Language used
- `result.lines` - Array of transcript segments

Full text: `result.lines.map(l => l.text).join(' ')`

### 4. Generate Summary

Create a structured summary using this template:

```markdown
📹 **Video:** [title]
👤 **Channel:** [author] | 👁️ **Views:** [views] | 📅 **Published:** [date]

**🎯 Main Thesis:*...

# YouTube Summarizer

Automatically fetch YouTube video transcripts, generate structured summaries, and deliver full transcripts to messaging platforms.

## Features

✅ **Automatic detection** - Recognizes YouTube URLs in messages  
✅ **Cloud-friendly** - Works from VPS/cloud IPs where yt-dlp fails  
✅ **Structured summaries** - Main thesis, key insights, and takeaways  
✅ **Full transcripts** - Downloadable text file with complete video content  
✅ **Platform-aware** - Auto-sends files to Telegram, text-only elsewhere  
✅ **Multi-language** - Supports multiple languages with English fallback  

## Installation

### Prerequisites

1. **Node.js 18+** installed
2. **Clawdbot** running

### Install via ClawdHub

```bash
clawdhub install youtube-summarizer
```

### Manual Installation

```bash
# 1. Clone the skill
cd /root/clawd/skills
git clone <this-repo-url> youtube-summarizer

# 2. Install MCP YouTube Transcript dependency
cd /root/clawd
git clone https://github.com/kimtaeyoon83/mcp-server-youtube-transcript.git
cd mcp-server-youtube-transcript
npm install && npm run build
```

## Usage

Simply share a YouTube URL in chat:

```
You: https://youtu.be/dQw4w9WgXcQ

Agent: 📹 **Video:** Never Gonna Give You Up
       👤 **Channel:** Rick Astley | 👁️ **Views:** 1.4B | 📅 **Published:** 2009-10-25
       
       **🎯 Main Thesis:**
       A declaration of unwavering commitment and loyalty in a relationship...
       
       [structured summary follows]
       
       📄 Full transcript attached (Telegram) or saved to transcripts/
```

## How It Works

1. **Detects** YouTube URLs automatically
2. **Fetches** transcript using MCP server (bypasses cloud IP blocks)
3. **Generates** structured summary with metadata
4. **Saves** full transcript to `transcripts/YYYY-MM-DD_VIDEO_ID.txt`
5. **Sends** file to Telegram (if in Telegram context)
6. **Replies** with formatted summary

## Supported URL Formats

- `https://www.youtube.com/watch?v=VIDEO_ID`
- `https://youtu.be/VIDEO...