Communitygithub.com

TikTok動画広告 — Pexo

縦型・フック重視のネイティブTikTok広告を自動生成します。Pexoエージェントにユーザーの商品や概要を伝えるだけで、台本・ショット構成・テンポ・サウンドまで全て完結。

TikTok動画広告 — Pexo とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)からPexo APIを介してTikTok向け動画広告を制作するためのツールです。ユーザーは商品や簡単な概要を伝えるだけで、Pexoが台本作成、モデル選択、プロンプト設計、音楽選定といったすべてのクリエイティブ作業を代行します。 スキルはプロジェクト作成・ファイルアップロード・メッセージ送信・ステータスポーリング・成果物取得の一連のワークフローをスクリプト化しており、エージェントはユーザーの入力をそのまま中継するだけで最適な広告を得られます。縦型・フックファースト形式で、そのままTikTokに投稿可能な出力を提供します。 対応プラットフォームはPexo(pexo.ai)で、APIキーとクレジット購入が必要です。セットアップ手順やトラブルシューティングは別途参照ファイルにまとめられており、初回利用時は招待コードを使用したサインアップフローをエージェントが案内します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pexoai/pexo-skills/tree/main/skills/tiktok-video-ad

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

TikTok動画広告 — Pexo は何をしますか?

Pexo: https://pexo.ai — APIキーを取得し、プロジェクトのレンダリング状況を確認、クレジットを購入してください。

ネイティブな、投稿可能なTikTok広告を制作します — 縦型でフックファースト。ユーザーの商品や概要をホスト型のPexoエージェントに中継し、結果を届けます。PexoがTikTokスタイルの台本を書き、ショットを構成し、テンポとサウンドを設定します。

あなたの役割:中継、作成はしない

プロジェクトを作成し、ユーザーのリクエストをそのまま送信し、ポーリングし、成果物を届けてください。Pexoのバックエンドがすべてのクリエイティブ作業(台本作成、モデル選択、プロンプト、音楽)を担当します。あなたが独自の指示(長さ、スタイル、ユーザーが指定していないモデルなど)を追加すると、Pexoの判断が上書きされ、品質の低い動画になります。

設定

~/.pexo/config:

PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<あなたのAPIキー>"

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

ワークフロー

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

  1. プロジェクトを作成: pexo-project-create.sh "<短い概要>" → project_id を保存します。
  2. ユーザーから受け取ったファイルをアップロード: pexo-upload.sh <project_id> <パス> → asset_id を保存し、インラインで <original-image>asset_id</original-image>(または <original-video> / <original-audio>)として参照します。タグは必須です — ベアの asset_id は無視されます。PexoはURLをクロールできません — ダウンロードしてからアップロードしてください。
  3. リクエストを送信: pexo-chat.sh <project_id> "<ユーザーの正確な言葉> <アセットタグ>"。ユーザーの言葉はそのままコピーし、アセットタグのみ追加してください。
  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 <assetId> を実行。document イベントの場合はユーザーにその旨を伝えます。
    • DELIVER → pexo-asset-get.sh <project_id> <最終assetId> を実行し、ユーザーに完全なアセットURLをプレーンテキストで送信 — すべての ?… クエリパラメータを含め、決して切り詰めたりMarkdownで囲んだりしないでください — さらにプロジェクトリンクも送信します。
    • FAILED → nextActionHint を平易な言葉で説明し、再試行を提案します。
    • RECONNECT → pexo-chat.sh <project_id> "continue" を実行し、接続が切れたが再開中であることをユーザーに伝え、ポーリングを継続します。
    • WAIT中に pexo-chat.sh を絶対に呼び出さないでください — 重複した動画生成を引き起こします。
    • 時間がかかりすぎる場合 → WAIT状態が30分を超えた場合、ユーザーに(プロジェクトリンク + https://pexo.ai/connect/openclaw とともに)実行時間が長くなっていることを伝え、待つか停止するかを尋ねてください。永遠にポーリングしないでください。

修正

成果物納品後、ユーザーから「短くして」「音楽を変えて」「別のショットで」などの調整依頼があった場合は、同じプロジェクトを再利用: pexo-chat.sh <project_id> "<フィードバック>" を実行し、再度ポーリング(ステップ5)してください。修正のために新しいプロジェクトを作成しないでください — Pexoのサーバーサイドコンテキストが失われます。

クレジット

スクリプトが「クレジット残高不足」/「インシュficientクレジット」エラーで失敗した場合: エラーに購入リンクが含まれていればユーザーに渡し、そうでなければ https://pexo.ai/home → クレジット → クレジットを購入 からクレジットを追加するよう伝えてください。ユーザーが確認したら再試行します。

例

ユーザー: 「スキンケア用セラムのTikTok広告を作って。」

pid=$(pexo-project-create.sh "スキンケアセラム TikTok広告")
pexo-chat.sh "$pid" "スキンケア用セラムのTikTok広告を作って。"
# ユーザーに伝える: 送信完了、約15~20分、https://pexo.ai/project/$pid
# pexo-project-get.sh "$pid" を nextAction が DELIVER になるまでポーリングし、アセットURLを届ける。

スクリプト

スクリプト使い方戻り値
pexo-project-create.sh"<概要>"project_id
pexo-upload.sh<project_id> <ファイル>asset_id
pexo-chat.sh<project_id> "<メッセージ>" [--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 を参照。

Individual skills in this repo

This repo contains 19 individual skills — each has its own dedicated page.

関連スキル