mcpField
O
openclip-ugc-ads

openclip-ugc-ads

github.com/openclip-appマーケティング・グロース142 回インストール12 週間前に更新
リポジトリ

openclip-ugc-ads について

openclip-ugc-adsは、構造化されたクリエイティブブリーフからOpenClipで縦型のUGC広告クリップを作るスキルです。クリエイター選択、非同期レンダリングの確認、広告案の比較方法を案内します。

主な機能

  1. 01チーム別クリエイターの一覧
  2. 02プリセットや構造化ブリーフから生成
  3. 03レンダリング結果のポーリング
  4. 04過去のクリップジョブを確認
  5. 05テストごとに要素を一つ変更

活用シーン

  1. 01短いUGC広告クリップの作成
  2. 02フックやクリエイターの比較
  3. 03以前のクリエイターの特定と再利用
  4. 04レンダリング状況と動画の確認

MCP 対応

OpenClipのリモートMCPサーバー `https://openclip.app/mcp` を使用します。クリエイター一覧、クリップ生成、ジョブ状況の確認、過去のジョブ閲覧ツールを利用できます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/openclip-app/agent-skills --skill openclip-ugc-ads

インストール後、Claude Code で/openclip-ugc-adsを入力して読み込まれたか確認します。

詳細

OpenClip：UGC 広告の生成

generate_ugc は、クリエイティブブリーフから短い縦型のUGC風クリップ（約7～12秒）をレンダリングします。無料アカウントでは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： Settings、Connectors、"Add custom connector" の順に進み、URLを貼り付けてサインインします。
  • Cursor（.cursor/mcp.json）：{ "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
  • ヘッダーのみのクライアント： openclip.app/settings/connect でMCPトークンを発行し、Authorization: Bearer <token> を指定して https://openclip.app/mcp/key に接続します。

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

一連の流れ

  1. 最初に必ずクリエイター一覧を確認します。 list_ugc_creators は、このチームで有効な creator と start_frame の値を返します。ニッチ別にグループ化された厳選クリエイター一覧と、チーム独自の保存済みクリエイターが含まれます。クリエイター名を推測せず、この呼び出しから選んでください。
  2. 生成します。 generate_ugc(...) では、次のいずれかを指定します。
    • brief_name - サーバー側のプリセット。手早く生成できます。
    • brief - 構造化されたクリエイティブ項目（character など）を含むインラインオブジェクト。
  3. ステータスを確認します。 ugc_job のハッシュIDが返されます。10～15秒ごとに get_ugc_job_status(ugc_job) を呼び出して確認してください。queued / rendering は処理中です。completed では video_url と result_meta（長さ、寸法、fps、seed）が返されます。failed では error が返されます。
  4. 過去の作業を確認します。 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-clippingを使用します。生成したクリップのトリミング、クロップ、圧縮を無料で行うには、openclip-video-editingを使用します。

コメント

Markdown 対応