Claude-real-video (GitHub) は、Python製のCLIツールで、動画からシーンを認識し重複を排除したフレームと文字起こしをローカルで抽出することで、あらゆるLLMに動画を「視聴」させることができます。固定間隔のフレームサンプリング（例：1fps）では静的なコンテンツを過剰にサンプリングし、素早いカットを見逃すのに対し、本ツールはシーン変化検出に加えて密度下限を設け、意味のある視覚変化を捉えつつ、類似フレームを破棄します。

主な機能

• シーン変化検出 — 感度を設定可能 (--scene 0.30)
• スライディングウィンドウによる重複排除 (--dedup-window 4, --dedup-threshold 8%) — カットアウェイ後の同じショットを再送信しない
• 密度下限 (--fps-floor 1.0) — N秒ごとに最低1フレームを保証
• 総フレーム数の上限: --max-frames 150
• Whisperによる文字起こし — 言語自動検出 (--lang auto) または指定 (en, zh)
• URL（YouTube、Instagram、TikTok等）はyt-dlp経由、ローカルファイルも対応
• 出力は整理されたフォルダ: crv-out/frames/*.jpg、crv-out/transcript.txt、crv-out/MANIFEST.txt — これをClaude、ChatGPT、Geminiにドロップ
• 保持/破棄の判定を可視化するレポートを生成可能 (--report)

インストール

pip install claude-real-video           # コア（フレーム＋重複排除）
pip install "claude-real-video[whisper]"  # ＋音声文字起こし

システム要件: ffmpeg（brew install ffmpeg、sudo apt install ffmpeg、または winget install Gyan.FFmpeg でインストール）

使用例

# YouTube/Instagramリンク
crv "https://www.youtube.com/watch?v=..."

ローカルファイルに英語の文字起こし
crv lecture.mp4 -o out --lang en
フレームのみ、文字起こしなし
crv clip.mp4 --no-transcribe
ログインが必要なコンテンツにはクッキーファイルを指定
crv "https://..." --cookies cookies.txt

仕組み

本ツールは yt-dlp でURLの動画を取得し（オプションでクッキー使用）、ffmpeg でフレームを抽出し、シーン変化ごとと密度下限に基づいてフレームを取得します。スライディングウィンドウによる類似フレーム検出で重複ショットを排除します。音声はWhisper CLIで文字起こしします。すべてローカルで処理され、クラウドサービスへのアップロードはありません。