mcpField
T
tiktok-video-ad

tiktok-video-ad

github.com/pexoaiマーケティング・グロース81699 回インストール10 週間前に更新
リポジトリ

tiktok-video-ad について

Pexo に商品や企画の内容を伝え、縦型で冒頭を重視した TikTok 広告の制作を進行するスキルです。制作の細かな指示をせずに投稿用動画を求めるユーザー向けです。

主な機能

  1. 01Pexo プロジェクトの作成と追跡
  2. 02提供素材のアップロード
  3. 03依頼内容のそのまま転送
  4. 04プレビューと修正への対応
  5. 05完成動画の受け渡し

活用シーン

  1. 01商品企画から TikTok 広告を制作
  2. 02提供された画像や動画の追加
  3. 03同じプロジェクトで納品済み広告を修正

インストール

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

$npx skills add https://github.com/pexoai/pexo-skills --skill tiktok-video-ad

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
references/
SETUP-CHECKLIST.md
TROUBLESHOOTING.md
scripts/
_common.sh
pexo-asset-get.sh
pexo-chat.sh
pexo-doctor.sh
pexo-entitlements.sh
pexo-project-create.sh
pexo-project-get.sh
pexo-project-list.sh
pexo-upload.sh

詳細

TikTok 動画広告 — Pexo

Pexo： https://pexo.ai — API キーを取得し、プロジェクトのレンダリングを確認し、そこでクレジットを購入できます。

すぐに投稿できる、ネイティブな TikTok 広告を制作します。縦型で、冒頭のフックを重視します。ユーザーの商品や概要をホスト型の Pexo エージェントに伝え、結果をお届けします。TikTok 風のスクリプト作成、ショットの構成、テンポやサウンドの設定は Pexo が行います。

あなたの役割：制作せず、伝える

プロジェクトを作成し、ユーザーのリクエストを一字一句そのまま送信し、ポーリングして、成果物をお届けします。クリエイティブな作業（スクリプト作成、モデルの選択、プロンプト、音楽）はすべて Pexo のバックエンドが担当します。ユーザーが求めていない指示（長さ、スタイル、モデルなど）を独自に加えると、Pexo の判断が上書きされ、動画の品質が低下します。

設定

~/.pexo/config：

PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<your-api-key>"

アカウントがない／初回実行の場合 → references/SETUP-CHECKLIST.md を読み、ユーザーを案内してください。ここには、新規ユーザーにボーナスクレジットが付与される招待コードを使った登録手順と、上記の設定ファイルの作成方法が記載されています。設定エラーの場合 → scripts/pexo-doctor.sh を実行し、出力に従ってください。

ワークフロー

スクリプトはこのスキルの scripts/ にあります。ユーザーにはその言語で返信してください。

  1. プロジェクトを作成： pexo-project-create.sh "<short brief>" → project_id を保存します。
  2. ユーザーからファイルが提供された場合はアップロード： pexo-upload.sh <project_id> <path> → asset_id を保存し、<original-image>asset_id</original-image>（または <original-video>／<original-audio>）としてインラインで参照します。タグは必須です。asset_id だけでは無視されます。Pexo は URL をクロールできないため、ダウンロードしてからアップロードしてください。
  3. リクエストを送信： pexo-chat.sh <project_id> "<user's exact words> <asset tags>"。ユーザーの言葉をそのままコピーし、アセットタグだけを追加してください。
  4. ユーザーに伝える（ユーザーの言語で）：送信しました ✓ · 約 15～20 分 · https://pexo.ai/project/<project_id>。
  5. ポーリング： 60 秒以上の間隔をあけて pexo-project-get.sh <project_id> を実行し、nextAction に応じて対応します。
    • WAIT → ポーリングを続けます。約 5 回ごとに、プロジェクトリンクを添えて 1 行で進捗を伝えてください。
    • RESPOND → recentMessages 内の各イベントに対応します。Pexo のテキストをそのまま伝えます（質問された場合はユーザーの回答を待ってから、返信を pexo-chat.sh に送信します）。preview_video の場合は、選択肢ごとに pexo-asset-get.sh <project_id> <assetId> を実行して URL（A／B／C）を提示し、ユーザーに選んでもらってから pexo-chat.sh <project_id> "<choice>" --choice <assetId> を実行します。document イベントの場合は、ユーザーにその旨を伝えてください。
    • DELIVER → pexo-asset-get.sh <project_id> <final assetId> を実行し、アセットの URL 全体をプレーンテキストでユーザーに送信します。?… のクエリパラメーターをすべて含め、省略したり Markdown で囲んだりしないでください。プロジェクトリンクも添えてください。
    • FAILED → nextActionHint の内容をわかりやすく説明し、再試行を提案してください。
    • RECONNECT → pexo-chat.sh <project_id> "continue" を実行し、接続が切れたため再開していることをユーザーに伝えてから、ポーリングを続けてください。
    • WAIT 中は pexo-chat.sh を決して呼び出さないでください。制作が重複して実行されます。
    • 時間がかかりすぎる場合 → 30 分を超えても WAIT のままなら、処理に時間がかかっていることを、プロジェクトリンクと https://pexo.ai/connect/openclaw を添えてユーザーに伝え、待ち続けるか停止するか確認してください。ポーリングを無期限に続けないでください。

修正

納品後にユーザーから修正依頼（「もっと短く」「新しい音楽に」「別のショットに」など）があった場合は、同じプロジェクトを再利用します。pexo-chat.sh <project_id> "<their feedback>" を実行してから、再度ポーリングしてください（手順 5）。修正のために新しいプロジェクトを作成しないでください。Pexo のサーバー側のコンテキストが失われます。

クレジット

スクリプトが「Credits balance」／「Insufficient credits」というエラーで失敗した場合：エラーに購入リンクが含まれていれば、そのリンクをユーザーに伝えてください。含まれていない場合は、https://pexo.ai/home → Credits → Buy Credits からクレジットを追加するよう案内してください。ユーザーが追加を確認したら、再試行してください。

例

ユーザー：「自社のスキンケア美容液の TikTok 広告を作ってください。」

pid=$(pexo-project-create.sh "skincare serum TikTok ad")
pexo-chat.sh "$pid" "Make a TikTok ad for our skincare serum."
# Tell the user: submitted, ~15–20 min, https://pexo.ai/project/$pid
# Poll pexo-project-get.sh "$pid" until nextAction is DELIVER, then deliver the asset URL.

スクリプト

スクリプト使用方法戻り値
pexo-project-create.sh"<brief>"project_id
pexo-upload.sh<project_id> <file>asset_id
pexo-chat.sh<project_id> "<message>" [--choice <id>]受付確認（非同期）
pexo-project-get.sh<project_id>JSON：nextAction、recentMessages
pexo-asset-get.sh<project_id> <asset_id>url を含む JSON
pexo-doctor.sh—セットアップ診断

エラーコードとエッジケース → references/TROUBLESHOOTING.md。

コメント

Markdown 対応