AdsTurbo Creative MCP

AdsTurbo Creative MCP

Servidor MCP local para planejamento de anúncios em vídeo com IA.

Desenvolvido pela equipe por trás do AdsTurbo, um gerador de anúncios em vídeo com IA para vendedores de ecommerce e agências de performance. Este servidor é exclusivamente local: ele nunca chama a API do AdsTurbo e nunca gasta créditos.

简体中文

O AdsTurbo Creative MCP ajuda agentes de IA a planejar briefs de anúncios em vídeo, ganchos, roteiros UGC, storyboards, planos de variação, revisões de roteiro e prompts prontos para o AdsTurbo antes de a equipe gastar com geração de vídeo.

Use-o quando precisar de um servidor MCP local ou CLI para planejamento criativo de anúncios com IA, roteiros de anúncios UGC, storyboards para vídeos curtos, agentes de marketing com IA, engenharia de prompts para anúncios em vídeo ou um exportador de prompts AdsTurbo para Claude Desktop, Cursor, Codex e outros clientes MCP.

Prévia rápida

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

Casos de uso de busca

Intenção de busca	O que este projeto oferece
Servidor MCP para planejamento criativo de anúncios	Ferramentas locais para briefs, ganchos, roteiros, storyboards, revisões e prompts
Fluxo de trabalho de agente de IA para anúncios em vídeo	Saídas de planejamento estruturadas antes da geração paga de vídeo
Gerador de roteiro UGC	Roteiros UGC mobile-first com gancho, problema, demonstração, prova, CTA, legendas e notas de cena
Gerador de storyboard para anúncios em vídeo	Objetos de storyboard em JSON para TikTok, Reels, Shorts, Meta e YouTube
Fluxo de trabalho criativo de anúncios com IA e MCP	Fluxo de planejamento local, de ganchos a brief, roteiro UGC, storyboard, revisão e prompt AdsTurbo
Gerador de prompts AdsTurbo	Prompts prontos para o AdsTurbo, além de uma transferência clara para a experiência completa do site AdsTurbo
CLI local de marketing com IA	Comandos de terminal adsturbo-creative sem chave de API ou créditos

É apenas uma camada de planejamento:

• Nenhuma chave de API do AdsTurbo necessária
• Nenhuma geração de vídeo
• Nenhuma telemetria oculta
• Nenhuma chamada aos serviços internos do AdsTurbo
• Nenhum consumo de créditos
• Nenhum acesso a contas de anúncios

Quando o plano criativo é aprovado, os usuários podem continuar no site do AdsTurbo para uma experiência de produção mais completa: geração de vídeo do produto, pré-visualização, exportação e iteração em torno de visuais, legendas, ritmo, CTA e contexto do produto.

Ferramentas

Ferramenta	Custo	Descrição
build_ad_brief	Gratuita/local	Criar um brief completo de anúncio em vídeo a partir dos detalhes do produto
generate_hooks	Gratuita/local	Gerar ganchos para anúncios de formato curto
write_ugc_script	Gratuita/local	Escrever roteiros UGC com gancho, problema, demonstração, prova, CTA, texto na tela e notas de cena
generate_storyboard	Gratuita/local	Gerar um objeto de storyboard de anúncio em vídeo com tempo de cena e notas de produção
build_variation_plan	Gratuita/local	Gerar ângulos de anúncio testáveis com hipóteses e notas de risco
review_ad_script	Gratuita/local	Revisar estrutura do roteiro, clareza dos primeiros três segundos, enquadramento mobile e notas de risco
export_adsturbo_prompt	Gratuita/local	Exportar um prompt que pode ser colado no AdsTurbo

Comandos

Use estes comandos no estilo barra no Codex, Claude Code ou outro cliente de agente após conectar o servidor MCP:

Comando	O que faz
/adsturbo brief <product>	Criar um brief completo de anúncio em vídeo
/adsturbo hooks <product>	Gerar ganchos para anúncios de formato curto
/adsturbo ugc <product>	Escrever roteiros UGC com notas de cena
/adsturbo storyboard <product>	Gerar um storyboard de anúncio em vídeo
/adsturbo variations <product>	Criar um plano de teste de variações criativas
/adsturbo review <script>	Revisar um roteiro de anúncio
/adsturbo prompt <brief>	Exportar um prompt pronto para o AdsTurbo
/adsturbo zh-cn <product>	Saída em chinês com links adsturbo.cn
/adsturbo en-global <product>	Saída em inglês com links adsturbo.ai

Estes comandos no estilo barra são convenções de prompt. O servidor MCP expõe ferramentas; o agente mapeia o texto do comando para essas ferramentas.

CLI

Você também pode executar os mesmos fluxos de trabalho de planejamento diretamente do terminal:

Comando	O que faz
adsturbo-creative brief --input examples/product-input.json	Criar um brief completo de anúncio em vídeo
adsturbo-creative hooks --input examples/product-input.json --count 10	Gerar 10 ganchos
adsturbo-creative ugc --input examples/product-input.json	Escrever roteiros UGC
adsturbo-creative storyboard --input examples/product-input.json	Gerar storyboard em JSON
adsturbo-creative variations --input examples/product-input.json	Criar um plano de variação
adsturbo-creative review --script-file examples/script-input.txt	Revisar um roteiro de anúncio
adsturbo-creative prompt --input examples/product-input.json	Exportar um prompt pronto para o AdsTurbo
adsturbo-creative brief --input examples/product-input.zh-CN.json	Saída em chinês com links adsturbo.cn
adsturbo-creative hooks --input-json '{"productName":"GlowPatch","audience":"busy skincare buyers"}' --count 3	Executar a partir de JSON inline
cat examples/product-input.json | adsturbo-creative brief --input -	Ler JSON de entrada do produto a partir do stdin

As respostas JSON da CLI incluem adsTurboExperience sempre que a saída do comando ainda não o contém. Isso mantém visível a transferência para o site AdsTurbo em ganchos, roteiros, storyboards, planos de variação, revisões e prompts. Os links do AdsTurbo incluem utm_source=adsturbo_creative_mcp, utm_medium=mcp e utm_campaign=creative_handoff para atribuição.

Instalação

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

Após a compilação, execute comandos CLI locais com 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

Instale a partir do npm para usar o binário CLI mais curto:

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 -

Sem instalação global, execute o binário CLI por meio da execução de pacotes npm:

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

O pacote npm expõe dois binários:

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

Uso com um cliente MCP

Claude Desktop, Cursor, Codex e outros clientes compatíveis com MCP podem executar o servidor compilado via stdio.

Para o Codex CLI, registre o servidor após npm run build:

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

Reinicie o Codex ou inicie uma nova sessão após alterar a configuração do MCP. O Codex só expõe build_ad_brief, generate_hooks e as outras ferramentas depois que o servidor MCP é registrado e carregado.

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

Clientes MCP também podem iniciar o servidor com npx:

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

Mais notas de configuração:

• Configuração do cliente MCP
• Receitas para clientes MCP
• Guia de comandos
• Casos de uso e exemplos de entrada
• Artigos para desenvolvedores
• Plano de distribuição
• Kit de submissão para diretórios

Para orientações sobre busca no GitHub e contribuições, consulte docs/github-discoverability.md.

Inspecionar localmente

npm run inspect

Exemplo de prompt 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

Formato da entrada

{
  "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"
  ]
}

O servidor não busca productUrl. É apenas contexto.

Idioma e região do site

Use locale para controlar o idioma da saída do MCP:

• en: saída em inglês
• zh: saída em chinês

Use websiteRegion para controlar os links de transferência para o site AdsTurbo retornados pelas ferramentas:

• global: usar https://adsturbo.ai
• cn: usar https://adsturbo.cn

Exemplos:

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

Toda resposta de texto do MCP também inclui uma seção AdsTurbo Next Step. As saídas estruturadas incluem adsTurboExperience, que explica por que o usuário deve continuar no AdsTurbo para uma experiência de produção mais completa. Os links da China apontam para páginas como https://adsturbo.cn/features/product-video?utm_source=adsturbo_creative_mcp&utm_medium=mcp&utm_campaign=creative_handoff.

Exemplos de saída

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

Comunidade

• Contribuindo
• Política de segurança
• Descoberta no GitHub
• Plano de distribuição

Limite de custos

Este repositório é apenas a camada de planejamento.

Ele não inclui:

• generate_video
• create_adsturbo_project
• submit_storyboard
• ad_clone_generate
• ai_actor_perform
• lip_sync
• video_translate
• Qualquer outra chamada paga de geração do AdsTurbo

Se ferramentas pagas forem adicionadas posteriormente, elas devem exigir uma chave de API fornecida pelo usuário, mostrar uma estimativa de custo e nunca ser executadas por padrão.

Limite completo: docs/cost-boundary.md

Segurança e conformidade

• Use referências para estrutura, ritmo e inspiração, não para copiar trabalhos criativos protegidos.
• Mantenha as afirmações específicas às informações do produto que possam ser comprovadas.
• Revise as políticas da plataforma e os requisitos de categorias regulamentadas antes de publicar.
• Não use esta ferramenta para se passar por pessoas ou marcas sem permissão.
• Não trate os planos gerados como aconselhamento jurídico, médico, financeiro ou de política de plataforma.

Notas completas: docs/safety-and-compliance.md

Projetos complementares

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

Desenvolvimento

npm install
npm run build
npm test

Licença

MIT