/youtube-clipper - 動画ハイライト抽出 & クリップ生成

エントリーポイント

python skills/youtube-clipper/scripts/main.py --url "https://..."

概要

YouTube/Vimeo/X等の動画から、AIで意味的にハイライトを分析し、 バイリンガル字幕付きのクリップを自動生成します。

クイックスタート

# YouTube動画からクリップ抽出
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

# 自動選択モード（スコア0.8以上のチャプターを自動抽出）
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ファイルを設定してください:

# 方法1: cookieファイルを指定
export YTDLP_COOKIES=/path/to/cookies.txt    # Mac/Linux/WSL

# 方法2: ブラウザからcookieを取得（ローカルPC向け）
export YTDLP_COOKIES_FROM_BROWSER=chrome    # Mac/Linux/WSL

cookieファイルの取得方法:

1. ブラウザ拡張「Get cookies.txt LOCALLY」等でYouTubeのcookieをエクスポート
2. Netscape形式のcookies.txtをサーバーにアップロード
3. 環境変数 YTDLP_COOKIES にパスを指定

yt-dlpが見つからない

uv add yt-dlp

FFmpegが見つからない

sudo apt-get install -y ffmpeg    # Ubuntu/Debian
# macOS: brew install ffmpeg
# Windows: winget install 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    # Mac/Linux/WSL
export PATH="$HOME/.deno/bin:$PATH"    # Mac/Linux/WSL