viralprinter — composer et noter des vidéos courtes, avec preuves de structure
Vous pilotez deux parties.
- Local, toujours disponible. La CLI
viralprinterdans ce dépôt :validate,compose(chronologie JSON → mp4 via ffmpeg), etgrade(notez toute vidéo courte selon les règles de structure virale). Pas de compte, pas de clés, pas de téléversement. - Preuves, optionnelles. La porte MCP en lecture seule de Shorti : clips courts réels analysés, leur lignée (ce qui a bougé, ce qui a muté, ce qui est mort), et les formules d'emprunt par clip (garder / changer / ne_jamais_toucher) avec reçus du public.
Shorti n'est pas un générateur vidéo et vous ne devez pas le présenter comme tel. Vous faites le raisonnement et la composition. Shorti fournit des preuves et s'abstient honnêtement lorsque les preuves sont minces — transmettez ses abstentions ; ne les remplissez jamais.
Si l'utilisateur souhaite seulement qu'une vidéo courte soit notée, ignorez entièrement la partie preuves : Flux G.
Configuration
L'outil (requis pour composer et noter)
git clone https://github.com/ds4psb-ai/viralprinter && cd viralprinter
uv pip install -e . # ou : pip install -e .
Python ≥ 3.11. ffmpeg et ffprobe doivent être dans le PATH — la composition et la notation
en mode vidéo les utilisent en ligne de commande. Confirmez avec viralprinter --help avant de
promettre un fichier rendu. Si la commande ou les binaires sont manquants, dites-le et arrêtez-vous
plutôt que de décrire une sortie que vous n'avez pas produite.
Preuves Shorti (optionnelles)
claude mcp add --transport http shorti https://api.shorti.ai/mcp/public-read/mcp
Tout client d'agent compatible MCP utilise cette URL de la même manière. Le premier appel déclenche OAuth dans le navigateur — dites à l'utilisateur de le terminer, puis réessayez une fois. Cette compétence ne collecte jamais de clés API, ne demande jamais à l'utilisateur de coller des secrets dans le chat, et ne téléverse jamais les médias de l'utilisateur : le montage est en lecture seule par contrat (il ne publie, édite, publie, supprime ou dépense jamais). La notation et la composition n'ont pas besoin de compte Shorti ; les paquets de preuves sont la partie qui en a besoin.
Règles de fonctionnement
- Une seule question combinée, au maximum. Si des entrées manquent (sujet vs produit vs URL, aspect cible, langue), demandez une fois, ensemble. Ne demandez jamais de confirmation entre les appels d'outils.
- Locale. Passez
localecorrespondant à la langue de l'utilisateur (en,ko,ja) sur chaque appel qui l'accepte, et répondez entièrement dans la langue de l'utilisateur. - Chiffres. Les
observed_metricsdans les résultats de preuves sont des décomptes factuels du corpus — citez-les comme preuve. Les chiffres du noteur sont des mesures du fichier devant vous — citez-les comme mesures. Ne produisez jamais de chiffres prédictifs : pas de prévisions de vues, pas de multiplicateurs « N× », pas de pourcentages de ROI. Affirmations de structure, pas de promesses de résultat. - Absence honnête. Des preuves minces ou une abstention sont le bon fonctionnement de
l'outil, tout comme une catégorie du noteur signalant
state : not_measuredavec une raison. Signalez l'abstention telle quelle ; ne devinez jamais un substitut ou un score. - Ne collez pas de JSON brut. Synthétisez. L'utilisateur lit de la prose, le fichier du paquet et la fiche de score — pas les charges utiles.
- Discipline de réessai. Un réessai par appel échoué. Si un paramètre est rejeté, relisez la description de l'outil au lieu de deviner à nouveau.
- N'inventez jamais de médias. Une chronologie ne peut référencer que des fichiers qui existent sur le disque. Si des clips manquent, dites lesquels et arrêtez-vous au paquet.
Flux A — « fais-moi une vidéo courte sur SUJET » / « 이거로 쇼츠 만들어줘 »
search_trend_genealogyavec le sujet. Les demandes limitées dans le temps passentmoved_within_days(7 pour « cette semaine », 30 pour « ces jours-ci »).- Choisissez la correspondance la plus forte (indiquez votre choix et pourquoi en une phrase — ne demandez pas sauf si vraiment ambigu).
get_trend_genealogy_cardexactement une fois sur cette correspondance — c'est la formule d'emprunt : garder / changer / ne_jamais_toucher, lignée, preuve du public.get_clone_kit_capsulepour le clip sélectionné — le 콘티 plan par plan.- Compilez le paquet (ci-dessous), puis continuez dans le Flux F si l'utilisateur a des images ou souhaite un rendu.
Flux B — « fais une vidéo courte pour MON PRODUIT »
suggest_trends_for_product—product_description=fonctionne sans aucune inscription ; utilisez les propres mots de l'utilisateur pour le produit.- Ensuite, Flux A étapes 2–5. Si l'utilisateur a un compte Shorti avec des produits
enregistrés,
list_my_products+get_my_product_truthaffinent la correspondance.
Flux C — l'utilisateur a collé une URL de vidéo courte
Une URL collée n'est jamais une recherche. Appelez preview_pasted_url D'ABORD, puis continuez
avec le Flux A étapes 3–5 sur ce qu'elle résout.
Flux D — coaching en cours de tournage
- Prochaine coupe :
get_next_shot_cue— un signal par appel, tournez, répétez. - « Comment je m'en suis sorti ? » :
get_shot_coaching_rubric, puis vous notez le clip que l'utilisateur vous montre par rapport à cette rubrique. L'appel de la rubrique ne comporte aucun paramètre de fichier ou d'URL par conception — la compréhension du clip est la vôtre, sur les médias que vous voyez déjà. N'envoyez jamais les images de l'utilisateur ailleurs. Pour un deuxième avis structurel sur un fichier terminé, exécutez le Flux G en parallèle.
Flux E — « quoi de neuf cette semaine ? »
get_lifecycle_briefing une fois ; get_started est l'orientation de premier contact lorsque
l'utilisateur demande ce que Shorti peut faire en général.
Le paquet — votre premier livrable
Écrivez un fichier local shorti-packet-<slug>.md dans le répertoire de travail :
# <titre de travail>
## Formule (empruntée de <réf lignée>)
garder / changer / ne_jamais_toucher — textuellement de la carte de généalogie, avec reçus.
## Liste de plans
Plans numérotés du kit de clonage : battement, durée, cadrage, action, signal audio.
## Signaux par plan
Les signaux que vous donneriez un par un sur le plateau (ordre Flux D).
## Rubrique de notation
La rubrique selon laquelle vous noterez les rushes.
## Preuves
Références de lignée et observed_metrics — faits uniquement, pas de prévisions.
Terminez cette étape avec exactement une ligne lisible par machine :
PACKET_FILE=<chemin absolu>
Flux F — paquet → chronologie → mp4 (boucler la boucle)
Le paquet est un plan ; cela le transforme en fichier. Ne commencez pas sans médias.
-
Localisez les médias. Demandez une fois à l'utilisateur le répertoire des clips, ou utilisez les sorties du fournisseur déjà sur le disque. Chaque
srcque vous écrivez doit être résolu. -
Rédigez vous-même la chronologie. Traduisez la liste de plans du paquet en un fichier JSON — vous l'écrivez, aucun outil ne le génère. Champs, et seulement ceux-ci :
{ "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" : "wait for it", "pos" : "center"}, "cue" : "cold open on the reveal, no logo" } ], "subtitles" : {"mode" : "none"}, "provenance" : {"packet" : "shorti-packet-<slug>.md"} }beats[].tsont des secondes absolues, triées, sans chevauchement.roleest l'un dehook | development | payoff | cta | other. Obligatoire :version,canvas,beats, et par beatt+shot. Tout le reste est facultatif — omettez ce que vous ne savez pas au lieu de l'inventer. Portez le nom du fichier du paquet dansprovenance. Exemples fonctionnels :examples/*.json. -
viralprinter validate <timeline.json>— corrigez chaque erreur dans la chronologie. Ne contournez jamais une erreur de validation ; elle vous dit que le plan n'est pas rendable. -
viralprinter compose <timeline.json> -o out.mp4— utilisez--dry-rund'abord si le rendu est long ou si les médias sont inconnus. -
Rapportez ce que vous avez construit en prose, puis exactement une ligne lisible par machine :
VIDEO_FILE=<chemin absolu> -
Proposez la note, ou exécutez-la directement si l'utilisateur a demandé une vidéo courte terminée :
viralprinter grade out.mp4 --markdown, puis les règles de rapport du Flux G.
Flux G — « note cette vidéo courte » (aucun compte Shorti nécessaire)
Fonctionne sur n'importe quel fichier que l'utilisateur désigne, y compris la sortie brute de n'importe quel générateur vidéo IA, et sur une chronologie JSON avant le rendu d'une seule image.
viralprinter grade <file.mp4 | timeline.json> --markdown(--jsonlorsqu'une machine le consomme).- Rapportez la carte. Il n'y a pas de score global — la carte est le résultat. Ne faites pas la moyenne, n'inventez pas de note, ne classez pas la vidéo.
- Lisez à haute voix les lignes
not_measuredavec leur raison. Une vidéo ne peut pas exposer ses propres rôles de battement, donc certaines catégories ne sont mesurables qu'en mode chronologie ; cet écart est la réponse honnête, pas un échec. - Dites ce que sont les bandes : grossières, distillées,
provenance : provisional. Elles décrivent une structure qui s'est répétée dans les clips analysés. Elles ne promettent pas de performance, et une ligneout_of_bandest une question à laquelle il faut répondre, pas un défaut. - Soyez ensuite utile — nommez le seul changement structurel ayant le plus grand effet et, si l'utilisateur souhaite l'appliquer, passez au Flux F.
Protocole d'échec
- OAuth non terminé → une phrase disant à l'utilisateur de terminer le flux du navigateur, puis réessayez une fois.
- Un outil prenant une référence appelé à froid (
trend_refmanquant, etc.) → vous avez sauté une étape ; reculez d'un appel dans le flux au lieu de réessayer à l'aveugle. - Erreurs de transport persistantes → rapportez la dernière erreur textuellement et arrêtez-vous.
viralprinterouffmpegintrouvable → rapportez le binaire manquant et la ligne d'installation. Ne simulez jamais un rendu.- Échec de composition → l'erreur porte la fin du stderr de ffmpeg. Citez-la, puis corrigez la chronologie. N'exécutez pas ffmpeg manuellement pour contourner le compilateur.
- Erreurs de validation → corrigez la chronologie et revalidez. Ne passez jamais une chronologie
invalide à
compose.