openclip-ugc-ads

OpenClip: Generación de anuncios UGC

generate_ugc renderiza un clip vertical corto estilo UGC (aproximadamente de 7 a 12 segundos) a partir de un brief creativo. Las cuentas gratuitas obtienen UNA generación por día. Las cuentas de pago se facturan en créditos según los segundos renderizados.

Los renders son pesados. Espera un par de minutos por clip, no segundos.

Configuración (única vez)

OpenClip es un servidor MCP remoto en https://openclip.app/mcp. Inicia sesión con tu cuenta de OpenClip cuando aparezca la solicitud OAuth; no hay clave API que copiar.

• Claude Code: claude mcp add --transport http openclip https://openclip.app/mcp, luego /mcp para autorizar.
• Claude Desktop / web: Configuración, Conectores, "Agregar conector personalizado", pega la URL, inicia sesión.
• Cursor (.cursor/mcp.json): { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• Clientes solo con encabezados: genera un token MCP en openclip.app/settings/connect y conéctate a https://openclip.app/mcp/key con Authorization: Bearer <token>.

Verificación: llama a get_account.

El flujo

1. Descubre el roster PRIMERO. list_ugc_creators devuelve los valores válidos de creator y start_frame para este equipo: un roster seleccionado más los creadores guardados del equipo, agrupados por nicho. Nunca adivines el nombre de un creador, elige uno de esta llamada.
2. Genera. generate_ugc(...) con:
   • brief_name - un preset del lado del servidor, el camino rápido, o
   • brief - un objeto en línea con campos creativos estructurados (character y compañía).
3. Sondea. Devuelve un hashid ugc_job. Sondea get_ugc_job_status(ugc_job) cada 10 a 15 segundos. queued / rendering están en proceso. completed devuelve video_url más result_meta (duración, dimensiones, fps, semilla). failed devuelve error.
4. Revisa trabajos anteriores. list_ugc_jobs lista los clips UGC anteriores de un equipo, y es cómo encuentras un id ugc_job para sondear si lo perdiste.

El brief es estructurado, no un prompt

Esto es lo que los agentes suelen hacer mal. brief no es un prompt en prosa. Es un objeto de campos creativos discretos (character y los demás campos que acepta la API). Escribir un párrafo en un solo campo desperdicia la estructura y produce resultados confusos.

Escribe cada campo como un detalle concreto, físico y filmable:

• Nombra lo que está en el encuadre, no cómo debería sentirse. "Sujetando la botella a la altura del pecho, encimera de cocina detrás" es mejor que "vibraciones energéticas y aspiracionales".
• Una idea por campo. No apiles tres ritmos en character.
• Las restricciones producen mejores resultados que los adjetivos. Un escenario específico, un objeto específico y una acción específica superan a "alta calidad, profesional, atractivo".

Probando ángulos publicitarios

Cuando el usuario quiera variaciones en lugar de un solo clip, cambia UNA variable por render para que la comparación tenga sentido:

• Mismo creador, gancho diferente.
• Mismo gancho, creador diferente, cuando estés probando quién transmite mejor el mensaje.
• Todo igual, start_frame diferente, cuando estés probando el momento de la miniatura.

Las cuentas gratuitas obtienen una generación por día, así que en una cuenta gratuita, gasta esa generación en el ángulo más diferenciado en lugar de uno casi duplicado. Verifica get_account antes de prometer un lote.

Reglas

• list_ugc_creators antes de cada primera generación en una sesión. El roster es específico del equipo y cambia.
• Siempre sondea. Los renders tardan minutos, generate_ugc devuelve el resultado de inmediato.
• Los clips son cortos por diseño, aproximadamente de 7 a 12 segundos. No prometas un anuncio de 60 segundos.
• El nivel gratuito es UNA generación por día. Dilo antes de que el usuario planee un lote en una cuenta gratuita.
• result_meta incluye la seed. Consérvala cuando al usuario le haya gustado un render y quiera una variante cercana.

Errores

Los fallos de las herramientas se devuelven como resultado de la herramienta con isError: true y un mensaje en texto plano, no un estado HTTP. "No autenticado. Reconecta tu token de OpenClip" significa reconectar o regenerar el token. Los mensajes de validación (un creador desconocido, un brief malformado) se devuelven como texto del mensaje; corrige el argumento y vuelve a intentarlo.

Ejemplos de acciones a partir de prompts

• "Haz un anuncio UGC para mi app" - list_ugc_creators, elige un creador adecuado, generate_ugc(brief={...}), sondea get_ugc_job_status, devuelve video_url.
• "Dame tres ángulos para probar" - un render por ángulo, una variable cambiada cada vez, sondea cada uno. Verifica primero el límite diario en una cuenta gratuita.
• "Usa la misma chica que la última vez" - list_ugc_jobs para encontrar el trabajo anterior, lee su creador, reutilízalo.
• "¿Qué creadores puedo usar?" - list_ugc_creators, muéstralos agrupados por nicho.

Relacionado

Recortar metraje real de larga duración en cortos es openclip-clipping. El recorte, recorte y compresión gratuitos del clip generado es openclip-video-editing.