skills/inoue2002/youtube-skill/youtube-transcript

youtube-transcript

SKILL.md

YouTube Transcript Skill

YouTube動画の字幕・自動生成字幕をダウンロードし、テキストとして抽出するスキル。

Prerequisites

  • Python 3.x
  • yt-dlp (pip install yt-dlp or brew install yt-dlp)

Setup

スキルのディレクトリにある transcript.py を使用する。初回実行時に yt-dlp がインストールされていなければ、先にインストールすること。

# yt-dlpがインストールされていない場合
pip install yt-dlp
# または
brew install yt-dlp

Usage

Basic: SRT字幕をダウンロード

python <skill-dir>/transcript.py <YouTube_URL_or_VIDEO_ID>

テキストのみ抽出(タイムスタンプ除去)

python <skill-dir>/transcript.py <YouTube_URL_or_VIDEO_ID> -t

オプション

Flag Description Default
-l LANG 字幕の言語コード ja
-o DIR 出力ディレクトリ output
-t テキストのみ出力 off

英語字幕を取得する場合

python <skill-dir>/transcript.py <URL> -l en -t

Workflow

  1. ユーザーからYouTube URLまたは動画IDを受け取る
  2. transcript.py-t フラグ付きで実行してテキストを取得
  3. 出力ファイル(output/<video_id>.<lang>.txt)を読み取る
  4. ユーザーの要求に応じて要約・分析・翻訳などを行う

Notes

  • 自動生成字幕(auto-generated subtitles)に対応している
  • 字幕が存在しない動画ではエラーになる
  • SRTファイルからテキスト抽出時にHTMLタグと重複行は自動除去される
  • <skill-dir> は、このSKILL.mdがあるディレクトリのパスに読み替えること
Weekly Installs
2
First Seen
Mar 1, 2026
Installed on
opencode2
claude-code2
github-copilot2
codex2
kimi-cli2
gemini-cli2