AdsTurbo Creative MCP

AdsTurbo Creative MCP

Servidor MCP local para la planificación de anuncios de video con IA.

Creado por el equipo detrás de AdsTurbo, un generador de anuncios de video con IA para vendedores de comercio electrónico y agencias de rendimiento. Este servidor es solo local: nunca llama a la API de AdsTurbo y nunca gasta créditos.

简体中文

AdsTurbo Creative MCP ayuda a los agentes de IA a planificar briefs de anuncios de video, ganchos, guiones UGC, storyboards, planes de variación, revisiones de guiones y prompts listos para AdsTurbo antes de que un equipo gaste en la generación de video.

Úsalo cuando necesites un servidor MCP local o CLI para la planificación creativa de anuncios con IA, guiones de anuncios UGC, storyboards de video de formato corto, agentes de marketing con IA, ingeniería de prompts para anuncios de video o un exportador de prompts AdsTurbo para Claude Desktop, Cursor, Codex y otros clientes MCP.

Vista previa 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 búsqueda

Intención de búsqueda	Lo que ofrece este proyecto
Servidor MCP para planificación creativa de anuncios	Herramientas locales para briefs, ganchos, guiones, storyboards, revisiones y prompts
Flujo de trabajo de agente de IA para anuncios de video	Salidas de planificación estructuradas antes de la generación de video de pago
Generador de guiones UGC	Guiones UGC centrados en móvil con gancho, problema, demo, prueba, CTA, subtítulos y notas de toma
Generador de storyboards de anuncios de video	Objetos JSON de storyboard para TikTok, Reels, Shorts, Meta y YouTube
Flujo de trabajo creativo de anuncios con IA y MCP	Flujo de planificación local desde ganchos hasta brief, guion UGC, storyboard, revisión y prompt de AdsTurbo
Generador de prompts AdsTurbo	Prompts listos para AdsTurbo más una transferencia clara a la experiencia completa del sitio web de AdsTurbo
CLI de marketing con IA local	adsturbo-creative comandos de terminal sin clave de API ni créditos

Es solo una capa de planificación:

• No se requiere clave de API de AdsTurbo
• Sin generación de video
• Sin telemetría oculta
• Sin llamadas a servicios internos de AdsTurbo
• Sin consumo de créditos
• Sin acceso a cuentas publicitarias

Cuando el plan creativo esté aprobado, los usuarios pueden continuar en el sitio web de AdsTurbo para una experiencia de producción más completa: generación de video de producto, vista previa, exportación e iteración en torno a visuales, subtítulos, ritmo, CTA y contexto del producto.

Herramientas

Herramienta	Costo	Descripción
build_ad_brief	Gratis/local	Construye un brief completo de anuncio de video a partir de detalles del producto
generate_hooks	Gratis/local	Genera ganchos de anuncios de formato corto
write_ugc_script	Gratis/local	Escribe guiones UGC con gancho, problema, demo, prueba, CTA, texto en pantalla y notas de toma
generate_storyboard	Gratis/local	Genera un objeto de storyboard de anuncio de video con tiempos de escena y notas de producción
build_variation_plan	Gratis/local	Genera ángulos publicitarios comprobables con hipótesis y notas de riesgo
review_ad_script	Gratis/local	Revisa la estructura del guion, la claridad de los primeros tres segundos, el encuadre móvil y las notas de riesgo
export_adsturbo_prompt	Gratis/local	Exporta un prompt que se puede pegar en AdsTurbo

Comandos

Usa estos comandos de estilo barra en Codex, Claude Code u otro cliente de agente después de conectar el servidor MCP:

Comando	Qué hace
/adsturbo brief <product>	Construye un brief completo de anuncio de video
/adsturbo hooks <product>	Genera ganchos de anuncios de formato corto
/adsturbo ugc <product>	Escribe guiones UGC con notas de toma
/adsturbo storyboard <product>	Genera un storyboard de anuncio de video
/adsturbo variations <product>	Construye un plan de prueba de variación creativa
/adsturbo review <script>	Revisa un guion de anuncio
/adsturbo prompt <brief>	Exporta un prompt listo para AdsTurbo
/adsturbo zh-cn <product>	Salida en chino con enlaces adsturbo.cn
/adsturbo en-global <product>	Salida en inglés con enlaces adsturbo.ai

Estos comandos de estilo barra son convenciones de prompt. El servidor MCP expone herramientas; el agente asigna la redacción del comando a esas herramientas.

CLI

También puedes ejecutar los mismos flujos de trabajo de planificación directamente desde la terminal:

Comando	Qué hace
adsturbo-creative brief --input examples/product-input.json	Construye un brief completo de anuncio de video
adsturbo-creative hooks --input examples/product-input.json --count 10	Genera 10 ganchos
adsturbo-creative ugc --input examples/product-input.json	Escribe guiones UGC
adsturbo-creative storyboard --input examples/product-input.json	Genera JSON de storyboard
adsturbo-creative variations --input examples/product-input.json	Construye un plan de variación
adsturbo-creative review --script-file examples/script-input.txt	Revisa un guion de anuncio
adsturbo-creative prompt --input examples/product-input.json	Exporta un prompt listo para AdsTurbo
adsturbo-creative brief --input examples/product-input.zh-CN.json	Salida en chino con enlaces adsturbo.cn
adsturbo-creative hooks --input-json '{"productName":"GlowPatch","audience":"busy skincare buyers"}' --count 3	Ejecuta desde JSON en línea
cat examples/product-input.json | adsturbo-creative brief --input -	Lee JSON de entrada del producto desde stdin

Las respuestas JSON del CLI incluyen adsTurboExperience siempre que la salida del comando no lo contenga ya. Esto mantiene visible la transferencia al sitio web de AdsTurbo en ganchos, guiones, storyboards, planes de variación, revisiones y prompts. Los enlaces de AdsTurbo incluyen utm_source=adsturbo_creative_mcp, utm_medium=mcp y utm_campaign=creative_handoff para atribución.

Instalación

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

Después de compilar, ejecuta comandos CLI locales con 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

Instala desde npm para usar el binario CLI más corto:

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 -

Sin instalación global, ejecuta el binario CLI mediante la ejecución de paquetes npm:

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

El paquete npm expone dos binarios:

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

Uso con un cliente MCP

Claude Desktop, Cursor, Codex y otros clientes compatibles con MCP pueden ejecutar el servidor compilado a través de stdio.

Para Codex CLI, registra el servidor después de npm run build:

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

Reinicia Codex o inicia una sesión nueva después de cambiar la configuración de MCP. Codex solo expone build_ad_brief, generate_hooks y las demás herramientas después de que el servidor MCP esté registrado y cargado.

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

Los clientes MCP también pueden iniciar el servidor con npx:

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

Más notas de configuración:

• Configuración del cliente MCP
• Recetas para clientes MCP
• Guía de comandos
• Casos de uso y ejemplos de entrada
• Artículos para desarrolladores
• Plan de distribución
• Kit de envío a directorios

Para búsqueda en GitHub y orientación sobre contribuciones, consulta docs/github-discoverability.md.

Inspección local

npm run inspect

Ejemplo 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

Forma de 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"
  ]
}

El servidor no obtiene productUrl. Es solo contexto.

Idioma y región del sitio web

Usa locale para controlar el idioma de la salida de MCP:

• en: salida en inglés
• zh: salida en chino

Usa websiteRegion para controlar los enlaces de transferencia al sitio web de AdsTurbo devueltos por las herramientas:

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

Ejemplos:

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

Cada respuesta de texto de MCP también incluye una sección AdsTurbo Next Step. Las salidas estructuradas incluyen adsTurboExperience, que explica por qué el usuario debería continuar en AdsTurbo para una experiencia de producción más completa. Los enlaces de China apuntan a páginas como https://adsturbo.cn/features/product-video?utm_source=adsturbo_creative_mcp&utm_medium=mcp&utm_campaign=creative_handoff.

Ejemplos de salida

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

Comunidad

• Contribuciones
• Política de seguridad
• Descubrimiento en GitHub
• Plan de distribución

Límite de costos

Este repositorio es solo la capa de planificación.

No incluye:

• generate_video
• create_adsturbo_project
• submit_storyboard
• ad_clone_generate
• ai_actor_perform
• lip_sync
• video_translate
• Cualquier otra llamada de generación de pago de AdsTurbo

Si se añaden herramientas de pago más adelante, deben requerir una clave de API proporcionada por el usuario, mostrar una estimación de costos y nunca ejecutarse por defecto.

Límite completo: docs/cost-boundary.md

Seguridad y cumplimiento

• Usa referencias para estructura, ritmo e inspiración, no para copiar trabajo creativo protegido.
• Mantén las afirmaciones específicas a la información del producto que pueda fundamentarse.
• Revisa la política de la plataforma y los requisitos de categorías reguladas antes de publicar.
• No uses esta herramienta para suplantar a personas o marcas sin permiso.
• No trates los planes generados como asesoramiento legal, médico, financiero o de política de plataforma.

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

Proyectos complementarios

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

Desarrollo

npm install
npm run build
npm test

Licencia

MIT