Menu
エピソード番号またはLISTENのプレビューURLから「盛り上がり切り抜きショート動画」を生成するフルパイプライン。ユーザーが「#N のクリップ作って」「切り抜き動画を作って」「Magic Clips」「このプレビューリンクから作って」などと言ったときに使う。音声DL→文字起こし→ハイライト検出→字幕校正→Remotionレンダリングまでを一気通貫で行う。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | make-clip |
| description | エピソード番号またはLISTENのプレビューURLから「盛り上がり切り抜きショート動画」を生成するフルパイプライン。ユーザーが「#N のクリップ作って」「切り抜き動画を作って」「Magic Clips」「このプレビューリンクから作って」などと言ったときに使う。音声DL→文字起こし→ハイライト検出→字幕校正→Remotionレンダリングまでを一気通貫で行う。 |
エピソード番号を受け取り、盛り上がり部分の縦型ショート動画（1080×1920、字幕付き）を生成する。
デザインとデータ仕様の詳細は video/README.md と docs/design-system.md を参照。
ffmpeg（必須）python3 -m venv $SCRATCHPAD/venv && $SCRATCHPAD/venv/bin/pip install -q mlx-whisper
src/data/episodes.json から対象話数の number / title / pubDate / audioUrl を取得し、
mp3 をスクラッチパッドにダウンロードする。
予約投稿（未公開エピソード）の場合: RSSにまだ載っていないので episodes.json は使えない。
LISTENのプレビュー共有URL（https://listen.style/p/magicalfm/<slug>/<共有トークン> の
4セグメント形式）をユーザーからもらえれば、ログイン不要の curl 1発で全情報が取れる:
curl -sL "<プレビューURL>" -o $SCRATCHPAD/preview.html
grep -o '<title>[^<]*</title>' preview.html # 「N: タイトル - マヂカル.fm - LISTEN」→ number/title
grep -oE 'https://[^"]*\.mp3' preview.html | head -1 # 音声のCDN URL（これをDLする）
grep -oE '202[0-9]-[0-9]{2}-[0-9]{2}' preview.html | sort -u # 配信予定日
bun scripts/fetch-listen-transcript.mjs $SCRATCHPAD/preview.html listen.json # 話者分離もこのHTMLから取れる
プレビューURLが無い場合のフォールバック:
number / title / 配信予定日はユーザーに確認してプランに手で書くfetch-listen-transcript.mjs に渡す、
(b) それが無理なら F0 ピッチのフォールバックで割り当てて文脈検証を厚めにするいずれの場合も、公開前なので動画の内容がネタバレにならないかユーザーに一言確認する （ハイライト候補の提示と兼ねると1回で済む）。
$SCRATCHPAD/venv/bin/mlx_whisper ep.mp3 \
--model mlx-community/whisper-large-v3-turbo \
--language ja --word-timestamps True \
--output-dir $SCRATCHPAD --output-format json --verbose False
19分エピソードで数分かかるので バックグラウンド実行 し、待ち時間に他の準備を進める。
cd video && bun scripts/find-highlights.mjs <ep.mp3> <whisper.json> --top 5
RMSエネルギー上位の窓が文字起こし付きで出る。スコアはあくまで候補。 各候補の前後の文脈を transcript で読み、以下の基準で1つ選ぶ:
冒頭30秒はオープニング定型なので通常は避ける。
選んだ窓の単語タイムスタンプを whisper JSON から抽出し、
video/plans/ep-N.json を手組みする（既存の ep-263.json が見本）。
校正（必須）: Whisper の生出力は誤認識があるため、文脈から必ず直す:
組版ルール:
bg はエピソード番号 % 4 → 0:lilac / 1:lime / 2:sky / 3:candy（OGPと同じ）clipEnd は最後の単語の約2.2秒後（CTA表示ぶん）クリップタイトル（必須）: トップレベルに
"clipTitleLines": ["帝国がクローンを", "やめた理由"] を書く。タイトルカードに
エピソード名の代わりに表示される、ショート動画としての見出し。クリップの内容を
簡潔に表すフックにする（オチそのものはネタバレになるので書かず、興味を引く切り口で）。
1行 約8文字・最大2行。省略時はエピソードタイトル表示にフォールバックするが、基本は必ず付ける。
話者の割り当て（必須）: 各ページに "speaker": "michiru" | "upamune" | "guest" を
付けると、動画にアバターが表示され発話中の側がハイライトされる。
ゲスト回: プランのトップレベルに "guest": { "name": "kita" } を書くと、
ホスト2人の間にゲストのアバター（画像未指定なら 🎤 プレースホルダ）が並ぶ。
ゲストが喋るページには "speaker": "guest" を付ける。name は短く（表示幅の都合上
7文字以下推奨）。画像を使う場合は "avatar": "<public/配下のファイル名>" を追加。
割り当ては LISTEN (listen.style) の話者分離を第一ソースにする。ホスティング側で 発話セグメント単位の diarization が済んでおり、ページ単位のF0推定より正確:
# エピソード説明文の「LISTENで開く」リンクのURLを渡す
bun scripts/fetch-listen-transcript.mjs https://listen.style/p/magicalfm/<slug> listen.json
[{start, end, speaker(0|1), text}]。0/1 が誰かはエピソードごとに任意なので、
会話の文脈（誰が質問しているか・名前の呼びかけ）か F0（michiru ≈ 167Hz / upamune ≈ 115Hz、
librosa の yin で確認）でそのエピソードのラベル対応を決めるcd video
bun scripts/build-clip.mjs plans/ep-N.json <ep.mp3>
bunx remotion still src/index.ts Clip out/check.png --frame=<確認したいフレーム>
bunx remotion render src/index.ts Clip out/magicalfm-N-clip.mp4
ffmpeg -ss <秒> -i out.mp4 -frames:v 1 check.png で 3フレーム以上 抽出して確認:
open で動画を開いてユーザーに報告するレンダリング済みの動画は Cloudflare R2（clips.magical.fm）にアップロードし、
src/data/clips.json にエピソード番号キーで自動追記する（1エピソードに複数可）:
cd video
bun scripts/upload-clip.mjs out/magicalfm-264-clip.mp4 264 "50歳でもバリベイビー"
初回のみ bunx wrangler login でCloudflareにログインしておく。
エピソード詳細ページに「切り抜きクリップ」セクションとしてリンクが表示される。
第3引数の label にはクリップのオチ・見どころを短く書く。