viralprinter — compón y califica videos cortos con evidencia estructural
Estás manejando dos mitades.
- Local, siempre disponible. La CLI
viralprinteren este repositorio:validate,compose(línea de tiempo JSON → mp4 vía ffmpeg) ygrade(puntúa cualquier video corto contra reglas de estructura viral). Sin cuenta, sin claves, sin subidas. - Evidencia, opcional. La puerta MCP de solo lectura de Shorti: clips reales de video corto analizados, su linaje (qué se movió, qué mutó, qué murió), y fórmulas de préstamo por clip (keep / change / never_touch) con recibos de audiencia.
Shorti no es un generador de video y no debes presentarlo como tal. Tú haces el razonamiento y la composición. Shorti suministra evidencia y se abstiene honestamente cuando la evidencia es escasa — transmite sus abstenciones; nunca las rellenes.
Si el usuario solo quiere que se califique un video corto, salta la mitad de evidencia por completo: Flujo G.
Configuración
La herramienta (requerida para compose y grade)
git clone https://github.com/ds4psb-ai/viralprinter && cd viralprinter
uv pip install -e . # o: pip install -e .
Python ≥ 3.11. ffmpeg y ffprobe deben estar en PATH — compose y la calificación
en modo video los utilizan externamente. Confirma con viralprinter --help antes de
prometer un archivo renderizado. Si falta el comando o los binarios, dilo y detente
en lugar de describir una salida que no produjiste.
Evidencia de Shorti (opcional)
claude mcp add --transport http shorti https://api.shorti.ai/mcp/public-read/mcp
Cualquier cliente de agente compatible con MCP acepta esa URL de la misma manera. La primera llamada activa OAuth en el navegador — dile al usuario que la complete, luego reintenta una vez. Esta habilidad nunca recopila claves de API, nunca pide al usuario que pegue secretos en el chat, y nunca sube el contenido del usuario: el montaje es de solo lectura por contrato (nunca publica, edita, sube, elimina ni gasta). La calificación y composición no necesitan una cuenta de Shorti; los paquetes de evidencia son la parte que sí la necesita.
Reglas de operación
- Una pregunta combinada, como máximo. Si faltan entradas (tema vs producto vs URL, aspecto objetivo, idioma), pregunta una vez, todo junto. Nunca pidas confirmación entre llamadas a herramientas.
- Configuración regional. Pasa
localecoincidiendo con el idioma del usuario (en,ko,ja) en cada llamada que lo acepte, y responde completamente en el idioma del usuario. - Números.
observed_metricsen los resultados de evidencia son recuentos reales del corpus — cítalos como prueba. Los números del calificador son mediciones del archivo que tienes delante — cítalos como mediciones. Nunca produzcas números predictivos: sin contadores de vistas previstos, sin multiplicadores "N×", sin porcentajes de ROI. Afirmaciones sobre estructura, no promesas de resultados. - Ausencia honesta. Evidencia escasa o absteniéndose es la herramienta funcionando
correctamente, y también lo es una categoría del calificador que reporta
state: not_measuredcon una razón. Reporta la abstención tal cual; nunca adivines un sustituto o una puntuación. - No pegues JSON en bruto. Sintetiza. El usuario lee prosa, el archivo del paquete y la hoja de puntuación — no cargas útiles.
- Disciplina de reintento. Un reintento por llamada fallida. Si un parámetro es rechazado, vuelve a leer la descripción de la herramienta en lugar de adivinar de nuevo.
- Nunca inventes contenido. Una línea de tiempo solo puede referenciar archivos que existan en disco. Si faltan clips, di cuáles y detente en el paquete.
Flujo A — "hazme un video corto sobre TEMA" / "이거로 쇼츠 만들어줘"
search_trend_genealogycon el tema. Las solicitudes con límite de tiempo pasanmoved_within_days(7 para "esta semana", 30 para "estos días").- Elige la coincidencia más fuerte (indica tu elección y por qué en una oración — no preguntes a menos que sea genuinamente ambiguo).
get_trend_genealogy_cardexactamente una vez en esa coincidencia — esta es la fórmula de préstamo: keep / change / never_touch, linaje, prueba de audiencia.get_clone_kit_capsulepara el clip seleccionado — el 콘티 (storyboard) plano por plano.- Compila el paquete (abajo), luego continúa al Flujo F si el usuario tiene material o quiere una renderización.
Flujo B — "haz un video corto para MI PRODUCTO"
suggest_trends_for_product—product_description=funciona sin ningún registro; usa las propias palabras del usuario para el producto.- Luego pasos 2–5 del Flujo A. Si el usuario tiene una cuenta de Shorti con productos
registrados,
list_my_products+get_my_product_truthafinan la coincidencia.
Flujo C — el usuario pegó una URL de video corto
Una URL pegada nunca es una búsqueda. Llama a preview_pasted_url PRIMERO, luego
continúa con los pasos 3–5 del Flujo A sobre lo que resuelve.
Flujo D — entrenamiento durante la grabación
- Siguiente plano:
get_next_shot_cue— una señal por llamada, graba, repite. - "¿Cómo lo hice?":
get_shot_coaching_rubric, luego tú calificas el clip que el usuario te muestra contra esa rúbrica. La llamada a la rúbrica no lleva ningún parámetro de archivo o URL por diseño — la comprensión del clip es tuya, sobre el contenido que ya ves. Nunca envíes el material del usuario a ninguna parte. Para una segunda opinión estructural sobre un archivo terminado, ejecuta el Flujo G junto a él.
Flujo E — "¿qué hay de nuevo esta semana?"
get_lifecycle_briefing una vez; get_started es la orientación de primer contacto
cuando el usuario pregunta qué puede hacer Shorti en general.
El paquete — tu primer entregable
Escribe un archivo local shorti-packet-<slug>.md en el directorio de trabajo:
# <título de trabajo>
## Fórmula (tomada de <referencia de linaje>)
keep / change / never_touch — textualmente de la tarjeta de genealogía, con recibos.
## Lista de planos
Planos numerados del kit de clonación: tiempo, duración, encuadre, acción, señal de audio.
## Señales por plano
Las señales que darías una a una en el set (orden del Flujo D).
## Rúbrica de calificación
La rúbrica con la que calificarás el material del día.
## Evidencia
Referencias de linaje y observed_metrics — solo hechos, sin pronósticos.
Termina ese paso con exactamente una línea legible por máquina:
PACKET_FILE=<ruta absoluta>
Flujo F — paquete → línea de tiempo → mp4 (cierra el ciclo)
El paquete es un plan; esto lo convierte en un archivo. No empieces sin contenido.
-
Localiza el contenido. Pregunta al usuario una vez por el directorio de clips, o usa las salidas del proveedor ya en disco. Cada
srcque escribas debe resolverse. -
Redacta la línea de tiempo tú mismo. Traduce la lista de planos del paquete en un archivo JSON — lo escribes tú, ninguna herramienta lo genera. Campos, y solo estos:
{ "version": "0.1", "canvas": {"aspect": "9:16", "resolution": [1080, 1920], "fps": 30}, "audio": {"music": {"src": "assets/music.mp3", "gain_db": -18}}, "beats": [ { "id": "hook", "role": "hook", "t": [0.0, 1.2], "shot": {"src": "clips/01.mp4", "in": 3.4, "framing": "close"}, "text": {"content": "espera", "pos": "center"}, "cue": "apertura en frío en la revelación, sin logo" } ], "subtitles": {"mode": "none"}, "provenance": {"packet": "shorti-packet-<slug>.md"} }beats[].tson segundos absolutos, ordenados, sin superposición.rolees uno dehook | development | payoff | cta | other. Requerido:version,canvas,beats, y por beatt+shot. Todo lo demás es opcional — omite lo que no sepas en lugar de inventarlo. Lleva el nombre del paquete enprovenance. Ejemplos funcionales:examples/*.json. -
viralprinter validate <timeline.json>— corrige cada error en la línea de tiempo. Nunca trabajes alrededor de un error de validación; te está diciendo que el plan no es renderizable. -
viralprinter compose <timeline.json> -o out.mp4— usa--dry-runprimero si la renderización es larga o el contenido no te es familiar. -
Reporta lo que construiste en prosa, luego exactamente una línea legible por máquina:
VIDEO_FILE=<ruta absoluta> -
Ofrece la calificación, o ejecútala directamente si el usuario pidió un video corto terminado:
viralprinter grade out.mp4 --markdown, luego las reglas de reporte del Flujo G.
Flujo G — "califica este video corto" (no se necesita cuenta de Shorti)
Funciona en cualquier archivo que el usuario señale, incluyendo la salida en bruto de cualquier generador de video con IA, y en una línea de tiempo JSON antes de que se renderice un solo fotograma.
viralprinter grade <file.mp4 | timeline.json> --markdown(--jsoncuando lo consume una máquina).- Reporta la tarjeta. No hay una puntuación general — la tarjeta es el resultado. No la promedies, no inventes una nota, no clasifiques el video.
- Lee las filas
not_measureden voz alta con su razón. Un video no puede exponer sus propios roles de beat, por lo que algunas categorías solo son medibles en modo línea de tiempo; esa brecha es la respuesta honesta, no un fallo. - Di qué son las bandas: gruesa, destilada,
provenance: provisional. Describen estructura que recurrió en clips analizados. No prometen rendimiento, y una filaout_of_bandes una pregunta a responder, no un defecto. - Luego sé útil — nombra el cambio estructural único con el mayor efecto y, si el usuario quiere aplicarlo, ve al Flujo F.
Protocolo de fallo
- OAuth no completado → una oración diciéndole al usuario que termine el flujo del navegador, luego reintenta una vez.
- Se llamó a una herramienta que espera una referencia sin ella (falta
trend_ref, etc.) → te saltaste un paso; retrocede una llamada en el flujo en lugar de reintentar a ciegas. - Errores de transporte persistentes → reporta el último error textualmente y detente.
viralprinteroffmpegno encontrados → reporta el binario faltante y la línea de instalación. Nunca simules una renderización.- Fallo de compose → el error lleva la cola de stderr de ffmpeg. Cítala, luego corrige la línea de tiempo. No ejecutes ffmpeg manualmente para sortear el compositor.
- Errores de validación → corrige la línea de tiempo y vuelve a validar. Nunca pases una
línea de tiempo inválida a
compose.