OpenClip: UGC広告生成は何をしますか？

generate_ugc は、クリエイティブブリーフから短尺の縦型UGCスタイルクリップ（約7～12秒）をレンダリングします。無料アカウントは1日1回の生成に制限されています。有料アカウントは、レンダリングした秒数に応じてクレジットが消費されます。

レンダリングは負荷が高く、1クリップあたり数秒ではなく数分かかることがあります。

セットアップ（初回のみ）

OpenClip は https://openclip.app/mcp にあるリモートMCPサーバーです。OAuthプロンプトが表示されたらOpenClipアカウントでサインインしてください。コピーするAPIキーはありません。

Claude Code: claude mcp add --transport http openclip https://openclip.app/mcp を実行し、/mcp で認証します。
Claude Desktop / web: 設定 → Connectors → 「Add custom connector」でURLを貼り付け、サインインします。
Cursor (.cursor/mcp.json): { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
ヘッダーのみのクライアント: openclip.app/settings/connect でMCPトークンを発行し、Authorization: Bearer <トークン> を付けて https://openclip.app/mcp/key に接続します。

動作確認: get_account を呼び出します。

ループ

最初にロスターを確認します。 list_ugc_creators は、このチームで有効な creator と start_frame の値を返します。厳選されたロスターとチーム独自の保存済みクリエイターがニッチごとにグループ化されています。クリエイター名を推測せず、この呼び出しから選んでください。
生成します。 generate_ugc(...) を以下のいずれかと共に使用します:
- brief_name - サーバー側のプリセット（高速パス）、または
- brief - 構造化されたクリエイティブフィールド（character など）のインラインオブジェクト。
ポーリングします。 ugc_job のハッシュIDが返されます。10～15秒ごとに get_ugc_job_status(ugc_job) をポーリングします。queued / rendering は処理中です。completed は video_url と result_meta（時間、解像度、fps、シード）を返します。failed は error を返します。
過去の作業を確認します。 list_ugc_jobs はチームの過去のUGCクリップを一覧表示します。これにより、見失った ugc_job IDを見つけてポーリングできます。

ブリーフは構造化されており、プロンプトではありません

エージェントが最も間違えやすい点です。brief は 散文のプロンプトではありません。個別のクリエイティブフィールド（character やAPIが受け付けるその他のフィールド）のオブジェクトです。1つのフィールドに段落を書くと構造が無駄になり、曖昧な出力になります。

各フィールドには、具体的で物理的、撮影可能な詳細を記述してください:

フレーム内にあるものを名前で指定し、どのように感じさせるかではありません。「胸の高さでボトルを持ち、後ろにキッチンカウンター」は「エネルギッシュで意欲的な雰囲気」よりも優れています。
1フィールドに1アイデア。character に3つのビートを詰め込まないでください。
制約は形容詞よりも良い出力を生みます。具体的な設定、具体的な小道具、具体的なアクションは、「高品質、プロフェッショナル、魅力的」よりも優れています。

広告の角度をテストする

ユーザーが1つのクリップではなく複数のバリエーションを希望する場合、比較に意味を持たせるために、レンダリングごとに1つの変数を変更します:

同じクリエイター、異なるフック。
同じフック、異なるクリエイター（誰がメッセージを伝えるかをテストする場合）。
同じものすべて、異なる start_frame（サムネイルの瞬間をテストする場合）。

無料アカウントは1日1回の生成のため、無料アカウントではほぼ重複するものではなく、最も異なる角度の1つに使用してください。バッチを約束する前に get_account で確認してください。

ルール

セッションでの最初の生成前に必ず list_ugc_creators を呼び出します。ロスターはチーム固有で変更される可能性があります。
必ずポーリングします。レンダリングには数分かかり、generate_ugc は即座に戻ります。
クリップはデフォルトで短く、約7～12秒です。60秒の広告を約束しないでください。
無料ティアは1日1回の生成です。無料アカウントでバッチを計画する前に、そのことを伝えてください。
result_meta には seed が含まれます。ユーザーがレンダリングを気に入り、近いバリエーションを希望する場合は、それを保持してください。

エラー

ツールの失敗は、HTTPステータスではなく、isError: true とプレーンテキストメッセージを含むツール結果として返されます。"Not authenticated. Reconnect your OpenClip token." はトークンの再接続または再発行が必要です。バリデーションメッセージ（未知のクリエイター、不正なブリーフなど）はメッセージテキストとして返されるため、引数を修正して再試行してください。

プロンプトからアクションへの例

「私のアプリのUGC広告を作って」 - list_ugc_creators、適切なクリエイターを選択、generate_ugc(brief={...})、get_ugc_job_status をポーリング、video_url を返す。
「テストする3つの角度を教えて」 - 角度ごとに1レンダリング、毎回1変数を変更、それぞれポーリング。無料アカウントの場合は最初に1日制限を確認。
「前回と同じ女の子を使って」 - list_ugc_jobs で前回のジョブを検索し、そのクリエイターを読み取り、再利用。
「どんなクリエイターが使える？」 - list_ugc_creators、ニッチごとにグループ化して表示。

OpenClip: UGC広告生成