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

Node.js 18+ installed
Clawdbot running

Install via ClawdHub

clawdhub install youtube-summarizer

Manual Installation

# 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

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

Supported URL Formats

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

Output Format

Summary Structure

📹 **Video:** [Title]
👤 **Channel:** [Author] | 👁️ **Views:** [Count] | 📅 **Published:** [Date]
 
**🎯 Main Thesis:**
Core message in 1-2 sentences
 
**💡 Key Insights:**
- Insight 1
- Insight 2
- Insight 3
 
**📝 Notable Points:**
- Supporting detail 1
- Supporting detail 2
 
**🔑 Takeaway:**
Practical conclusion

Transcript File

Saved to /root/clawd/transcripts/YYYY-MM-DD_VIDEO_ID.txt with:

Video metadata header
Full transcript text
URL reference

Configuration

No configuration needed! The skill automatically:

Detects your messaging platform
Chooses appropriate delivery method
Handles language fallback
Creates transcript directory if needed

Troubleshooting

"Transcript not available"

Video may not have captions enabled
Try a different video
Use YouTube's manual transcript feature

"MCP server not found"

Install the 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