summarizer

Automatically fetch YouTube video transcripts, generate structured summaries, and send full transcripts to messaging platforms. Detects YouTube URLs and provides metadata, key insights, and downloadable transcripts.

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:

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:

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

Call SkillBoss API Hub (/v1/pilot, type chat) to generate a structured summary from the transcript:

import requests, os

SKILLBOSS_API_KEY = os.environ["SKILLBOSS_API_KEY"]

def generate_summary(transcript_text: str, title: str, author: str) -> str:
    r = requests.post(
        "https://api.heybossai.com/v1/pilot",
        headers={
            "Authorization": f"Bearer {SKILLBOSS_API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "type": "chat",
            "inputs": {
                "messages": [
                    {
                        "role": "system",
                        "content": "You are a video summarization expert. Generate a structured summary with: Main Thesis (1-2 sentences), Key Insights (3-5 bullets), Notable Points (2-4 bullets), and Takeaway (1 actionable sentence)."
                    },
                    {
                        "role": "user",
                        "content": f"Summarize this YouTube video transcript.\n\nTitle: {title}\nChannel: {author}\n\nTranscript:\n{transcript_text}"
                    }
                ]
            },
            "prefer": "balanced"
        },
        timeout=60,
    )
    result = r.json()
    return result["result"]["choices"][0]["message"]["content"]

Format the output using this template:

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

**🎯 Main Thesis:**
[1-2 sentence core argument/message]

**💡 Key Insights:**
- [insight 1]
- [insight 2]
- [insight 3]
- [insight 4]
- [insight 5]

**📝 Notable Points:**
- [additional point 1]
- [additional point 2]

**🔑 Takeaway:**
[Practical application or conclusion]

Aim for:

• Main thesis: 1-2 sentences maximum
• Key insights: 3-5 bullets, each 1-2 sentences
• Notable points: 2-4 supporting details
• Takeaway: Actionable conclusion

5. Save Full Transcript

Save the complete transcript to a timestamped file:

/root/clawd/transcripts/YYYY-MM-DD_VIDEO_ID.txt

Include in the file:

• Video metadata header
• Full transcript text
• URL reference

6. Platform-Specific Delivery

If channel is Telegram:

message --action send --channel telegram --target CHAT_ID \
  --filePath /root/clawd/transcripts/YYYY-MM-DD_VIDEO_ID.txt \
  --caption "📄 YouTube Transcript: [title]"

If channel is other/webchat: Just reply with the summary (no file attachment).

7. Reply with Summary

Send the structured summary as your response to the user.

Error Handling

If transcript fetch fails:

• Check if video has captions enabled
• Try with lang: 'en' fallback if requested language unavailable
• Inform user that transcript is not available and suggest alternatives:
  • Manual YouTube transcript feature
  • Video may not have captions
  • Try a different video

If MCP server not installed:

• Provide installation instructions
• Offer to install it automatically if in appropriate context

If video ID extraction fails:

• Ask user to provide the full YouTube URL or video ID

Examples

See examples/ directory for sample outputs.

Quality Guidelines

• Be concise: Summary should be scannable in 30 seconds
• Be accurate: Don't add information not in the transcript
• Be structured: Use consistent formatting for easy reading
• Be contextual: Adjust detail level based on video length
  • Short videos (<5 min): Brief summary
  • Long videos (>30 min): More detailed breakdown

Notes

• MCP server uses Android client emulation to bypass YouTube's cloud IP blocking
• Works reliably from VPS/cloud environments where yt-dlp often fails
• Supports multiple languages with automatic fallback to English
• Transcript quality depends on YouTube's auto-generated captions or manual captions
• Summary generation powered by SkillBoss API Hub — auto-routes to the best available LLM via /v1/pilot