Communitygithub.com

Product Video — de una URL a un promo Remotion de 15–25 s

Pega la URL de una web y obtén un video de producto pulido de 15–25 s: Playwright extrae capturas, colores, fuentes, logo y textos, un brief de motion solo pregunta lo que de verdad falta, y React + Remotion construye, revisa fotogramas y renderiza el MP4.

¿Qué es Product Video — de una URL a un promo Remotion de 15–25 s?

Paso 3 de la receta Web para negocio local (montar el promo), de KassanaGujar/product-video (publicado el 2026-10-06). Flujo: URL → extracción (scripts/extract_site.mjs escribe site.json con título, etiquetas OG, encabezados, CTA, colores de marca ordenados, fuentes, candidatos de logo y capturas del hero, de la página completa y de cada sección) → borrador de brief con fuentes etiquetadas → un solo mensaje con máximo ~6 preguntas, cada una con su valor por defecto → completar references/video-brief.md → storyboard → build en Remotion con todos los textos, colores y duraciones en src/content.ts → fotogramas al inicio, medio y final de cada escena y correcciones → render del MP4. Solo usa afirmaciones que aparecen tal cual en la web, usa 9:16 por defecto para pitches y anuncios, y para un negocio físico sin app cambia el mockup del dispositivo por fotos, una tarjeta de reservas o de menú, o un pin en el mapa.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add KassanaGujar/product-video

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Video de Producto desde URL

Pipeline: URL → extraer → borrador del brief → preguntas ciegas → construir → revisar → renderizar.

La plantilla del brief creativo está en references/video-brief.md. El script de extracción es scripts/extract_site.mjs. Lee la plantilla del brief antes del paso 4.

1. Verificar el entorno

node --version   # necesita 18+

Obtener sitios web arbitrarios y descargar Chromium requieren acceso de red abierto. En Claude Code en la web, el acceso de red del entorno debe estar configurado como Completo (la lista blanca "Confiado" predeterminada bloquea la mayoría de los sitios cliente y la descarga del navegador). Si una descarga falla con un error de red/proxy, indícaselo al usuario en una línea y recurre al paso alternativo (ver paso 2 de respaldo).

2. Extraer el sitio

mkdir -p work && cd work
npm init -y >/dev/null && npm i playwright@1 >/dev/null
npx playwright install --with-deps chromium   # omite --with-deps si no eres root
node <skill-dir>/scripts/extract_site.mjs "<URL>" ./site

Esto escribe en ./site/:

  • site.json — título, etiquetas meta/OG, encabezados, CTAs, navegación, texto del cuerpo, colores de marca clasificados, variables de color CSS, fuentes, candidatos a logotipo, subpáginas rastreadas
  • hero-desktop.png, hero-mobile.png, full-desktop.png, section-*.png, page-*.png
  • logo.* si se encuentra

claims es una red amplia (cualquier cosa con números) — trátalo como una lista para revisar, no una lista de afirmaciones para usar.

Si Chromium ya está instalado en otro lugar (ej. /opt/pw-browsers), omite la instalación y establece PLAYWRIGHT_BROWSERS_PATH en esa ruta.

Luego mira las capturas de pantalla (abre los PNGs) — no confíes solo en el JSON. Evalúa: ¿hay una interfaz de usuario de producto real visible, o solo gráficos de marketing/fotos de archivo? ¿Qué secciones se recortarían bien en un primer plano? ¿Los colores extraídos coinciden con lo que ves?

Respaldo (sin navegador / bloqueado): descarga el texto de la página con cualquier herramienta de extracción web existente, completa lo que puedas y marca los colores, el logotipo y las capturas de pantalla como faltantes; se convierten en preguntas ciegas.

3. Redactar los DETALLES DEL PROYECTO

Completa cada campo del bloque de DETALLES DEL PROYECTO. Etiqueta cada valor con su fuente:

  • [site] — indicado en el sitio (cita o casi cita)
  • [inferred] — lectura razonable del sitio
  • [guess] — no respaldado; necesita confirmación

Reglas:

  • Afirmaciones: solo usa métricas/testimonios/afirmaciones que aparezcan textualmente en el sitio, y etiquétalos como [site]. Nunca inventes números, recuentos de clientes o resultados. Si el sitio no tiene ninguno, el video no tiene ninguno.
  • Funcionalidades: elige las 2–3 que sean más visuales y más concretas. Una funcionalidad que no se pueda mostrar en pantalla es una elección débil.
  • Beneficio principal: una oración, en lenguaje de resultado para el usuario, no el eslogan de la empresa a menos que el eslogan ya sea un beneficio claro.
  • Colores: elige un conjunto moderado de la extracción (fondo, texto, 1 marca, 1 acento como máximo). Proporciona códigos hexadecimales.
  • Activos: enumera las rutas de archivo reales de ./site/ y di lo que muestra cada uno.

4. Hacer preguntas ciegas — una vez, agrupadas

Antes de construir, envía UN mensaje que contenga el bloque de detalles redactados más las preguntas. Reglas:

  • Pregunta solo lo que cambia el video y no se pudo resolver desde el sitio. Omite cualquier cosa que ya esté clara.
  • Cada pregunta lleva tu valor predeterminado propuesto, para que el usuario pueda responder "adelante" y tú continúes.
  • Máximo ~6 preguntas, ordenadas por impacto. Breves.

Revisa estos puntos ciegos (pregunta solo los que apliquen):

  1. Propósito — ¿muestra de venta fría para el negocio, su anuncio pagado, una pieza de portafolio o un video de lanzamiento? (Cambia CTA, tono, relación de aspecto).
  2. Relación de aspecto — 9:16 (Reels/TikTok/DM) vs 16:9 (sitio web/YouTube/LinkedIn). Predeterminado: 9:16 para presentaciones/anuncios, 16:9 para inserciones en sitio web.
  3. Audiencia — si el sitio atiende a varios (ej. compradores y vendedores), ¿a cuál?
  4. Elección de funcionalidades — si hay más de 3 candidatos, confirma tus selecciones.
  5. Visuales del producto — si las capturas de pantalla no muestran una interfaz de usuario real (solo fotos/ilustraciones), pregunta: ¿usar interfaz de usuario recreada simplificada, usar sus fotografías, o el usuario tiene capturas de pantalla reales de la aplicación?
  6. Logotipo — faltante, de baja resolución o solo un favicon → ¿construir una marca de texto limpia a partir de la fuente de la marca?
  7. Afirmaciones — el sitio tiene estadísticas/testimonios: ¿incluirlos (textualmente) o mantenerlo libre de afirmaciones?
  8. CTA — sin CTA clara en el sitio, o el propósito es una presentación → ¿qué debería decir/enlazar la tarjeta final?
  9. Negocio físico/local sin aplicación → la maqueta del dispositivo no encaja; propón un visual central alternativo (sus fotos, una tarjeta de reserva/menú, un pin de mapa).
  10. Música/locución — el brief es video silencioso; menciónalo solo si el propósito del usuario implica sonido (anuncios).

Si el usuario dice "solo adelante" o responde parcialmente, usa tus valores predeterminados y establécela en una línea.

5. Completar el brief y ejecutarlo

Lee references/video-brief.md. Inserta los DETALLES DEL PROYECTO confirmados (elimina las etiquetas de fuente) y guárdalo como work/brief.md. Luego sigue el brief como tus propias instrucciones: primero el storyboard (muéstralo brevemente, no es necesario esperar aprobación a menos que el usuario haya pedido revisar), luego construye.

Configuración de Remotion (no interactiva)

mkdir video && cd video
npm init -y >/dev/null
npm i remotion @remotion/cli react react-dom
npm i -D typescript @types/react
npx remotion browser ensure
mkdir -p src public && cp ../site/*.png ../site/logo.* public/ 2>/dev/null

Todos los paquetes remotion / @remotion/* deben tener exactamente la misma versión. Entrada: src/index.ts llama a registerRoot(Root); src/Root.tsx registra el <Composition>. Referencia los activos con staticFile('name.png') y <Img>. Carga fuentes web con @remotion/google-fonts cuando la fuente de la marca sea una fuente de Google, de lo contrario un reemplazo cercano.

Estructura:

  • src/content.ts — todo el texto, colores, nombres de archivos de activos, duraciones de escenas (en segundos). Este es el archivo que edita el usuario.
  • src/scenes/*.tsx — un componente por escena.
  • src/components/* — marco de dispositivo, revelación de texto, etc.
  • Duración total calculada a partir de las duraciones de escenas en content.ts.

Usa interpolate + spring de remotion, <Sequence> o @remotion/transitions <TransitionSeries> para las escenas. Sin animaciones CSS ni Math.random() (representaciones no deterministas); usa random('seed') de remotion si es necesario.

6. Revisar antes de la representación final

Representa fotogramas fijos en fotogramas representativos (inicio, medio y final de cada escena) y míralos:

npx remotion still src/index.ts <CompId> out/f-<n>.png --frame=<n>

Verifica contra la lista de revisión del brief: texto legible en tamaño de teléfono, nada recortado, un punto focal por escena, capturas de pantalla no estiradas, final se mantiene ≥1.5s. Corrige, luego vuelve a verificar los fotogramas que cambiaste.

7. Renderizar y entregar

npx remotion render src/index.ts <CompId> out/<product>-video.mp4

Entrega: la ruta del MP4, el storyboard del brief (breve) y una nota de edición de 4 líneas: el texto/colores/duraciones están en src/content.ts, los activos en public/, vista previa con npx remotion studio, volver a renderizar con el comando anterior. Indica cualquier valor predeterminado que hayas asumido en una línea.

Skills relacionados