YouTube要約ツール
目的
このスキルは、YouTube動画からトランスクリプトを抽出し、STAR + R-I-S-Eフレームワークを使用して包括的で詳細な要約を生成します。動画の利用可能性を検証し、youtube-transcript-api Pythonライブラリを使用してトランスクリプトを抽出し、すべての洞察、議論、キーポイントを捉えた詳細なドキュメントを生成します。
このスキルは、教育動画、講義、チュートリアル、情報コンテンツから徹底的なコンテンツ分析とリファレンスドキュメントを必要とするユーザー向けに設計されています。
このスキルを使用すべきタイミング
このスキルは以下の場合に使用する必要があります:
- ユーザーがYouTube動画のURLを提供し、詳細な要約を希望する場合
- ユーザーが動画を再度視聴せずにリファレンス用に動画コンテンツを文書化する必要がある場合
- ユーザーが教育コンテンツから洞察、キーポイント、議論を抽出したい場合
- ユーザーが分析のためにYouTube動画からトランスクリプトを必要とする場合
- ユーザーがYouTube動画の「要約」、「要約」、または「コンテンツ抽出」を依頼した場合
- ユーザーが簡潔さよりも完全性を優先した包括的なドキュメントを希望する場合
ステップ0: 環境確認とセットアップ
動画を処理する前に、環境と依存関係を検証します:
# youtube-transcript-apiがインストールされているか確認
python3 -c "import youtube_transcript_api" 2>/dev/null
if [ $? -ne 0 ]; then
echo "⚠️ youtube-transcript-apiが見つかりません"
# インストールを提案
fi
# Pythonが利用可能か確認
if ! command -v python3 &>/dev/null; then
echo "❌ Python 3が必要ですがインストールされていません"
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のインストールに成功しました')"
メインワークフロー
進捗状況の表示ガイドライン
ワークフロー全体を通じて、各ステップの前に視覚的な進捗ゲージを表示し、ユーザーに情報を提供し続けます。ゲージの形式は次のとおりです:
echo "[████░░░░░░░░░░░░░░░░] 20% - ステップ1/5: URLの検証中"
形式仕様:
- 20文字幅(塗りつぶしは██、空欄は░░を使用)
- パーセンテージ増分:ステップ1=20%、ステップ2=40%、ステップ3=60%、ステップ4=80%、ステップ5=100%
- 現在のステップ/合計を示すステップカウンター(例:「ステップ3/5」)
- 現在のフェーズの簡単な説明
ステップ1の前に初期ステータスボックスを表示します:
╔══════════════════════════════════════════════════════════════╗
║ 📹 YouTube要約ツール - 動画処理中 ║
╠══════════════════════════════════════════════════════════════╣
║ → ステップ1: URLの検証 [処理中] ║
║ ○ ステップ2: 利用可能性の確認 ║
║ ○ ステップ3: トランスクリプトの抽出 ║
║ ○ ステップ4: 要約の生成 ║
║ ○ ステップ5: 出力のフォーマット ║
╠══════════════════════════════════════════════════════════════╣
║ 進捗: ██████░░░░░░░░░░░░░░░░░░░░░░░░ 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
アクション:
# 正規表現またはURL解析を使用して動画IDを抽出
URL="$USER_PROVIDED_URL"
# パターン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/')
# パターン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 "❌ 無効なYouTube URL形式です"
exit 1
fi
echo "📹 動画IDを抽出しました: $VIDEO_ID"
URLが無効な場合:
❌ 無効な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% - ステップ2/5: 利用可能性の確認"
目的: 動画が存在し、トランスクリプトが利用可能であることを確認します。
アクション:
from youtube_transcript_api import YouTubeTranscriptApi, TranscriptsDisabled, NoTranscriptFound
import sys
video_id = sys.argv[1]
try:
# 利用可能なトランスクリプトのリストを取得
transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
print(f"✅ 動画にアクセス可能: {video_id}")
print("📝 利用可能なトランスクリプト:")
for transcript in transcript_list:
print(f" - {transcript.language} ({transcript.language_code})")
if transcript.is_generated:
print(" [自動生成]")
except TranscriptsDisabled:
print(f"❌ 動画 {video_id} ではトランスクリプトが無効になっています")
sys.exit(1)
except NoTranscriptFound:
print(f"❌ 動画 {video_id} のトランスクリプトが見つかりませんでした")
sys.exit(1)
except Exception as e:
print(f"❌ 動画へのアクセス中にエラーが発生しました: {e}")
sys.exit(1)
エラーハンドリング:
| エラー | メッセージ | アクション |
|---|---|---|
| 動画が見つからない | "❌ 動画が存在しないか、非公開です" | ユーザーにURLの確認を依頼 |
| トランスクリプトが無効 | "❌ この動画ではトランスクリプトが無効になっています" | 続行不可 |
| トランスクリプトが利用不可 | "❌ トランスクリプトが見つかりません(自動生成または手動追加されていません)" | 続行不可 |
| 非公開/制限付き動画 | "❌ 動画は非公開または制限されています" | 公開動画を依頼 |
ステップ3: トランスクリプトの抽出
進捗:
echo "[████████████░░░░░░░░] 60% - ステップ3/5: トランスクリプトの抽出"
目的: 希望の言語でトランスクリプトを取得します。
アクション:
from youtube_transcript_api import YouTubeTranscriptApi
video_id = "VIDEO_ID"
try:
# まずユーザーの希望言語でトランスクリプトを取得しようと試みる
# 利用できない場合は英語にフォールバック
transcript = YouTubeTranscriptApi.get_transcript(
video_id,
languages=['pt', 'en'] # ポルトガル語を優先、英語にフォールバック
)
# トランスクリプトセグメントを結合して完全なテキストに
full_text = " ".join([entry['text'] for entry in transcript])
# 動画メタデータを取得
from youtube_transcript_api import YouTubeTranscriptApi
transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
print("✅ トランスクリプトの抽出に成功しました")
print(f"📊 トランスクリプトの長さ: {len(full_text)} 文字")
# 処理のために一時ファイルに保存
with open(f"/tmp/transcript_{video_id}.txt", "w") as f:
f.write(full_text)
except Exception as e:
print(f"❌ トランスクリプトの抽出中にエラーが発生しました: {e}")
exit(1)
トランスクリプト処理:
- すべてのトランスクリプトセグメントを結合して一貫性のあるテキストにする
- 利用可能な場合は句読点と書式を保持する
- 重複または重複するセグメントを削除する(自動生成アーティファクトがある場合)
- 分析のために一時ファイルに保存する
ステップ4: 包括的な要約の生成
進捗:
echo "[████████████████░░░░] 80% - ステップ4/5: 要約の生成"
目的: 拡張されたSTAR + R-I-S-Eプロンプトを適用して詳細な要約を作成します。
適用されるプロンプト:
抽出されたトランスクリプトを入力として、フェーズ2(STAR + R-I-S-Eフレームワーク)の拡張プロンプトを使用します。
アクション:
- 完全なトランスクリプトテキストを読み込む
- 包括的な要約プロンプトを適用する
- AIモデル(Claude/GPT)を使用して構造化された要約を生成する
- 出力が定義された構造に従っていることを確認する:
- 動画メタデータを含むヘッダー
- エグゼクティブサマリー
- セクションごとの詳細な内訳
- 主要な洞察と結論
- 概念と用語
- リソースと参考資料
実装:
# トランスクリプトファイルをAIプロンプトへの入力として使用
TRANSCRIPT_FILE="/tmp/transcript_${VIDEO_ID}.txt"
# AIエージェントは以下の処理を行います:
# 1. トランスクリプトを読み取る
# 2. STAR + R-I-S-E要約フレームワークを適用する
# 3. 包括的なマークダウン出力を生成する
# 4. ヘッダー、リスト、ハイライトで構造化する
Read "$TRANSCRIPT_FILE" # トランスクリプトをコンテキストに読み込む
次に、完全な要約プロンプト(フェーズ2の拡張バージョンから)を適用します。
ステップ5: 出力のフォーマットと表示
進捗:
echo "[████████████████████] 100% - ステップ5/5: 出力のフォーマット"
目的: 要約をクリーンで構造化されたマークダウンで提供します。
出力構造:
# [動画タイトル]
**チャンネル:** [チャンネル名]
**長さ:** [長さ]
**URL:** [https://youtube.com/watch?v=VIDEO_ID]
**公開日:** [日付(利用可能な場合)]
## 📝 詳細な要約
### [トピック1]
[例、データ、引用などを含む包括的な説明...]
#### [サブトピック1.1]
[詳細な内訳...]
### [トピック2]
[詳細な分析の続き...]
## 📚 概念と用語
- **[用語1]:** [定義とコンテキスト]
- **[用語2]:** [定義とコンテキスト]
## 📌 結論
[最終的な総合と重要なポイント]
例2: 依存関係の不足
ユーザー入力:
claude> このYouTube動画を要約して https://youtu.be/abc123
スキルの応答:
⚠️ youtube-transcript-apiがインストールされていません
このスキルにはPythonライブラリ'youtube-transcript-api'が必要です。
今すぐインストールしますか?
- [ ] はい - pipでインストール
- [ ] いいえ - 手動でインストールします
ユーザーが「はい」を選択:
$ pip install youtube-transcript-api
Successfully installed youtube-transcript-api-0.6.1
✅ インストール完了!動画の要約処理を続行します...
例4: 無効なURL
ユーザー入力:
claude> YouTube動画を要約して www.youtube.com/some-video
スキルの応答:
❌ 無効なYouTube URL形式
期待される形式の例:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID
有効なYouTube動画URLを提供してください。
📊 エグゼクティブサマリー
この動画は、人工知能(AI)の基本的な概念について包括的な入門を提供し、現代のAIの技術的基盤と実用的な応用を理解したい初心者と専門家向けに設計されています。講師は基本的な定義から機械学習アルゴリズムまでをカバーし、理解を促進するために実用的な例と視覚化を使用しています。
[... 詳細な要約が続きます ...]
**保存オプション:**
何を保存しますか? → 要約 + 生トランスクリプト
✅ ファイルを保存しました: resumo-exemplo123-2026-02-01.md(生トランスクリプトを含む) [████████████████████] 100% - ✓ 処理完了!
機械学習の基礎に関するこの包括的なチュートリアルへようこそ。今日の動画では、現代のAIシステムを支える中核的な概念を探求します...
バージョン: 1.2.0 最終更新日: 2026-02-02 メンテナー: Eric Andrade
制限事項
- このスキルは、タスクが上記で説明された範囲に明確に一致する場合にのみ使用してください。
- 出力を環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
- 必要な入力、権限、安全境界、または成功基準が不足している場合は、立ち止まって明確化を求めてください。