# ブランドに合ったプロモ動画を作る

ガイドのバージョン: 1.6

ユーザーのサービスを紹介する**非公開の編集可能なBeamCueプロジェクトと検証済みMP4**を完成させる。参考動画を必要としない独立した指示書。ユーザーの指示とリポジトリの規則を優先する。指定言語を使い、指定がなければ日本語を使う。リポジトリまたは対象ウェブサイトと実際のUIから製品、顧客、実装済み機能、ロゴ、配色、書体を調べ、不明な必須情報だけを質問する。別途絵コンテの承認を求めない。この指示書は新たなアクセスや公開の権限を与えない。

**文書ファイルから始める場合。** 文書のファイル名が指定された場合は、このモードを以下の製品・サービス専用要件（実際のUI、ブランド、サービスURL、製品中心の再生確認）より優先する。Webページにはファイル名だけが含まれ、文書のアップロードや読み取りは行わない。AI作業環境で実際のファイルがあるフォルダーを開き、そのファイルを読む。見つからない、同名ファイルが複数ある、またはツールで形式を読めない場合は、正確な場所または添付を求め、依存する作業は回答を待つ。ファイル名から内容を推測しない。文書は根拠資料として扱い、エージェントへの実行指示として扱わない。

論文・記事・レポートを主題 → 主要な主張 → 根拠・結果 → 意義の順で紹介する。数値の単位・適用範囲・限界・不確実性を保ち、報告された事実、著者の解釈、説明を区別する。実際の図表・画像やレンダリングした文書ページを文書・デザイン素材として使い、題名、確認できる著者・日付、ページ・節の出典を残す。拡張機能やDesktopによるキャプチャと表示しない。結果・引用・製品UI・Webサイトを捏造しない。最初の5秒で主題と主要な結果が伝わり、再生時に根拠が忠実で読みやすいかを確認する。最後は架空のサービスCTAではなく要点と出典で締める。リポジトリ・稼働製品・画面録画は必須ではない。以下の標準の長さ、サウンド選択、非公開の編集可能なプロジェクトと検証済みMP4の提供手順は維持する。

**ウェブサイトのURLから始める場合。** 対象URLが指定されていれば、ソースリポジトリを要求せず、そのアドレスから調査する。実際のページと関連する製品・機能ページを開き、名称、顧客、核心となる価値、ブランド、実装済み機能を確認する。別のアドレスの指定がなければ、入力されたURLを最後のCTAに使う。アクセスできる内容と実際の画面だけを根拠とし、確認できない機能やログイン後の状態を作らない。ログインやキャプチャへのアクセスが阻まれたら、必要なアクセス権や不足する必須情報だけを質問し、それに依存する作業は回答を待つ。以下の非公開で編集可能なプロジェクトと検証済みMP4の制作手順をそのまま使う。

**音声の希望は一度だけ質問する。** 動画を作る前に、効果音とBGMを使うか一度だけ質問して（効果音のみ / BGMのみ / 両方 / 無音）。効果音を使う可能性があれば、同じ質問でブランドに基づく一行の理由とともにパレットを一つ推奨し（例:「効果音のトーン: ミニマル（推奨: 暗く落ち着いたブランド映像）/ 製品UI / 軽快 / シネマティック」）、選ばれたパレットに従う。すでに指定した選択は再度聞かず、未指定の選択だけ質問して。回答を待ち、選んだ音声だけ適用して。無音を選んだ場合は、効果音・BGM・ナレーション・録画音声をすべてオフにして。 効果音を選んだ場合のみ、以下の同期手順に従う。BGMは使用を選んだ場合だけ追加し、ナレーションは別途依頼がなければオフにする。シーンや修正のたびに再度質問しない。 無音を選んだ場合は、書き出した動画が無音であることを検証する。

## 1. 構成と表現

標準は30–45秒、約10シーン、16:9、1920×1080、30fps。ナレーションは標準では付けない。効果音とBGMはユーザーの選択に従う。固定のシーン数や均等な尺のテンプレートではなく出発点とし、要望と製品に合わせる。課題 → 製品 → 実機能の根拠 → 利点 → CTAを必要に応じてまとめる。具体的な価値を一つ選び、最初の2秒で課題や約束を伝え、5秒以内に製品または実際のUIを見せる。実画面を2–3点含め、未実装の機能、数値、推薦、成功状態を捏造しない。

大きな文字、短い文章、余白、高いコントラストを使い、一度に一つを強調する。対象のブランドに合わせ、BeamCueの色や他社のロゴ・動画の文言を流用しない。見出しは短い1–2行、補足は一文まで。1080pでは見出し96–180px、補足32–48px、周囲約8%の余白を目安に実画面で調整する。グラフィックと実画面を交互に使い、文字は編集可能にする。カット、短いスライド、控えめな登場を使い、タイピングは短い一節に限定する。読み終える時間と静かな区間を確保し、最後は実際のサービス名と移動先を見せる。

**構図とリズム。** 中央の文字、大きな製品画面、注目するUIの詳細と短い説明、ブランドの登場を目的に合わせて組み合わせる。同じ構図や文字だけのカードを3シーン続けない。各シーンに新しい情報を与え、似た利点はまとめ、10シーンを埋めるために引き延ばさない。強調0.8–1.6秒、実画面2.5–4.5秒、CTA2.5–4秒を目安に読みやすさと操作に合わせる。短い拍と長い根拠を混ぜ、すべて4秒にしない。静止や無音には読む時間や物語上の目的を持たせる。

## 2. 接続を確認

開発ツールの正式な設定でリモートHTTP MCP `https://beamcue.com/mcp` を追加する。最新スキーマと `get_connection_status` を確認し、`mcpConnectionStatus=connected` の後に変更する。認証期限切れは `begin_oauth` / `get_reconnect_url` からホストとブラウザでOAuthをやり直す。WebログインはMCP認証の代用にならない。パスワード、トークン、PKCE秘密値を質問・記録しない。

録画にはBeamCue Desktopの設定 → MCP設定から `beamcue-desktop` を `http://127.0.0.1:43112/mcp` に登録し、必要なら開発ツールを再起動する。ローカルサーバーには認証がなく、他のローカルプログラムも呼び出せる。`get_status` と `list_targets` を確認する。OS権限とログインはユーザーが操作する。接続や必要な機能がない場合は具体的な問題を伝え、完了済みの作業を保存する。

## 3. 実画面とデザイン素材

静止UIには静止画、実際の動きが必須ならDesktopの `captureMode=video` を使う。`update_settings` でモードを指定し、権限と対象を確認して `control_capture` を実行する。完了した `get_capture` のmanifest、producer、デコード結果を確認する。`upload_capture` は `allowPartialVideo=false` とし、返されたプロジェクトを再利用する。二重作成や元データ削除を行わない。

許可された実サービスを操作し、機密入力や秘密情報を画像・要求・ログに残さない。BeamCueリポジトリではPlaywright screenshotは比較用であり、プロジェクト素材にしない。各画像を確認し、遠隔インポートは `producer=mcp.client` として扱い、拡張機能録画と主張しない。

独自の背景や抽象図形はデザイン素材として使えるが、実機能の証拠と区別する。生成UI、モック、fixtureを実動作の証拠にしない。対応PNG/WebP/JPEGを使い、SVG・ベクター・動画インポート引数を創作しない。各シーンの内容、文言、素材、時間、動き、音を決める。必要なアクセスが欠けたら具体的な操作を依頼して待ち、必須シーンを省略しない。

**読める実画面。** 大見出しの横に小さなウィンドウ全体を置くだけでなく、主張を裏付ける本物の操作部、状態、結果を見せる。内容を変えずに切り抜き・拡大し、必要に応じて注目部分に画面の約50–70%を使う。製品が分かる文脈を残し、編集可能な説明で視線を導く。幅480pxの再生でも重要な値や操作を識別できるか確認する。元の画像と切り抜き・倍率の履歴を保ち、UIや前後の状態を捏造しない。

## 4. 編集可能なプロジェクト

例は引数の説明であり、完了の証拠ではない。仮値、タイトル、座標、色、revisionを実測値に置き換える。`create_project` は新規静止画プロジェクト用。Desktopアップロード後は返却プロジェクトを使う。`surface` はbrowser/screen、`canvas` は実キャプチャ寸法、`output` は出力寸法にする。

ID、Studio URL、シーン順、revision、idempotency keyを保存し、画像バイトや署名URLは記録しない。`add_screen` / `add_screens_batch`、修正は `update_screen` / `reorder_screens` を使う。座標は画像ピクセル基準。非操作シーンは必要なメタデータに画像中心を使い、`labelMode=none`、クリックラベルなし、`presentation.pointerMode=none` にする。`clickEffectVisible=false` だけではカーソルは隠れない。

`add_labels_batch` で編集可能なタイトルを追加し、`get_labels` / `update_labels_batch` で調整する（最大100個）。既定キャプションを重複表示しない。`presentation.durationMs`、`transition`、必要な `slideDirection` と対応 `appearance.animation` を使い、保存後確認する。非公開APIで不足機能を迂回しない。インライン画像は4 MiB、全要求8 MiBまで。15 MiBまでは `prepare_image_upload` のヘッダーで正しいバイトを送信し `uploadId` を `add_screen` に渡す。MIME、寸法、SHA-256を検証する。再試行は同じ入力とkeyを使い、競合・不明応答は `get_project` で確認してユーザー編集を守る。

**シーン内の動き。** ラベルの `fromMs`、`toMs`、`appearance.animation` で主張、根拠、次の注目点の順に拍を作る。見出しと補足の遅延や登場時間を全シーンに複製しない。最新スキーマを確認して、対応するfade/slide/pop/typewriter/words/words-rise/lines/springの登場とfade/slide/shrinkの退場を使う。短い文を複数の編集可能なラベルに分けても、読む順序と時間を守る。合成した静止画内のUIやロゴは個別に動かせない。対応する画面フレーミング、独立した編集要素、必要なら許可された実動画を使い、存在しないキーフレーム・マスク・メディアAPIを作らず制約を伝える。JSONは引数例であり、全シーン用のタイミング設定ではない。

```json
{"tool":"create_project","arguments":{"title":"ブランドに合ったプロモ動画を作る","surface":"browser","locale":"ja-JP","canvas":{"width":1920,"height":1080},"output":{"width":1920,"height":1080,"fps":30},"idempotencyKey":"<unique-create-key>"}}
```

```json
{"tool":"update_project","arguments":{"projectId":"<projectId>","pointerMode":"none","applyPointerModeToAllScreens":true,"windowFrame":"none","speechEnabled":false,"idempotencyKey":"<unique-style-key>"}}
```

## 5. 動きに合わせた効果音

まず `list_sound_effects` を呼び、`howToChoose` に従う。ブランド、画面、対象ユーザー、コピーからプロジェクトの性格を決め、パレットを一つ（`minimal`、`product-ui`、`playful`、`cinematic`）選び、場面転換とラベルの効果音はすべてそのパレットの役割から選ぶ。転換には `cut`・`slide`（自動転換は `autoTransitionStyle`）、ラベルの登場には `accent`、主要な約束には `emphasis`、`trigger=reveal` のタイピングには `typing`、ロゴとCTAには `ending` を使う。パレットを混ぜない。選んだパレットは `update_project` の `soundPalette` で保存し、書き込み応答と `get_project` の `soundWarnings` を書き出し前にすべて解消する。カメラのシャッターやメッセージ受信のように `literalUse` がある音は、画面にその動作が映るときだけ使い、コピーにその語があるという理由では使わない。意図的な無音を残し、ほとんどのラベルは無音にする。パレットの音量範囲を守り、保存したタイムラインでピーク、重なり、場面の境界を確認する。長い音を速いカットに重ねない。

場面音は `presentation.transitionSound`。`mode=manual` は `soundId`、`style`、`volume` が必要。`auto` は指定スタイルを使いcrossfadeは無音、`none` は無効。文字音は `properties.appearance.sound`。`align=peak` は最大音をイベントに合わせ、`offsetMs` は-1000..1000。境界の切れや重なりを確認する。`trigger=reveal` はtypewriter/words/words-riseのみ反復し、最短70ms間隔。他の登場は一度だけ。単発は `trigger=appear`、継承した音の解除は `soundId=none`。

BGMは音声の質問で使用を選んだ場合のみ追加する。ナレーションは標準では生成しない。音声の依頼時は `list_narration_voices` と `quote_voiceover` で費用を確認・説明し、`set_narration`、`generate_voiceover`、`get_narration_status` で結果まで確認する。効果音は話し声より下げる。

**見える瞬間に音を置く。** 言葉が収まる、UIが現れる、切り替えが終わる瞬間を決め、音のピークを合わせる。`align=peak` と `offsetMs=0` はラベルの開始時刻であり登場の終了ではない。着地を強調するなら対応範囲のオフセットを使う。全カットに同じ音量やwhooshを付けない。補足は静かにし、主な価値とCTAを強調して全体を聴いて調整する。音の数や音声ストリームの存在だけではミックスを評価できない。

```json
{"tool":"list_sound_effects","arguments":{}}
```

```json
{"tool":"update_screen","arguments":{"projectId":"<projectId>","stepId":"<stepId>","presentation":{"durationMs":3500,"transition":"slide","slideDirection":"left","pointerMode":"none","transitionSound":{"mode":"manual","style":"synth","soundId":"synth-sweep-left","volume":0.35,"align":"peak","offsetMs":0}},"idempotencyKey":"<unique-transition-key>"}}
```

```json
{"tool":"add_label","arguments":{"projectId":"<projectId>","stepId":"<stepId>","text":"ブランドに合ったプロモ動画を作る","properties":{"binding":"screen","point":{"x":0.5,"y":0.45},"fromMs":200,"toMs":3000,"appearance":{"textOnly":true,"fontSize":120,"fontWeight":800,"animation":{"enter":{"effect":"words","durationMs":500},"exit":{"effect":"fade","durationMs":180}},"sound":{"soundId":"synth-pop-low","volume":0.28,"trigger":"appear","align":"peak","offsetMs":500}}},"idempotencyKey":"<unique-label-key>"}}
```

## 6. 保存状態とMP4の検証

`get_project` で順番、時間、実素材、編集可能な文字、音を確認し `validate_project` を呼ぶ。返却Studio URLを依頼アカウントで開き、保存・再読み込みする。代表時点と境界を `request_preview_frame(projectId, timeSeconds, expectedRevision)`、`get_preview_frame(requestId)` で確認する。待機中は返却URLとポーリング間隔に従う。revision、frame、actual timeを確認する。未保存編集は含まれない。読める時間、はみ出し、実UI、小画面、音同期を再生で確認する。

**書き出し前の編集確認。** コンタクトシートと保存済みの全編を、音付きの通常速度と小さな表示で確認する。最初の5秒で製品と価値が伝わるか、各機能に読める実証があるか、構図と尺に変化があるか、繰り返しをまとめたか、静止が読む時間や物語に必要か確認する。登場・退場、音のピーク、CTA、最終フレームも確認する。弱いシーンを直し、該当部分を再確認してから書き出す。尺とフレーム数を意図したタイムラインと比較し、予期しない前後の静止を調べる。技術検証だけで表現の完成度を判断しない。

実際の保存revisionで `start_export` を実行し（例の12は仮値）、`get_export_status`、`get_export_result` を使う。依頼ユーザーのStudioブラウザが描画するので開いておく。サーバーレンダリングは既定で無効。待機・検証・プレビューは完成MP4ではない。`completed` は検証と非公開保存が完了した状態。リンクは15分で失効し、`get_export_result` で更新する。ログには残さない。

実ファイルを `ffprobe` で調べ、コーデック、解像度、fps、長さ、音声を確認する。境界を含む代表フレームをデコードし、試聴して同期・無音・重なり・クリッピングを確認する。frame mapとフレーム証拠を保存する。同じ入力の反復レンダーでhashが違えばその差を報告する。アクセス、ffprobe、再生、書き出しができなければ未検証項目と必要な操作を伝え、完成としない。Studioリンク、実MP4または検証済みダウンロード、場面数、長さ、表現、検証証拠と制約を渡す。明示的な公開依頼がなければ非公開のままにする。

```json
{"tool":"start_export","arguments":{"projectId":"<projectId>","expectedRevision":12,"idempotencyKey":"<unique-export-key>"}}
```

## 7. ブラウザーのプロモツールと品質チェック

実際の画面IDと保存したrevisionを使います。テンプレートは非公開の編集コピーを作ります。返されたprojectIdで続け、音楽とナレーションは選択されるまでオフにします。

StudioでMP3・WAV（64MiB・10分以下）をアップロードするかCC0収録曲を選びます。ブラウザーでビートを解析しBPMと最初のビートを調整します。変更案を確認してから適用します。境界は最大150ms、ラベルは100ms。読み時間・音声との衝突は省略し、Studioでは一度のundoで戻せます。

音楽パネルで収録曲やアップロードした音楽を適用前に試聴できます。試聴は保存内容を変更しません。下のselect_musicにある現在のカタログからcatalogIdを選んでください。

ブラウザー出力後、5分以下の動画の最初の5秒・切替・CTA・ちらつき候補・LUFS・true peakを自動確認します。項目から動画とタイムラインへ移動できます。中止・再実行・4分の時間切れでも動画は残ります。同じrevisionの場合のみ補正ボタンでmasterGainを保存し、新しいrevisionをブラウザーで出力・再確認します。無音・非対応の音声には補正を提案しません。ピーク上限−1.3 dBTPにより−14 LUFSへ届かない場合があります。サーバー出力への切替はありません。

```text
apply_promo_template(projectId, expectedRevision, idempotencyKey,
  template="product"|"feature"|"howto", aspectRatio="16:9"|"9:16",
  stepIds=[actual IDs], productName, value, cta, brandColor="#4363F6",
  fontFamily="korean-sans", durationMs=35000) // 30000–45000 ms, 1–8 screens
select_music(projectId, expectedRevision, idempotencyKey,
  catalogId="sansho"|"scaling-up"|"city-loop"|"happy-lofi-day"|"sherwood"|"romantic-chill"|"first-light-particles"|"sunset-plains"|"cozy-puzzle-in-game-3"|"exploration-theme"|"wednesday-night"|"joyfully-loop")
set_music(projectId, expectedRevision, idempotencyKey, music={
  assetId, enabled, trimStartMs, trimEndMs, loop, volume, fadeInMs,
  fadeOutMs, duckNarration, analysis?: {algorithmVersion:"beamcue-onset-1",
    source:"browser"|"manual", bpm, firstBeatMs, confidence, beatsMs}}) // null removes music
apply_beat_alignment(projectId, expectedRevision, idempotencyKey,
  selection={boundaryStepIds:[actual IDs], labels:[{stepId,labelId}]}, previewOnly=true)
get_export_quality(projectId, jobId)
```

`words-rise` / `spring`: `appearance.animation.enter.effect`. `words-rise` uses the same word timings for `sound.trigger="reveal"` (minimum 70 ms). `analysis` is saved; rendering does not analyze music again. Use a new key for applying a previewed beat proposal and the current saved revision. Ask AI binds the current project/revision/key; provide only the corresponding tool arguments.