Youtube Clipper

Documents

youtube-clipper

Youtube Clipper is an Agent Skill for documents published in the minicoohei/ai-agent-camp repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

YouTube/マルチプラットフォーム動画からAIでハイライトを抽出し、バイリンガル字幕付きクリップを自動生成するスキル。「動画からクリップを切り出して」「ハイライトを抽出」「字幕付きクリップ」等で発動。

View on GitHub ↗

QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

Open your project in Codex.
Copy and paste the prompt below.
Review files and risks before approving any action.

Prompt to paste

Inspect the Agent Skill at https://github.com/minicoohei/ai-agent-camp/blob/HEAD/.claude/skills/youtube-clipper/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/youtube-clipper, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

/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ファイルの取得方法:

ブラウザ拡張「Get cookies.txt LOCALLY」等でYouTubeのcookieをエクスポート
Netscape形式のcookies.txtをサーバーにアップロード
環境変数 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