Reel → CapCut 下書き
必要なもの: 構築済みリール（reelsmith build <dir>）、CapCut MCP サーバー（capcut、このプラグインの .mcp.json にバンドル; /mcp で一度サインイン）、およびアップローダーと下書きビルダー用の CapCut プラグインバンドルがディスク上にあること（$(reelsmith root)/docs/capcut.md、環境変数 CAPCUT_PLUGIN_DIR、デフォルト ~/capcut-plugin を参照）。
手順
"sfx"を reel.json に追加 — 画面上のイベントごとに1エントリ:"sfx": [{"name": "whoosh", "t": 6.9, "vol": 0.5}, {"name": "click", "t": 30.62, "vol": 0.5}, {"name": "typing", "t": 2.5, "vol": 0.35, "dur": 1.4}, {"name": "my_sounds/rip.mp3", "t": 15.36}]whoosh,whoosh-short,pop,typing,click,sparkle,coin,chime,impact,shutter,ding(ID はengine/capcut.pyにあり)。それ以外は自分が所有するローカルオーディオファイルで、ステムとともにアップロードされます。reelsmith capcut stems <dir>→out/capcut/{video.mp4, voice.wav, music.wav}+files.json。ボイスと音楽は1つのゲイン（合計 −14 LUFS）とリミッターを共有。音楽はすでにボイスの下でダッキングされています。- アップロード:
capcut_asset_upload_credentialをversion: 2で呼び出し、すべてのファイルの正確なfile_nameとsize_bytesを指定（直前にサイズを再確認; 不一致があるとupload_files_mismatchで失敗）。次にprintf '%s' <ticket> | node "${CAPCUT_PLUGIN_DIR:-$HOME/capcut-plugin}"/x/plugins/codex/skills/capcut-upload/scripts/capcut-upload.mjs --files "$(cat out/capcut/files.json)" --upload-ticket-stdin --json > out/capcut/upload.json reelsmith capcut draft <dir>→out/capcut/draft.json（検証済み）。start_stdraft_session→push_stdraft_snapshotをbase_package_id: ""と下書き JSON で実行。作成者にweb_editor_urlを渡します。- 再度プッシュする前に、
get_stdraft_snapshotで取得し、その上に構築 — 作成者が下書きを編集している可能性があります（読み戻しはロッシーです。決して盲目的に変更を上書きしないでください）。小さな修正（音楽の末尾トリミング、音量など）は、Chrome で Claude を通じてエディタ上で行うことを推奨します。
作成者に伝えること
- 最初に聴くこと: CapCut ライブラリのサウンドは、タイムラインには配置されるが無音で再生されることが報告されています。その場合は、オーディオ → 効果音で置き換えるか、ローカルファイルを使用してください。
- 音楽: プレースホルダーステムをミュートし、ライブラリから耳でトラックを選びます。動画の長さにトリミングしてください（長いトラックは書き出し時に黒い尾が追加されます）。
- 書き出し（右上 → ダウンロード、1080p / 30 fps / MP4）は最初に作成者の CapCut クラウドに保存されます。クラウド容量が不足していると、「保存できませんでした」で書き出しが失敗します — CapCut スペースの空き容量を増やすか、エンジンの MP4 を保持してください。
- コネクタ独自のサウンド検索（
search_capcut_material）はプレビューなしの貧弱なタイトル検索です。完全なサウンドライブラリは CapCut アプリ内にしかありません。