youtube-transcript

Download YouTube transcripts and captions from a provided URL.

7|3|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/Zpankz/mcp-skillset --skill youtube-transcript-zpankz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: youtube-transcript
Source: https://github.com/Zpankz/mcp-skillset/tree/main/youtube-transcript
Command: npx skills add https://github.com/Zpankz/mcp-skillset --skill youtube-transcript-zpankz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Retrieving transcripts and captions from YouTube videos is often manual and inconsistent; this skill automates the process by fetching available subtitles or generating transcripts for a given YouTube URL, making it easier to review, study, or repurpose video content.

Core Features & Use Cases

  • Subtitle retrieval: List and download manual or auto-generated subtitles for a video when available.
  • Transcription fallback: If subtitles are unavailable, optionally transcribe the audio with Whisper and produce a text transcript.
  • Post-processing: Convert subtitles to plain text, deduplicate and clean formatting for easy reading and analysis.
  • Use Case: A researcher wants a clean text transcript of a lecture video to extract key topics and quotes.

Quick Start

Use a YouTube URL to download the best available transcript or captions for that video.

Frequently Asked Questions about youtube-transcript

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I download YouTube transcripts and subtitles from a video URL?

To download YouTube transcripts, provide a video URL to fetch available subtitles. The skill checks for manual or auto-generated captions, prioritizing manual subtitles, and saves the output text for further use.

What is the best way to get plain text from YouTube subtitles?

The best way to get plain text from YouTube subtitles is through post-processing that converts and cleans subtitle formats. This process deduplicates content and removes formatting to produce an easy-to-read text transcript.

Can I transcribe YouTube audio when subtitles are unavailable?

Yes, you can transcribe YouTube audio when subtitles are unavailable by using Whisper as a fallback. This generates a text transcript directly from the video audio when no manual or auto-generated captions exist.

Does this transcript retrieval method require yt-dlp to fetch subtitles?

Yes, this transcript retrieval method requires yt-dlp to fetch subtitles. It uses yt-dlp to check subtitle availability and download available manual or auto-generated captions for the provided YouTube URL.

Why are my YouTube subtitles not working or downloading correctly?

YouTube subtitles might not work if no manual or auto-generated captions are available for the video. In these cases, the skill falls back to Whisper transcription to generate a transcript from the audio.