youtube-summarizer は何をしますか?
目的
このスキルは、YouTube動画から文字起こしを抽出し、STAR + R-I-S-E フレームワークを使用して、包括的で詳細な要約を生成します。動画の可用性を検証し、youtube-transcript-api Pythonライブラリを使用して文字起こしを抽出し、すべての洞察、議論、重要なポイントを捉えた詳細なドキュメントを生成します。
このスキルは、教育用動画、講義、チュートリアル、または情報コンテンツから徹底的なコンテンツ分析と参照ドキュメントを必要とするユーザー向けに設計されています。
このスキルを使用するタイミング
このスキルは以下の場合に使用してください。
- ユーザーがYouTube動画のURLを提供し、詳細な要約を希望する場合
- ユーザーが動画を再視聴することなく、動画コンテンツを参照用に文書化したい場合
- ユーザーが教育コンテンツから洞察、重要なポイント、議論を抽出したい場合
- ユーザーが分析のためにYouTube動画の文字起こしを必要とする場合
- ユーザーがYouTube動画の「要約」、「まとめ」、または「コンテンツ抽出」を依頼した場合
- 簡潔さよりも完全性を優先した包括的なドキュメントをユーザーが希望する場合
ステップ 0: 発見とセットアップ
動画を処理する前に、環境と依存関係を検証します。
# Check if youtube-transcript-api is installed
python3 -c "import youtube_transcript_api" 2>/dev/null
if [ $? -ne 0 ]; then
echo "⚠️ youtube-transcript-api not found"
# Offer to install
fi
# Check Python availability
if ! command -v python3 &>/dev/null; then
echo "❌ Python 3 is required but not installed"
exit 1
fi
依存関係が不足している場合、ユーザーに確認します:
youtube-transcript-api が必要ですが、インストールされていません。
今すぐインストールしますか?
- [ ] はい - pipでインストール (pip install youtube-transcript-api)
- [ ] いいえ - 手動でインストールします
ユーザーが「はい」を選択した場合:
pip install youtube-transcript-api
インストールを確認:
python3 -c "import youtube_transcript_api; print('✅ youtube-transcript-api installed successfully')"
メインワークフロー
進捗状況追跡ガイドライン
ワークフロー全体を通して、各ステップの前に視覚的な進捗ゲージを表示し、ユーザーに情報を提供します。ゲージの形式は以下の通りです。
echo "[████░░░░░░░░░░░░░░░░] 20% - Step 1/5: Validating URL"
フォーマット仕様:
- 20文字幅(完了部分は █、未完了部分は ░ を使用)
- パーセンテージの増分:ステップ1=20%、ステップ2=40%、ステップ3=60%、ステップ4=80%、ステップ5=100%
- 現在のステップ/全ステップ数(例:「Step 3/5」)
- 現在のフェーズの簡単な説明
ステップ1の前に初期ステータスボックスを表示:
╔══════════════════════════════════════════════════════════════╗
║ 📹 YOUTUBE SUMMARIZER - Processing Video ║
╠══════════════════════════════════════════════════════════════╣
║ → Step 1: Validating URL [IN PROGRESS] ║
║ ○ Step 2: Checking Availability ║
║ ○ Step 3: Extracting Transcript ║
║ ○ Step 4: Generating Summary ║
║ ○ Step 5: Formatting Output ║
╠══════════════════════════════════════════════════════════════╣
║ Progress: ██████░░░░░░░░░░░░░░░░░░░░░░░░ 20% ║
╚══════════════════════════════════════════════════════════════╝
ステップ 1: YouTube URLを検証
目的: 動画IDを抽出し、URL形式を検証します。
サポートされているURL形式:
https://www.youtube.com/watch?v=VIDEO_IDhttps://youtube.com/watch?v=VIDEO_IDhttps://youtu.be/VIDEO_IDhttps://m.youtube.com/watch?v=VIDEO_ID
アクション:
# Extract video ID using regex or URL parsing
URL="$USER_PROVIDED_URL"
# Pattern 1: youtube.com/watch?v=VIDEO_ID
if echo "$URL" | grep -qE 'youtube\.com/watch\?v='; then
VIDEO_ID=$(echo "$URL" | sed -E 's/.*[?&]v=([^&]+).*/\1/')
# Pattern 2: youtu.be/VIDEO_ID
elif echo "$URL" | grep -qE 'youtu\.be/'; then
VIDEO_ID=$(echo "$URL" | sed -E 's/.*youtu\.be\/([^?]+).*/\1/')
else
echo "❌ Invalid YouTube URL format"
exit 1
fi
URLが無効な場合:
❌ Invalid YouTube URL
有効なYouTube URLを次のいずれかの形式で入力してください。
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID
例: https://www.youtube.com/watch?v=dQw4w9WgXcQ
ステップ 2: 動画と文字起こしの可用性を確認
進捗状況:
echo "[████████░░░░░░░░░░░░] 40% - Step 2/5: Checking Availability"
目的: 動画が存在し、文字起こしにアクセスできることを確認します。
アクション:
from youtube_transcript_api import YouTubeTranscriptApi, TranscriptsDisabled, NoTranscriptFound
import sys
video_id = sys.argv[1]
try:
# Get list of available transcripts
transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
print(f"✅ Video accessible: {video_id}")
print("📝 Available transcripts:")
for transcript in transcript_list:
print(f" - {transcript.language} ({transcript.language_code})")
if transcript.is_generated:
print(" [Auto-generated]")
except TranscriptsDisabled:
print(f"❌ Transcripts are disabled for video {video_id}")
sys.exit(1)
except NoTranscriptFound:
print(f"❌ No transcript found for video {video_id}")
sys.exit(1)
except Exception as e:
print(f"❌ Error accessing video: {e}")
sys.exit(1)
エラーハンドリング:
| エラー | メッセージ | アクション |
|---|---|---|
| 動画が見つからない | "❌ Video does not exist or is private" | ユーザーにURLの確認を依頼 |
| 文字起こしが無効 | "❌ Transcripts are disabled for this video" | 処理を続行できません |
| 利用可能な文字起こしがない | "❌ No transcript found (not auto-generated or manually added)" | 処理を続行できません |
| プライベート/制限付き動画 | "❌ Video is private or restricted" | 公開動画を依頼 |
ステップ 3: 文字起こしを抽出
進捗状況:
echo "[████████████░░░░░░░░] 60% - Step 3/5: Extracting Transcript"
目的: 希望の言語で文字起こしを取得します。
アクション:
from youtube_transcript_api import YouTubeTranscriptApi
video_id = "VIDEO_ID"
try:
# Try to get transcript in user's preferred language first
# Fall back to English if not available
transcript = YouTubeTranscriptApi.get_transcript(
video_id,
languages=['pt', 'en'] # Prefer Portuguese, fallback to English
)
# Combine transcript segments into full text
full_text = " ".join([entry['text'] for entry in transcript])
# Get video metadata
from youtube_transcript_api import YouTubeTranscriptApi
transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
print("✅ Transcript extracted successfully")
print(f"📊 Transcript length: {len(full_text)} characters")
# Save to temporary file for processing
with open(f"/tmp/transcript_{video_id}.txt", "w") as f:
f.write(full_text)
except Exception as e:
print(f"❌ Error extracting transcript: {e}")
exit(1)
文字起こし処理:
- すべての文字起こしセグメントを結合して一貫性のあるテキストにする
- 利用可能な場合は句読点と書式を保持する
- 重複または重複するセグメントを削除する(自動生成アーティファクトの場合)
- 分析のために一時ファイルに保存する
ステップ 4: 包括的な要約を生成
進捗状況:
echo "[████████████████░░░░] 80% - Step 4/5: Generating Summary"
目的: 拡張されたSTAR + R-I-S-Eプロンプトを適用して詳細な要約を作成します。
適用するプロンプト:
フェーズ2(STAR + R-I-S-Eフレームワーク)の拡張プロンプトを入力として抽出された文字起こしとともに使用します。
アクション:
- 完全な文字起こしテキストを読み込む
- 包括的な要約プロンプトを適用する
- AIモデル(Claude/GPT)を使用して構造化された要約を生成する
- 出力が定義された構造に従うことを確認する:
- 動画メタデータを含むヘッダー
- エグゼクティブサマリー
- セクションごとの詳細な内訳
- 重要な洞察と結論
- 概念と用語
- リソースと参考文献
実装:
# Use the transcript file as input to the AI prompt
TRANSCRIPT_FILE="/tmp/transcript_${VIDEO_ID}.txt"
# The AI agent will:
# 1. Read the transcript
# 2. Apply the STAR + R-I-S-E summarization framework
# 3. Generate comprehensive Markdown output
# 4. Structure with headers, lists, and highlights
Read "$TRANSCRIPT_FILE" # Read transcript into context
次に、完全な要約プロンプト(フェーズ2の拡張バージョンから)を適用します。
ステップ 5: 出力をフォーマットして提示
進捗状況:
echo "[████████████████████] 100% - Step 5/5: Formatting Output"
目的: クリーンで構造化されたMarkdownで要約を提供します。
出力構造:
# [Video Title]
**Canal:** [Channel Name]
**Duração:** [Duration]
**URL:** [https://youtube.com/watch?v=VIDEO_ID]
**Data de Publicação:** [Date if available]
## 📝 Detailed Summary
### [Topic 1]
[Comprehensive explanation with examples, data, quotes...]
#### [Subtopic 1.1]
[Detailed breakdown...]
### [Topic 2]
[Continued detailed analysis...]
## 📚 Concepts and Terminology
- **[Term 1]:** [Definition and context]
- **[Term 2]:** [Definition and context]
## 📌 Conclusion
[Final synthesis and takeaways]
例2: 依存関係の欠如
ユーザー入力:
claude> summarize this youtube video https://youtu.be/abc123
スキルの応答:
⚠️ youtube-transcript-api not installed
このスキルを使用するには、Pythonライブラリ 'youtube-transcript-api' が必要です。
今すぐインストールしますか?
- [ ] はい - pipでインストール
- [ ] いいえ - 手動でインストールします
ユーザーが「はい」を選択:
$ pip install youtube-transcript-api
Successfully installed youtube-transcript-api-0.6.1
✅ Installation complete! Proceeding with video summary...
例4: 無効なURL
ユーザー入力:
claude> summarize youtube video www.youtube.com/some-video
スキルの応答:
❌ Invalid YouTube URL format
期待される形式の例:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID
有効なYouTube動画のURLを入力してください。
📊 エグゼクティブサマリー(出力例)
この動画は、人工知能(AI)の基本概念を包括的に紹介し、最新のAIの技術的基礎と実用的応用を理解したい初心者や専門家向けに設計されています。講師は、基本的な定義から機械学習アルゴリズムまで、実際の例と視覚化を使用して理解を促進します。
[... 詳細な要約が続く ...]
📚 Concepts and Terminology
- [Term 1]: [Definition and context]
- [Term 2]: [Definition and context]
保存オプション
何を保存しますか?
→ 要約 + 生の文字起こし
✅ File saved: resumo-exemplo123-2026-02-01.md (includes raw transcript)
[████████████████████] 100% - ✓ Processing complete!
Examples
Example 1: Successful Summary
User Input:
claude> summarize this video https://www.youtube.com/watch?v=dQw4w9WgXcQ
Skill Flow:
- Validates URL ✓
- Checks availability ✓
- Extracts transcript ✓
- Generates summary ✓
- Displays formatted output with save options
Output:
Welcome to this comprehensive tutorial on machine learning fundamentals. In today's video, we'll explore the core concepts that power modern AI systems...
**Version:** 1.2.0
**Last Updated:** 2026-02-02
**Maintained By:** Eric Andrade