youtube-transcript-cn

YouTube 字幕抽出スキル

YouTube 動画から字幕を抽出し、中国語の文字起こしを出力します。

クイックスタート

python3 scripts/get_transcript.py "https://www.youtube.com/watch?v=VIDEO_ID"

ワークフロー

1. 動画リンクを取得：ユーザーメッセージから YouTube URL を抽出します
2. スクリプトを実行：scripts/get_transcript.py を実行して字幕を抽出します
3. 出力を処理：
   • 字幕が中国語の場合：そのまま出力します
   • 字幕が英語の場合：中国語に翻訳してから出力します
4. 結果を保存：ユーザーの要望に応じて Markdown ファイルとして保存します

スクリプトのパラメーター

パラメーター	説明	デフォルト値
url	YouTube 動画のリンクまたは ID	必須
-f, --format	出力形式：text、markdown、json	markdown
-t, --timestamps	タイムスタンプを含める	いいえ
-l, --lang	優先言語（カンマ区切り）	zh,en
-o, --output	出力ファイルのパス	stdout

使用例

基本的な使い方

python3 scripts/get_transcript.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

タイムスタンプ付きで出力

python3 scripts/get_transcript.py -t "https://youtu.be/VIDEO_ID"

ファイルに保存

python3 scripts/get_transcript.py -o output.md "https://www.youtube.com/watch?v=VIDEO_ID"

JSON 形式（後処理に便利）

python3 scripts/get_transcript.py -f json "VIDEO_ID"

対応している URL 形式

• https://www.youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• https://www.youtube.com/embed/VIDEO_ID
• Video ID を直接指定

言語の優先順位

スクリプトは次の順序で字幕を探します：

1. 簡体字中国語 (zh-Hans)
2. 繁体字中国語 (zh-Hant)
3. 中国語 (zh)
4. 英語 (en)
5. 自動生成字幕

翻訳処理

英語の字幕を取得した場合は、中国語に翻訳する必要があります：

1. スクリプトを実行して英語の字幕を取得します
2. Claude の組み込み機能を使用して、自然な中国語に翻訳します
3. 原文の構成と段落分けを維持します

エラー処理

エラー	原因	解決策
No captions available	動画に字幕がありません	この動画には利用可能な字幕がないことをユーザーに伝えます
Cannot extract video ID	URL の形式が正しくありません	正しい YouTube リンクをユーザーに求めます
ネットワークタイムアウト	ネットワークの問題	再試行するか、ネットワーク接続を確認します

出力形式の例

Markdown 形式

# 视频标题

- **Video ID**: abc123
- **语言**: 中文（自动生成）
- **链接**: https://www.youtube.com/watch?v=abc123

---

## 文字稿

这是视频的第一段内容...

这是视频的第二段内容...