Adsturbo Creative Mcp

AdsTurbo Creative MCP

用于 AI 视频广告策划的本地 MCP 服务。

由 AdsTurbo 团队开发。AdsTurbo 是一款面向电商卖家和效果营销机构的 AI 视频广告生成器。此服务仅在本地运行：不会调用 AdsTurbo API，也不会消耗额度。

简体中文

AdsTurbo Creative MCP 可帮助 AI Agent 在团队投入视频生成费用前，规划视频广告简报、吸睛开场、UGC 脚本、分镜、变体方案、脚本审核以及适用于 AdsTurbo 的提示词。

当你需要用于 AI 广告创意策划、UGC 广告脚本、短视频分镜、AI 营销 Agent、视频广告提示词工程的本地 MCP 服务或命令行工具，或需要适用于 Claude Desktop、Cursor、Codex 和其他 MCP 客户端的 AdsTurbo 提示词导出工具时，都可以使用它。

快速预览

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 Agent 工作流	付费视频生成前的结构化策划输出
UGC 脚本生成器	适合移动端的 UGC 脚本，包含吸睛开场、问题、演示、佐证、行动号召、字幕和镜头备注
视频广告分镜生成器	适用于 TikTok、Reels、Shorts、Meta 和 YouTube 的 JSON 分镜对象
基于 MCP 的 AI 广告创意工作流	从吸睛开场到简报、UGC 脚本、分镜、审核和 AdsTurbo 提示词的本地策划流程
AdsTurbo 提示词生成器	可直接用于 AdsTurbo 的提示词，并清楚指引用户前往完整的 AdsTurbo 网站体验
本地 AI 营销命令行工具	adsturbo-creative 终端命令，无需 API 密钥或额度

它仅提供策划层功能：

• 无需 AdsTurbo API 密钥
• 不生成视频
• 不包含隐藏遥测
• 不调用 AdsTurbo 内部服务
• 不消耗额度
• 不访问广告账户

创意方案获批后，用户可以前往 AdsTurbo 网站，体验更完整的制作流程：产品视频生成、预览、导出，以及围绕视觉效果、字幕、节奏、行动号召和产品背景进行迭代。

工具

工具	费用	描述
build_ad_brief	免费／本地	根据产品详情生成完整的视频广告简报
generate_hooks	免费／本地	生成短视频广告吸睛开场
write_ugc_script	免费／本地	撰写 UGC 脚本，包含吸睛开场、问题、演示、佐证、行动号召、屏幕文字和镜头备注
generate_storyboard	免费／本地	生成包含场景时长和制作备注的视频广告分镜对象
build_variation_plan	免费／本地	生成包含假设和风险备注的可测试广告角度
review_ad_script	免费／本地	审核脚本结构、前三秒的清晰度、移动端构图和风险备注
export_adsturbo_prompt	免费／本地	导出可粘贴到 AdsTurbo 中的提示词

命令

连接 MCP 服务后，可在 Codex、Claude Code 或其他 Agent 客户端中使用这些斜杠命令：

命令	功能
/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 服务提供工具，由 Agent 将命令措辞映射到相应工具。

命令行

你也可以直接在终端中运行相同的规划工作流：

命令	功能
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

如果命令输出中尚未包含 adsTurboExperience，命令行 JSON 响应会附带该字段。这样可以确保在钩子、脚本、分镜脚本、变体计划、审阅结果和提示词中都能看到跳转至 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 运行本地命令行命令：

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

从 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 包执行方式运行命令行二进制文件：

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

npm 包提供两个二进制文件：

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 或启动新会话。只有在 MCP 服务注册并加载后，Codex 才会提供 build_ad_brief、generate_hooks 等工具。

{
  "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。它仅用于提供上下文。

语言和网站区域

使用 locale 控制 MCP 输出的语言：

• en：英文输出
• zh：中文输出

使用 websiteRegion 控制工具返回的 AdsTurbo 网站跳转链接：

• 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 这样的页面。

输出示例

• 示例/storyboard-output.json
• 示例/storyboard-output.zh-CN.json
• 示例/ugc-script-review.md
• 示例/product-input.json
• 示例/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 中国

开发

npm install
npm run build
npm test

许可证

MIT