viralprinter – Kurzvideos komponieren und bewerten, mit Strukturbelegen
Sie steuern zwei Hälften.
- Lokal, immer verfügbar. Die
viralprinterCLI in diesem Repository:validate,compose(Timeline JSON → mp4 via ffmpeg) undgrade(bewertet jedes Kurzvideo anhand viraler Strukturregeln). Kein Konto, keine Schlüssel, kein Hochladen. - Belege, optional. Shortis schreibgeschützte MCP-Tür: Analysierte echte Kurzvideo-Clips, ihre Abstammung (was sich bewegt hat, was mutiert ist, was gestorben ist) und pro-Clip-Entlehnformeln (behalten / ändern / niemals_anfassen) mit Publikumsbelegen.
Shorti ist kein Videogenerator und Sie dürfen es nicht als einen solchen darstellen. Sie übernehmen das Denken und das Komponieren. Shorti liefert Belege und enthält sich ehrlich, wenn die Belege dünn sind – geben Sie seine Enthaltungen unverändert weiter; füllen Sie sie niemals aus.
Wenn der Benutzer nur eine Bewertung eines Kurzvideos möchte, überspringen Sie die Beleghälfte vollständig: Ablauf G.
Einrichtung
Das Werkzeug (erforderlich für compose und grade)
git clone https://github.com/ds4psb-ai/viralprinter && cd viralprinter
uv pip install -e . # oder: pip install -e .
Python ≥ 3.11. ffmpeg und ffprobe müssen sich im PATH befinden – compose und die
Video-Modus-Bewertung greifen auf sie zurück. Bestätigen Sie mit viralprinter --help, bevor
Sie eine gerenderte Datei versprechen. Wenn der Befehl oder die Binärdateien fehlen, sagen Sie
das und stoppen Sie, anstatt eine Ausgabe zu beschreiben, die Sie nicht erzeugt haben.
Shorti-Belege (optional)
claude mcp add --transport http shorti https://api.shorti.ai/mcp/public-read/mcp
Jeder MCP-fähige Agent-Client verwendet diese URL auf die gleiche Weise. Der erste Aufruf löst einen Browser-OAuth aus – fordern Sie den Benutzer auf, ihn abzuschließen, und wiederholen Sie den Vorgang dann einmal. Dieser Skill sammelt niemals API-Schlüssel, bittet den Benutzer niemals, Geheimnisse in den Chat einzufügen, und lädt niemals die Medien des Benutzers hoch: Der Mount ist vertraglich schreibgeschützt (er postet, bearbeitet, veröffentlicht, löscht oder verbraucht nie). Bewertung und Komposition benötigen kein Shorti-Konto; Belegpakete sind der Teil, der dies tut.
Betriebsregeln
- Maximal eine kombinierte Frage. Wenn Eingaben fehlen (Thema vs. Produkt vs. URL, Zielaspekt, Sprache), fragen Sie einmal, gemeinsam. Fragen Sie niemals zwischen Werkzeugaufrufen nach einer Bestätigung.
- Gebietsschema. Übergeben Sie
localepassend zur Sprache des Benutzers (en,ko,ja) bei jedem Aufruf, der es akzeptiert, und antworten Sie vollständig in der Sprache des Benutzers. - Zahlen.
observed_metricsin Begebergebnissen sind faktenbasierte Zählungen aus dem Korpus – zitieren Sie sie als Beweis. Bewertungszahlen sind Messungen der vor Ihnen liegenden Datei – zitieren Sie sie als Messungen. Erzeugen Sie niemals prognostische Zahlen: keine prognostizierten Aufrufzahlen, keine "N×"-Multiplikatoren, keine ROI-Prozentsätze. Strukturbehauptungen, keine Ergebnisversprechen. - Ehrliche Abwesenheit. Dünne oder sich enthaltende Belege bedeuten, dass das Werkzeug
korrekt funktioniert, ebenso wie eine Bewertungskategorie, die
state: not_measuredmit einem Grund meldet. Melden Sie die Enthaltung unverändert; raten Sie niemals einen Ersatz oder einen Wert. - Kein rohes JSON einfügen. Fassen Sie zusammen. Der Benutzer liest Prosa, die Paketdatei und die Bewertungstafel – nicht die Nutzlasten.
- Wiederholungsdisziplin. Ein Wiederholungsversuch pro fehlgeschlagenem Aufruf. Wenn ein Parameter abgelehnt wird, lesen Sie die Werkzeugbeschreibung erneut, anstatt erneut zu raten.
- Niemals Medien erfinden. Eine Timeline darf nur auf Dateien verweisen, die auf der Festplatte existieren. Wenn Clips fehlen, sagen Sie, welche, und stoppen Sie beim Paket.
Ablauf A – "Erstelle mir ein Kurzvideo über THEMA" / "이거로 쇼츠 만들어줘"
search_trend_genealogymit dem Thema. Zeitlich begrenzte Anfragen übergebenmoved_within_days(7 für "diese Woche", 30 für "dieser Tage").- Wählen Sie die stärkste Übereinstimmung (nennen Sie Ihre Wahl und den Grund in einem Satz – fragen Sie nicht, es sei denn, es ist wirklich mehrdeutig).
get_trend_genealogy_cardgenau einmal für diese Übereinstimmung – dies ist die Entlehnformel: behalten / ändern / niemals_anfassen, Abstammung, Publikumsbeweis.get_clone_kit_capsulefür den ausgewählten Clip – die Einstellung-für-Einstellung 콘티.- Erstellen Sie das Paket (unten), fahren Sie dann mit Ablauf F fort, wenn der Benutzer Filmmaterial hat oder einen Render wünscht.
Ablauf B – "Erstelle ein Kurzvideo für MEIN PRODUKT"
suggest_trends_for_product–product_description=funktioniert ohne jegliche Registrierung; verwenden Sie die eigenen Worte des Benutzers für das Produkt.- Dann Ablauf A Schritte 2–5. Wenn der Benutzer ein Shorti-Konto mit registrierten Produkten
hat, schärfen
list_my_products+get_my_product_truthdie Passung.
Ablauf C – Der Benutzer hat eine Kurzvideo-URL eingefügt
Eine eingefügte URL ist niemals eine Suche. Rufen Sie ZUERST preview_pasted_url auf, fahren
Sie dann mit Ablauf A Schritten 3–5 für das fort, worauf sie aufgelöst wird.
Ablauf D – Coaching während der Aufnahme
- Nächster Schnitt:
get_next_shot_cue– ein Cue pro Aufruf, aufnehmen, wiederholen. - "Wie habe ich mich geschlagen?":
get_shot_coaching_rubric, dann bewerten Sie den Clip, den Ihnen der Benutzer zeigt, anhand dieser Rubrik. Der Rubrikaufruf trägt absichtlich keinen Datei- oder URL-Parameter – das Verständnis des Clips liegt bei Ihnen, bei Medien, die Sie bereits sehen. Senden Sie niemals das Filmmaterial des Benutzers irgendwohin. Für eine strukturelle Zweitmeinung zu einer fertigen Datei führen Sie parallel Ablauf G aus.
Ablauf E – "Was gibt es diese Woche Neues?"
get_lifecycle_briefing einmal; get_started ist die Erstkontakt-Orientierung, wenn der
Benutzer fragt, was Shorti überhaupt kann.
Das Paket – Ihre erste Ausgabe
Schreiben Sie eine lokale Datei shorti-packet-<slug>.md im Arbeitsverzeichnis:
# <Arbeitstitel>
## Formel (entlehnt von <Abstammungsreferenz>)
behalten / ändern / niemals_anfassen – wörtlich aus der Genealogiekarte, mit Belegen.
## Einstellungsliste
Nummerierte Einstellungen aus dem Clone-Kit: Takt, Dauer, Bildausschnitt, Aktion, Audio-Cue.
## Pro-Einstellungs-Cues
Die Cues, die Sie einzeln am Set geben würden (Ablauf D-Reihenfolge).
## Bewertungsrubrik
Die Rubrik, anhand derer Sie das tägliche Material bewerten werden.
## Belege
Abstammungsreferenzen und observed_metrics – nur Fakten, keine Vorhersagen.
Schließen Sie diesen Schritt mit genau einer maschinenlesbaren Zeile ab:
PACKET_FILE=<absoluter Pfad>
Ablauf F – Paket → Timeline → mp4 (den Kreislauf schließen)
Das Paket ist ein Plan; dies verwandelt ihn in eine Datei. Beginnen Sie nicht ohne Medien.
-
Lokalisieren Sie die Medien. Fragen Sie den Benutzer einmal nach dem Clip-Verzeichnis oder verwenden Sie die bereits auf der Festplatte befindlichen Ausgaben des Anbieters. Jedes
src, das Sie schreiben, muss aufgelöst werden können. -
Erstellen Sie die Timeline selbst. Übersetzen Sie die Einstellungsliste des Pakets in eine JSON-Datei – Sie schreiben sie, kein Werkzeug generiert sie. Felder, und nur diese:
{ "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": "warte ab", "pos": "center"}, "cue": "kalter Einstieg auf die Enthüllung, kein Logo" } ], "subtitles": {"mode": "none"}, "provenance": {"packet": "shorti-packet-<slug>.md"} }beats[].tsind absolute Sekunden, sortiert, nicht überlappend.roleist eines vonhook | development | payoff | cta | other. Erforderlich:version,canvas,beatsund pro Beatt+shot. Alles andere ist optional – lassen Sie weg, was Sie nicht wissen, anstatt es zu erfinden. Führen Sie den Paketdateinamen inprovenancemit. Arbeitsbeispiele:examples/*.json. -
viralprinter validate <timeline.json>– beheben Sie jeden Fehler in der Timeline. Arbeiten Sie niemals einen Validierungsfehler umgehen; er sagt Ihnen, dass der Plan nicht renderbar ist. -
viralprinter compose <timeline.json> -o out.mp4– verwenden Sie--dry-runzuerst, wenn der Render lang ist oder die Medien unbekannt sind. -
Berichten Sie in Prosa, was Sie erstellt haben, dann genau eine maschinenlesbare Zeile:
VIDEO_FILE=<absoluter Pfad> -
Bieten Sie die Bewertung an oder führen Sie sie direkt aus, wenn der Benutzer nach einem fertigen Kurzvideo gefragt hat:
viralprinter grade out.mp4 --markdown, dann die Berichtsregeln von Ablauf G.
Ablauf G – "Bewerte dieses Kurzvideo" (kein Shorti-Konto erforderlich)
Funktioniert mit jeder Datei, auf die der Benutzer zeigt, einschließlich der Rohausgabe eines beliebigen KI-Videogenerators, und mit einer Timeline JSON, bevor ein einziges Bild gerendert wurde.
viralprinter grade <datei.mp4 | timeline.json> --markdown(--json, wenn eine Maschine es konsumiert).- Berichten Sie die Tafel. Es gibt keine Gesamtbewertung – die Tafel ist das Ergebnis. Mitteln Sie sie nicht, erfinden Sie keine Note, ordnen Sie das Video nicht ein.
- Lesen Sie
not_measured-Zeilen mit ihrem Grund laut vor. Ein Video kann seine eigenen Beat-Rollen nicht preisgeben, daher sind einige Kategorien nur im Timeline-Modus messbar; diese Lücke ist die ehrliche Antwort, kein Fehler. - Sagen Sie, was die Bänder sind: grob, destilliert,
provenance: provisional. Sie beschreiben Struktur, die in analysierten Clips wiederkehrt. Sie versprechen keine Leistung, und eineout_of_band-Zeile ist eine zu beantwortende Frage, kein Mangel. - Seien Sie dann nützlich – nennen Sie die eine strukturelle Änderung mit der größten Wirkung und gehen Sie, wenn der Benutzer sie angewendet haben möchte, zu Ablauf F.
Fehlerprotokoll
- OAuth nicht abgeschlossen → ein Satz, der den Benutzer auffordert, den Browser-Flow abzuschließen, dann einmal wiederholen.
- Ein Werkzeug, das eine Referenz benötigt, wurde kalt aufgerufen (fehlendes
trend_refusw.) → Sie haben einen Schritt übersprungen; gehen Sie einen Aufruf im Ablauf zurück, anstatt blind zu wiederholen. - Anhaltende Transportfehler → melden Sie den letzten Fehler wörtlich und stoppen Sie.
viralprinteroderffmpegnicht gefunden → melden Sie die fehlende Binärdatei und die Installationszeile. Simulieren Sie niemals einen Render.- Fehler bei der Komposition → der Fehler enthält den ffmpeg stderr-Auszug. Zitieren Sie ihn, beheben Sie dann die Timeline. Führen Sie ffmpeg nicht manuell aus, um den Komponisten zu umgehen.
- Validierungsfehler → beheben Sie die Timeline und validieren Sie erneut. Übergeben Sie
niemals eine ungültige Timeline an
compose.