YouTube リテンション データから視聴者反応の良かった区間を自動抽出し、縦型ショート動画に変換するツールキット
中辛 の解説
Python 製で、YouTube Analytics ()・faster-whisper・ffmpeg が必要です。難易度は中程度で、 設定が 1 回あれば以降は で動きます。リテンション スパイク検出 → 字幕タイムスタンプ抽出 → 冷たい開始(Cold Open)に再構成 → 9:16 リフレーミング(顔は切り取り、画面共有はぼかし) → ヘッダー・字幕合成 → インスタ Reels セーフゾーン検証という 6 ステップをパイプラインで実行します。デモやサンプル出力は に記載されていません。
이런 레포예요
이럴 때 쓰면 좋아요
- YouTube の長時間動画から高反応ポイントを自動検出し、Instagram Reels や TikTok 用ショート動画を一括生成する
- 視聴者の「見直し(Rewind)」イベント データを活用して、本当に刺さった瞬間だけを切り出し、フックを付けてショート化する
- 複数チャンネルの運営者が、リテンション データと自動文字起こしを組み合わせてコンテンツ再利用の時間を削減する
핵심 기능
대안 대비 차별점
ランダムカットではなく、YouTube リテンション データと再生位置戻しイベント証拠に基づいて区間を選び、ペイオフ前にフック(冷開き)を自動配置する点が従来のショート自動化ツールと異なります。
食べた人たち
実際に使ってみた人の記録です — 一言も完走の記録も、確認のうえで公開しています。
このリポジトリの作り方
はじめてですか？ むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。
준비물
- Python 3.7以上
- ffmpeg(libass対応ビルド)
- Google Cloud OAuth 認証情報(YouTube リテンション取得時のみ)
すぐ動かしてみるPython (uv)
ギット飯がリポジトリの構成を確認して組み立てた実行コマンドです。ターミナルに貼り付ければ、取得から実行までまとめて進みます。
git clone --depth 1 https://github.com/choigpt-ai/retention-shorts.git && cd retention-shorts && uv venv && uv pip install -r requirements.txt
uv가 없다면: brew install uv · 실행 명령은 README를 확인하세요.
コードは自分の環境で動きます — はじめて見るリポジトリなら、中身にひととおり目を通してから実行するのがおすすめです。
README가 안내하는 자세한 단계 보기
- ffmpeg をインストール(libass ビルド必須、サブタイトルフィルター確認)
brew install ffmpeg
ffmpeg -filters | grep subtitles
- Python 依存関係をインストール
pip install -r requirements.txt
cp config/style.example.json config/style.json
-
Google Cloud Console で YouTube Analytics API を有効化し、OAuth デスクトップアプリ認証情報を JSON でダウンロード、
config/client_secret.jsonに保存 -
YouTube 動画のリテンション データを取得
python helpers/fetch_retention.py <YOUTUBE_VIDEO_ID>
- 音声を文字起こし(単語単位タイムスタンプ付き)
python helpers/transcribe.py longform.mp4 --language ko
- リテンション スパイクをマッピングして、希望区間を ffmpeg で抽出
ffmpeg -ss <start> -to <end> -i longform.mp4 -c:v libx264 -c:a aac cut.mp4
- 9:16 リフレーミング(人物は切り取り、画面共有はぼかし)
python helpers/reframe916.py cut.mp4 -o cut916.mp4 --mode crop --focus 0.5
- ヘッダー・字幕を合成(config で フォント・色・フッター指定)
python helpers/compose.py cut916.mp4 -o final.mp4 --title "フック 1行?!|解決 1行!" --srt subs.srt --config config/style.json
- 発行前にセーフゾーン検証
python helpers/reels_guide_qc.py final.mp4
ギット飯トライで味見
入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。
ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。
npx gitbap-try choigpt-ai/retention-shorts
Node.js さえあれば、インストールなしで動きます · ギット飯トライとは？ →
スター推移 · 7日
使いやすさ · まねしやすいか
- ゆるいライセンス
- テストあり
- サンプル集
- 最近の更新
- AGENTS.md
- llms.txt
- テンプレート
最近の更新あり · 2026 年に作成
「AI 미디어 생성」 こういうリポジトリを毎週受け取りませんか？
毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。
自分のリポジトリですか？ README にギット飯バッジを貼る
[](https://www.gitbap.com/r/choigpt-ai/retention-shorts)Claude からそのまま使う — ギット飯のつなぎ方
ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。
Claude の設定 → コネクタにこのアドレスを貼り付け。
https://www.gitbap.com/api/mcpプラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI が README をもとに要約しました · 原文を見る