| name | youtube-clipper |
| description | YouTube/マルチプラットフォーム動画からAIでハイライトを抽出し、 バイリンガル字幕付きクリップを自動生成するスキル。 「動画からクリップを切り出して」「ハイライトを抽出」「字幕付きクリップ」等で発動。 |
| triggers | ["動画からクリップを切り出して","ハイライトを抽出","字幕付きクリップを作成","YouTubeからクリップ","動画の見どころを切り抜き","youtube-clipper","clip highlight"] |
/youtube-clipper - 動画ハイライト抽出 & クリップ生成
エントリーポイント
python skills/youtube-clipper/scripts/main.py --url "https://..."
概要
YouTube/Vimeo/X等の動画から、AIで意味的にハイライトを分析し、
バイリンガル字幕付きのクリップを自動生成します。
クイックスタート
python skills/youtube-clipper/scripts/clipper.py \
--url "https://www.youtube.com/watch?v=xxxxx"
python skills/youtube-clipper/scripts/clipper.py \
--file /path/to/local.mp4
python skills/youtube-clipper/scripts/clipper.py \
--url "https://..." --auto-select "score>0.8"
ワークフロー
入力（URL or ローカルファイル）
↓
Step 1: 動画DL + 字幕取得（字幕なし → Gemini音声認識）
↓
Step 2: AIチャプター分析（セマンティック分割 + 要約 + スコア）
↓
Step 3: ユーザーがハイライト選択（番号/自然言語/スコアフィルタ）
↓
Step 4: クリップ抽出 + 字幕翻訳 + 焼き込み
↓
出力: clips/ + chapters.json + SNSサマリー
パラメータ
| パラメータ | デフォルト | 説明 |
|---|
--url | - | YouTube/Vimeo/X等のURL |
--file | - | ローカル動画ファイル |
--output | output/clips/ | 出力ディレクトリ |
--resolution | 1080 | 動画品質（720/1080/best） |
--target-lang | ja | 翻訳先言語 |
--burn-subtitles | false | 字幕焼き込み |
--auto-select | - | 自動選択条件（score>0.8, all） |
--chapters-only | false | チャプター分析のみ（クリップ抽出しない） |
出力構造
output/clips/YYYYMMDD_HHMMSS_{video_id}/
├── metadata.json
├── chapters.json
├── subtitles/
│ ├── original.srt
│ └── translated_ja.srt
├── clips/
│ ├── clip_01/
│ │ ├── clip_01.mp4
│ │ ├── clip_01_subtitled.mp4
│ │ ├── original.srt
│ │ ├── translated_ja.srt
│ │ ├── bilingual.srt
│ │ └── summary.json
│ └── ...
└── remotion_input.json
対応プラットフォーム
YouTube, Vimeo, X/Twitter, ニコニコ動画, Dailymotion等（yt-dlp対応範囲）
字幕なし動画
字幕が利用できない場合、FFmpegで音声を抽出し、
Gemini 3.0 Flash Previewで文字起こし + タイムスタンプ生成を行います。
コスト目安
| 処理 | コスト |
|---|
| 動画DL | $0 |
| Gemini文字起こし（10分動画） | ~$0.02 |
| チャプター分析 | ~$0.01 |
| 字幕翻訳 | ~$0.005 |
| 合計 | ~$0.035/動画 |
トラブルシューティング
YouTubeダウンロードが失敗する
ヘッドレスサーバーからはYouTubeのbot検出で弾かれることがあります。
cookieファイルを設定してください:
export YTDLP_COOKIES=/path/to/cookies.txt
export YTDLP_COOKIES_FROM_BROWSER=chrome
cookieファイルの取得方法:
- ブラウザ拡張「Get cookies.txt LOCALLY」等でYouTubeのcookieをエクスポート
- Netscape形式のcookies.txtをサーバーにアップロード
- 環境変数
YTDLP_COOKIES にパスを指定
yt-dlpが見つからない
uv add yt-dlp
FFmpegが見つからない
sudo apt-get install -y ffmpeg
deno（JSランタイム）が必要と言われる
yt-dlpのYouTube抽出にdeno JSランタイムが必要な場合があります。
⚠️ セキュリティ注意: curl ... | sh はリモートスクリプトを無検証で実行します。
可能なら次の代替を優先してください:
- macOS:
brew install deno
- Windows:
winget install DenoLand.Deno
- 手動: Deno 公式インストール手順 を確認
curl -fsSL https://deno.land/install.sh | sh
export PATH="$HOME/.deno/bin:$PATH"
