baoyu-youtube-transcript

Downloads YouTube transcripts, subtitles, and cover images with caching and chapter segmentation.

Updated May 18, 2026
One-click install
npx skills add https://github.com/fts-pro/FTS-MMIS-AFRIKA --skill baoyu-youtube-transcript-fts-pro
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: baoyu-youtube-transcript
Source: https://github.com/fts-pro/FTS-MMIS-AFRIKA/tree/main/.agent/skills/baoyu-youtube-transcript
Command: npx skills add https://github.com/fts-pro/FTS-MMIS-AFRIKA --skill baoyu-youtube-transcript-fts-pro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yt-dlp, and includes scripts (resource) components.

What problem does it solve? Getting usable text out of YouTube videos usually requires manual copy-paste, paid APIs, or browser automation. This Skill downloads transcripts and subtitles directly from YouTube by URL or video ID, with no API key required, and saves them as clean Markdown or SRT files. ## Core Features & Use Cases - Transcript & Subtitle Download: Fetches manually created and auto-generated captions in multiple languages, with translation support and SRT output for video players. - Chapters & Speaker Identification: Segments transcripts by chapters parsed from the video description and supports AI-assisted speaker labeling for interviews and podcasts. - Caching & Cover Images: Caches raw transcript data, metadata, and thumbnail images locally so re-formatting the same video requires no network calls. - Use Case: A researcher pastes a YouTube lecture URL and asks for the transcript in Chinese with timestamps; the Skill downloads, translates, and saves a timestamped Markdown file plus the video cover image. ## Quick Start Ask the AI to get the transcript of a YouTube video by pasting its URL, optionally specifying a language, chapters, or SRT format.

Frequently Asked Questions about baoyu-youtube-transcript

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

FAQPage Schema
How do I download a YouTube transcript without an API key?▼

Run the main.ts script with a YouTube URL or video ID using bun or npx. It calls YouTube's InnerTube API directly, so no API key or browser login is required, and it falls back to yt-dlp if YouTube blocks the direct path.

How to get YouTube subtitles in a specific language?▼

Pass the --languages option with comma-separated language codes in priority order, such as --languages zh,en,ja. Use --list first to see which manual and auto-generated transcripts a video actually offers.

Can YouTube transcripts be translated to another language?▼

Yes, use the --translate option with a target language code like zh-Hans. The transcript must be marked as translatable by YouTube, and the requested translation language must appear in the video's translation language list.

Does it work with auto-generated YouTube captions?▼

Yes, both manually created and auto-generated captions are supported. You can filter with --exclude-generated or --exclude-manually-created to control which caption type is selected.

Why does YouTube transcript download fail with bot detected errors?▼

YouTube rate-limits or flags repeated requests as bot traffic. The script retries with alternate client identities and falls back to yt-dlp; if that fails, set YOUTUBE_TRANSCRIPT_COOKIES_FROM_BROWSER to reuse your browser session.

What output formats does YouTube transcript extraction support?▼

It outputs Markdown text with optional timestamps, chapters, and speaker labels, or SRT subtitle files for video players. Raw transcript JSON, metadata, and the cover image are cached locally for fast re-formatting.