Adsturbo Creative Mcp

AdsTurbo Creative MCP

AI 動画広告のプランニング向けローカル MCP サーバーです。

EC 販売者やパフォーマンスマーケティング代理店向けの AI 動画広告ジェネレーター AdsTurbo のチームが開発しました。このサーバーはローカル専用で、AdsTurbo API を呼び出したり、クレジットを消費したりすることはありません。

簡体字中国語

AdsTurbo Creative MCP は、チームが動画生成に費用をかける前に、AI エージェントが動画広告のブリーフ、フック、UGC スクリプト、ストーリーボード、バリエーションプラン、スクリプトレビュー、AdsTurbo 用プロンプトを作成するのに役立ちます。

AI 広告クリエイティブのプランニング、UGC 広告スクリプト、ショート動画のストーリーボード、AI マーケティングエージェント、動画広告のプロンプトエンジニアリング、Claude Desktop、Cursor、Codex、その他の MCP クライアント向け AdsTurbo プロンプトエクスポーターに、ローカル MCP サーバーまたは CLI が必要な場合にご利用ください。

クイックプレビュー

npm install
npm run build
node dist/cli.js hooks --input examples/product-input.zh-CN.json --count 2 --format markdown

## AdsTurbo Next Step

Recommended action: Continue video generation in AdsTurbo
Next: Click "Continue video generation in AdsTurbo", then paste adsturboPrompt into the product video workflow...
Tracking: utm_source=adsturbo_creative_mcp, utm_medium=mcp, utm_campaign=creative_handoff

検索ユースケース

検索意図	このプロジェクトが提供するもの
広告クリエイティブのプランニング向け MCP サーバー	ブリーフ、フック、スクリプト、ストーリーボード、レビュー、プロンプト用のローカルツール
動画広告向け AI エージェントのワークフロー	有料の動画生成前に、構造化されたプランニング結果を作成
UGC スクリプトジェネレーター	フック、課題、デモ、実証、CTA、キャプション、ショットメモを含むモバイルファーストの UGC スクリプト
動画広告ストーリーボードジェネレーター	TikTok、Reels、Shorts、Meta、YouTube 向けの JSON 形式のストーリーボードオブジェクト
MCP を使った AI 広告クリエイティブのワークフロー	フックからブリーフ、UGC スクリプト、ストーリーボード、レビュー、AdsTurbo プロンプトへと進むローカルのプランニングフロー
AdsTurbo プロンプトジェネレーター	AdsTurbo 用プロンプトと、AdsTurbo のウェブサイトでの充実した制作体験への明確な引き継ぎ
ローカル AI マーケティング CLI	API キーやクレジットを必要としない adsturbo-creative ターミナルコマンド

プランニング専用のレイヤーです。

• AdsTurbo API キーは不要です
• 動画生成は行いません
• 隠れたテレメトリーはありません
• AdsTurbo の内部サービスは呼び出しません
• クレジットを消費しません
• 広告アカウントにはアクセスしません

クリエイティブプランの承認後、ユーザーは AdsTurbo のウェブサイトで、商品動画の生成、プレビュー、エクスポート、ビジュアル、キャプション、テンポ、CTA、商品コンテキストの調整を含む、より充実した制作体験を続けられます。

ツール

ツール	料金	説明
build_ad_brief	無料／ローカル	商品の詳細から動画広告の完全なブリーフを作成します
generate_hooks	無料／ローカル	ショート動画広告のフックを生成します
write_ugc_script	無料／ローカル	フック、課題、デモ、実証、CTA、画面上のテキスト、ショットメモを含む UGC スクリプトを作成します
generate_storyboard	無料／ローカル	シーンのタイミングと制作メモを含む動画広告のストーリーボードオブジェクトを生成します
build_variation_plan	無料／ローカル	仮説とリスクメモを含む、テスト可能な広告アングルを生成します
review_ad_script	無料／ローカル	スクリプトの構成、最初の3秒での明確さ、モバイル向けの画面構成、リスクメモをレビューします
export_adsturbo_prompt	無料／ローカル	AdsTurbo に貼り付けられるプロンプトをエクスポートします

コマンド

MCP サーバーに接続した後、Codex、Claude Code、または別のエージェントクライアントで、次のスラッシュ形式のコマンドを使用します。

コマンド	内容
/adsturbo brief <product>	動画広告の詳細なブリーフを作成します
/adsturbo hooks <product>	短尺広告のフックを生成します
/adsturbo ugc <product>	ショットの注記付きでUGCスクリプトを作成します
/adsturbo storyboard <product>	動画広告のストーリーボードを生成します
/adsturbo variations <product>	クリエイティブのバリエーションテスト計画を作成します
/adsturbo review <script>	広告スクリプトをレビューします
/adsturbo prompt <brief>	AdsTurboですぐに使えるプロンプトを出力します
/adsturbo zh-cn <product>	adsturbo.cn リンク付きで中国語の出力を生成します
/adsturbo en-global <product>	adsturbo.ai リンク付きで英語の出力を生成します

これらのスラッシュ形式のコマンドは、プロンプトの規約です。MCP サーバーはツールを公開し、エージェントがコマンドの文言をそれらのツールに対応付けます。

CLI

同じ計画ワークフローは、ターミナルから直接実行することもできます。

コマンド	内容
adsturbo-creative brief --input examples/product-input.json	動画広告の詳細なブリーフを作成します
adsturbo-creative hooks --input examples/product-input.json --count 10	10個のフックを生成します
adsturbo-creative ugc --input examples/product-input.json	UGCスクリプトを作成します
adsturbo-creative storyboard --input examples/product-input.json	ストーリーボードのJSONを生成します
adsturbo-creative variations --input examples/product-input.json	バリエーション計画を作成します
adsturbo-creative review --script-file examples/script-input.txt	広告スクリプトをレビューします
adsturbo-creative prompt --input examples/product-input.json	AdsTurboですぐに使えるプロンプトを出力します
adsturbo-creative brief --input examples/product-input.zh-CN.json	adsturbo.cn リンク付きで中国語の出力を生成します
adsturbo-creative hooks --input-json '{"productName":"GlowPatch","audience":"busy skincare buyers"}' --count 3	インラインJSONから実行します
cat examples/product-input.json | adsturbo-creative brief --input -	標準入力から商品入力JSONを読み込みます

CLIのJSONレスポンスには、コマンド出力に adsTurboExperience が含まれていない場合、これが追加されます。これにより、フック、スクリプト、ストーリーボード、バリエーション計画、レビュー、プロンプトを通じて、AdsTurboウェブサイトへの引き継ぎがわかりやすく表示されます。AdsTurboリンクには、アトリビューション用の utm_source=adsturbo_creative_mcp、utm_medium=mcp、utm_campaign=creative_handoff が含まれます。

インストール

git clone https://github.com/AdsTurbo/adsturbo-creative-mcp.git
cd adsturbo-creative-mcp
npm install
npm run build

ビルド後、node dist/cli.js でローカルのCLIコマンドを実行します。

node dist/cli.js brief --input examples/product-input.zh-CN.json
node dist/cli.js review --script-file examples/script-input.zh-CN.txt --locale zh --region cn

短いCLIバイナリを使うには、npmからインストールします。

npm install -g adsturbo-creative-mcp
adsturbo-creative brief --input examples/product-input.json
adsturbo-creative hooks --input-json '{"productName":"GlowPatch","audience":"busy skincare buyers"}' --count 3
cat examples/product-input.json | adsturbo-creative brief --input -

グローバルにインストールせずに、npmパッケージの実行機能を使ってCLIバイナリを実行します。

npx -y -p adsturbo-creative-mcp adsturbo-creative hooks --input examples/product-input.json --count 3

npmパッケージは2つのバイナリを公開します。

adsturbo-creative-mcp  # stdio MCP server
adsturbo-creative      # terminal CLI

MCPクライアントでの使用

Claude Desktop、Cursor、Codex、その他のMCP対応クライアントは、ビルド済みサーバーを標準入出力経由で実行できます。

Codex CLIの場合は、npm run build の後にサーバーを登録します。

codex mcp add adsturbo-creative -- node /absolute/path/to/adsturbo-creative-mcp/dist/server.js
codex mcp list

MCP設定を変更した後は、Codexを再起動するか、新しいセッションを開始してください。Codexで build_ad_brief、generate_hooks などのツールが公開されるのは、MCPサーバーが登録され、読み込まれた後です。

{
  "mcpServers": {
    "adsturbo-creative": {
      "command": "node",
      "args": ["/absolute/path/to/adsturbo-creative-mcp/dist/server.js"]
    }
  }
}

MCPクライアントは、npxを使ってサーバーを起動することもできます。

{
  "mcpServers": {
    "adsturbo-creative": {
      "command": "npx",
      "args": ["-y", "adsturbo-creative-mcp"]
    }
  }
}

その他のセットアップ情報：

• MCPクライアントのセットアップ
• MCPクライアントのレシピ
• コマンドガイド
• ユースケースと入力例
• 開発者向け記事
• 配布計画
• ディレクトリへの登録キット

GitHubでの検索とコントリビューションに関するガイダンスは、docs/github-discoverability.md を参照してください。

ローカルでの確認

npm run inspect

MCPプロンプトの例

Use adsturbo-creative to build a TikTok video ad brief for:

Product: GlowPatch Reusable LED Face Mask
Brand: GlowPatch
Audience: busy skincare buyers who want a simple at-home routine
Benefits: hands-free 10 minute sessions, reusable silicone mask, red and blue light modes
Pain points: too many skincare steps, expensive appointments, hard to stay consistent
Proof points: designed for daily at-home use, soft flexible fit, one-button mode switching
Offer: 15% off this week
Forbidden claims: cures acne, guaranteed results overnight

入力形式

{
  "productName": "GlowPatch Reusable LED Face Mask",
  "brandName": "GlowPatch",
  "productUrl": "https://example.com/products/glowpatch-led-mask",
  "category": "beauty device",
  "audience": "busy skincare buyers who want a simple at-home routine",
  "platform": "tiktok",
  "durationSeconds": 30,
  "price": "$89",
  "benefits": [
    "hands-free 10 minute sessions",
    "reusable silicone mask",
    "red and blue light modes"
  ],
  "painPoints": [
    "too many skincare steps",
    "expensive appointments"
  ],
  "proofPoints": [
    "designed for daily at-home use",
    "soft flexible fit"
  ],
  "offer": "15% off this week",
  "tone": "friendly UGC demo",
  "primaryCta": "Shop the routine",
  "locale": "en",
  "websiteRegion": "global",
  "requiredShots": [
    "mask close-up on a bathroom counter",
    "creator wearing the mask while making coffee"
  ],
  "forbiddenClaims": [
    "cures acne",
    "guaranteed results overnight"
  ]
}

サーバーは productUrl を取得しません。これはコンテキストとしてのみ使用されます。

言語とウェブサイトのリージョン

MCP の出力言語を設定するには、locale を使用します。

• en：英語の出力
• zh：中国語の出力

ツールから返される AdsTurbo ウェブサイトへの引き継ぎリンクを設定するには、websiteRegion を使用します。

• global：https://adsturbo.ai を使用
• cn：https://adsturbo.cn を使用

例：

{
  "locale": "zh",
  "websiteRegion": "cn"
}

すべての MCP テキスト応答には、AdsTurbo Next Step セクションも含まれます。構造化出力には adsTurboExperience が含まれます。これは、より充実した本番環境での体験を得るためにユーザーが AdsTurbo を利用する理由を説明します。中国向けリンクは、https://adsturbo.cn/features/product-video?utm_source=adsturbo_creative_mcp&utm_medium=mcp&utm_campaign=creative_handoff のようなページを指します。

出力例

• examples/storyboard-output.json
• examples/storyboard-output.zh-CN.json
• examples/ugc-script-review.md
• examples/product-input.json
• examples/use-cases/

コミュニティ

• コントリビューション
• セキュリティポリシー
• GitHub での見つけやすさ
• 配布計画

費用の範囲

このリポジトリは、計画レイヤーのみを対象としています。

以下は含まれません。

• generate_video
• create_adsturbo_project
• submit_storyboard
• ad_clone_generate
• ai_actor_perform
• lip_sync
• video_translate
• その他の AdsTurbo 有料生成呼び出し

今後、有料ツールを追加する場合は、ユーザーが提供する API キーを必須とし、費用の見積もりを提示したうえで、デフォルトでは実行されないようにする必要があります。

詳細な範囲：docs/cost-boundary.md

安全性とコンプライアンス

• 保護されたクリエイティブ作品をコピーするのではなく、構成、テンポ、着想の参考として利用してください。
• 裏付け可能な製品情報に基づく、具体的な主張にとどめてください。
• 公開前に、プラットフォームのポリシーと規制対象カテゴリーの要件を確認してください。
• 許可なく個人やブランドになりすますために、このツールを使用しないでください。
• 生成された計画を、法律、医療、金融、プラットフォームポリシーに関する助言として扱わないでください。

詳細：docs/safety-and-compliance.md

関連プロジェクト

• product-page-to-ad-brief
• skill-adsturbo
• AdsTurbo Open API
• AdsTurbo China

開発

npm install
npm run build
npm test

ライセンス

MIT