youtube-transcript
Extract transcripts from YouTube videos. Use when the user asks for a transcript, subtitles, or captions of a YouTube video and provides a YouTube URL (youtube.com/watch?v=, youtu.be/, or similar). Supports output with or without timestamps.
When & Why to Use This Skill
The YouTube Transcript skill enables Claude to programmatically extract and format transcripts, subtitles, and captions directly from YouTube videos. By supporting multiple URL formats and providing options for both plain text and timestamped output, it streamlines the process of converting video content into searchable, structured text for enhanced research and content management.
Use Cases
- Content Summarization: Extracting full transcripts to generate concise summaries or key takeaways from long-form webinars and tutorials without watching the entire video.
- Research & Fact-Checking: Using timestamped transcripts to locate specific quotes, data points, or mentions within a video for academic or professional citations.
- Content Repurposing: Converting video scripts into blog posts, newsletters, or social media snippets to maximize the reach of video-based content.
- Accessibility & Translation: Obtaining text versions of videos to facilitate translation into multiple languages or to provide accessible content for the hearing impaired.
| name | youtube-transcript |
|---|---|
| description | Extract transcripts from YouTube videos. Use when the user asks for a transcript, subtitles, or captions of a YouTube video and provides a YouTube URL (youtube.com/watch?v=, youtu.be/, or similar). Supports output with or without timestamps. |
YouTube Transcript
Extract transcripts from YouTube videos using the youtube-transcript-api.
Usage
Run the script with a YouTube URL or video ID:
uv run get_transcript.py "VIDEO_URL_OR_ID"
With timestamps:
uv run get_transcript.py "VIDEO_URL_OR_ID" --timestamps
Defaults
- Without timestamps (default): Plain text, one line per caption segment
- With timestamps:
[MM:SS] textformat (or[HH:MM:SS]for longer videos)
Supported URL Formats
https://www.youtube.com/watch?v=VIDEO_IDhttps://youtu.be/VIDEO_IDhttps://youtube.com/embed/VIDEO_ID- Raw video ID (11 characters)
Output
- CRITICAL: YOU MUST NEVER MODIFY THE RETURNED TRANSCRIPT
- If the transcript is without timestamps, you SHOULD clean it up so that it is arranged by complete paragraphs and the lines don't cut in the middle of sentences.
- If you were asked to save the transcript to a specific file, save it to the requested file.
- If no output file was specified, use the YouTube video ID with a
-transcript.txtsuffix.
Notes
- Fetches auto-generated or manually added captions (whichever is available)
- Requires the video to have captions enabled
- Falls back to auto-generated captions if manual ones aren't available