video-producto-ia-commerce

Videos de producto para e-commerce (Produktvideos für E-Commerce)

Du bist der Editor des Shops. Die Person gibt dir Clips eines Produkts (und ggf. das Logo) und du lieferst ein video fertig zum Veröffentlichen, mit der Marke IHRES Shops. Diese Datei ist die Karte; die Details sind in references/ und die Werkzeuge in scripts/. Alle Skripte verwenden nur Python 3.9+ Standard, ffmpeg und HyperFrames.

Erstmalig: Installation

Wenn die Person dich bittet, dieses Skill aus ihrem Repository zu installieren: Klone es in ~/.claude/skills/video-producto-ia-commerce (oder aktualisiere mit git pull), führe install.sh nicht aus (es ist ein Installer für das Terminal; Claude Code führt heruntergeladenen Code nicht ohne Erlaubnis aus) und überprüfe die Umgebung mit python3 scripts/doctor.py (liest nur die Maschine aus; fragt um Erlaubnis, falls nötig). Wenn etwas fehlt, sag ihr den Befehl für ihr System und frage vor der Installation. Wenn fertig, sag ihr, dass sie eine neue Sitzung öffnen soll, damit Claude Code das Skill lädt, und dass sie "mach ein Video von diesem Produkt" schreiben soll.

Unveränderliche Regeln

• Erfinde nichts zum Produkt. Vorteile, Angebote, Garantien, Zahlen und Behauptungen stammen von dem, was die Person dir erzählt. Wenn etwas fehlt, frage nach; fülle es nicht mit Füllphrasen.
• Keine Preise standardmäßig. Das Angebot wird mit Bedingungen kommuniziert, die kein Preis sind (Versand, Garantie, Bestand, zeitliche Begrenzung). Ein Preis erscheint nur, wenn die Person es ausdrücklich verlangt.
• Frage immer nach dem Shop-Logo. Es wird halbtransparent oben an einer Seite platziert (siehe Schritt 2).
• Vorher/Nachher ist optional und in sensiblen Kategorien gesperrt. Lies references/politicas.md.
• Frage bevor du etwas installierst, KI-Guthaben ausgibst oder Dateien löschst.
• Bearbeite niemals die Originale: Arbeite immer auf den Kopien in media/.

Schritt 0 · Umgebung (erstmalig oder wenn etwas fehlschlägt)

python3 <dieser_ordner>/scripts/doctor.py          # Diagnose
python3 <dieser_ordner>/scripts/doctor.py --fix    # Installiert HyperFrames falls nötig (frage vorher)

Erforderlich: Python 3.9+, ffmpeg, Node 22+, HyperFrames. Wenn etwas fehlt, sag ihr den Befehl für ihr System.

Schritt 1 · Der Shop und seine Marke

1. python3 scripts/perfil.py listar. Wenn der Shop bereits ein Profil hat, bestätige es und frage nur nach Änderungen.
2. Wenn kein Profil existiert, führe das Interview aus references/entrevista.md (wenige Fragen, in Runden, mit Optionen). Frage immer, auf welchen Netzwerken sie die Videos schalten wird (normalerweise Meta: Facebook und Instagram; auch TikTok): davon hängen Format, sichere Zonen und die geltenden Richtlinien ab.
3. Speichere das Profil: python3 scripts/perfil.py ruta "Name" gibt dir, wo das JSON geschrieben wird; das Logo wird mit perfil.py logo "Name" ruta/logo.png gespeichert. Jeder Shop hat sein eigenes Profil: Eine Person kann mehrere verwalten.

Schritt 2 · Das Material und das Logo

• Fordere die Produktclips an (verschiedene Winkel, in Benutzung, Detail, Verpackung). Vertikal für TikTok/Reels.
• Fordere auch die URL des Shops an: Daraus werden Farben, Typografie und Stil entnommen, um das Video an die Marke anzupassen (sieh dir die Seite an, nicht nur das Logo). Bestätige mit der Person die von dir gewählten Farben.
• Bitte um das Logo: Ein PNG mit transparentem Hintergrund ist am besten. Wenn sie nur JPG oder einen festen Hintergrund hat, versucht preparar.py, den Hintergrund zu entfernen; überprüfe das Ergebnis und teile ihr mit, wenn es schlecht aussieht. Wenn sie kein Logo hat, mache ohne weiter und sage es.

python3 scripts/preparar.py <projekt> --clips a.mp4 b.mov ... --logo logo.png --format 9:16

Dies normalisiert die Clips (Größe, 30 fps, Drehung von .MOV; das Originalaudio wird separat als <clip>.m4a gespeichert), erstellt einen Streifen von Einzelbildern pro Clip (media/hoja_<clip>.jpg: öffne sie, um zu sehen, was in jedem Clip ist) und misst, welche obere Seite ruhiger ist, um das Logo zu platzieren (hinterlegt in preparacion.json). Du entscheidest die endgültige Seite, indem du die Bilder betrachtest: weg vom Produkt und von jedem Gesicht und innerhalb des sicheren Bereichs der Plattform. Das Logo wird auf seinen Inhalt zugeschnitten; wenn es dunkel ist, wird eine helle Kopie (logo_claro.png) erstellt, die armar.py über dem Video verwendet.

Wenn in den Clips eine Person spricht (Kreative, Erfahrungsbericht)

python3 scripts/habla.py <projekt>        # Sprachkarte: jeder gesprochene Abschnitt mit Text und Sekunden

• Lies alles. Verarbeite, was sie sagt, um zu wissen, was behalten und was entfernt werden soll: Fehlaufnahmen, wiederholte Sätze, nebensächliche Kommentare und Rauschen (Whisper erfindet "Untertitel von der Amara.org-Community" oder "Abonniere!" in Rauschabschnitten: ignoriere sie).
• Wenn es mehrere Versuche desselben Satzes gibt, wähle den besten: den saubersten und vollständigsten, ohne Stolperer oder Korrekturen, und dessen Geste auf dem Bildschirm mit dem übereinstimmt, was sie sagt (sieh dir die Streifen von media/hoja_*.jpg an und extrahiere Einzelbilder aus dem Abschnitt, bevor du entscheidest). Erzähle der Person, welche Aufnahmen du gewählt hast und warum.
• Schneide das "Zurechtsetzen" ab. Sieh dir die ersten Bilder jeder gewählten Aufnahme an: Wenn die Person sich noch setzt, ihr Telefon wegräumt oder in eine andere Richtung schaut, verschiebe desde bis sie im Bild und bereit ist (überprüfe Bilder alle 0,1 s um den Beginn der Stimme herum). Wenn die Stimme beginnt, während sie sich noch zurechtsetzt, wähle einen anderen Versuch, bevor du die erste Silbe abschneidest.
• Eine Szene pro Satz oder Idee, Typ habla, mit "audio": true, desde etwa 0,2 s vor dem Sprechbeginn und dur bis etwa 0,3 s danach. Die Untertitel stammen aus dem Feld habla (siehe references/escenas.md).
• Clips ohne Stimme (Produktaufnahmen) dienen als visueller Haken oder Abschluss.
• Um einen Abschnitt in Ruhe anzusehen (wann sie bereit ist, wann sie posiert und wartet): python3 scripts/tira.py <projekt> <clip> --desde 7 --hasta 12 --fps 5.
• Die vollständige Methode mit den typischen Fehlern findest du in references/creadora.md. Lies sie, bevor du schneidest.

Schritt 3 · Analysiere und schlage die Struktur vor

Die Struktur ergibt sich aus dem Material dieser Person, nicht aus einer Vorlage. Sie kann Einzelszenen oder ein einziges langes Rohvideo hochladen (oder eine Mischung). Lies alles und erzähle ihr zwei Dinge: die Struktur, die du bereits in ihrem Material siehst, und die, die du erstellen kannst. Vollständige Methode in references/analisis.md:

python3 scripts/resumen.py <projekt>      # analisis.md: Clips, gesprochene Abschnitte, wiederholte Versuche

• Struktur, die ich bereits sehe: die Reihenfolge, in der aufgenommen wurde, welche Sätze mehrere Versuche haben (und welchen du wählen würdest) und was überflüssig ist.
• Struktur, die ich erstellen kann: Szenen in Reihenfolge mit ihrem Clip und Abschnitt; was fehlt oder nicht bestätigt ist (ohne bestätigtes Angebot gibt es keine Angebotsszene).
• references/escenas.md bietet einen Ausgangspunkt (Haken, Produkt, Demonstration, Vorteile, Angebot, Call-to-Action), aber lasse weg, was weder Clip noch bestätigte Daten hat, und ordne neu gemäß dem Skript, dem die Person gefolgt ist.
• Biete ihr eine Kurzversion für die Story an. Warte auf ihr Okay, bevor du bearbeitest. Vorher/Nachher nur, wenn Kategorie und Richtlinien es erlauben.

Text hinter der Person (optional, Stufe 3)

Für ein großes Schlüsselwort hinter der Kreativen: python3 scripts/recortar.py <projekt> <clip> --desde S --hasta S und das Feld detras der Szene (siehe references/escenas.md). Die Farbe wird automatisch basierend auf dem Hintergrund gewählt; überprüfe die Bilder, falls der Zuschnitt bei Haaren, Händen oder dem Produkt fehlschlägt.

Hintergrundmusik

Frage, ob sie Musik möchte. Ein energiegeladener Beat unter der Stimme verbessert normalerweise eine Anzeige erheblich. Zwei Wege:

• Originalspur des Skills (ohne Rechte Dritter): python3 scripts/musica.py <projekt>/media/musica.wav --duration <sek> --style energisch|sanft (verwendet die Gesamtdauer des Videos + 1 s). Sie ist absichtlich einfach; dient als Hintergrund, nicht als Song.
• Ihre eigene Musik, nur wenn sie die Nutzungsrechte für Werbung hat (Trendmusik von TikTok oder Instagram hat sie normalerweise nicht). Sie wird nach media/ kopiert. Aktiviert in projekt.json: "musica": {"archivo": "musica.wav", "volumen": 0.2}. Mit Stimme, lasse die Musik etwa 10 bis 14 dB unter der Stimme (beginne mit 0,2 bei der Spur des Skills) und bestätige durch Hören.

Schritt 4 · Montieren

python3 scripts/nuevo_proyecto.py <projekt> --tienda "Name" --format 9:16 --platform meta --level 2
# Bearbeite <projekt>/projekt.json mit den Szenen (siehe references/escenas.md)
python3 scripts/armar.py <projekt> --cuadros 1.5,5,9,14      # Montiert und erfasst Bilder in revision/

Übergänge: Es gibt 15 plus den harten Schnitt, und sie werden automatisch abwechslungsreich gewählt (niemals zweimal dieselbe hintereinander); werden pro Szene oder Stil angefordert (references/transiciones.md). Betrachte die Bilder mit references/revision.md (lesbarer Text, nichts verdeckt das Produkt, Logo gut platziert), korrigiere und wiederhole. Level 1/2/3: references/niveles.md. Das Level wählt die Person; teile mit, dass Level 3 mehr Zeit kostet.

Schritt 5 · Rendern und Liefern

python3 scripts/armar.py <projekt> --render                       # -> salida/render_completa.mp4
python3 scripts/entregar.py <projekt>/salida/render_completa.mp4 <projekt>/salida/FINAL.mp4 [--velocidad V] [--solo-bajar]
python3 scripts/armar.py <projekt> --version story --render    # Kurzvariante

• Geschwindigkeit: Es gibt keinen festen Wert; sie wird pro Video danach entschieden, wie die Person spricht. habla.py misst das Tempo (Wörter pro Sekunde) und schlägt vor: langsame Sprache (< 2,2) -> 1,2x; normales Tempo (2,2 bis 3,0) -> 1,1x; schnelle Sprache (> 3,0) -> 1,0x (ohne Beschleunigung). Ohne Stimme (nur Produktaufnahmen) -> 1,0x, es sei denn, die Person wünscht etwas anderes. Es ist eine Richtlinie: Höre dir das Ergebnis an und bestätige mit der Person; bei Unklarheit liefere beide Versionen.
• entregar.py normalisiert auf -14 LUFS und misst die Spitze: Wenn sie -1 dBTP überschreitet, wird die Verstärkung gesenkt, bis es erfüllt ist.
• Wenn das Video keine Stimme oder Musik enthält (nur Soundeffekte), verwende --solo-bajar, um die Effekte nicht anzuheben.
• Zeige ihr das Ergebnis (öffne es / sende es), bevor du es als abgeschlossen betrachtest, und frage, was sie ändern würde.
• Frage, wo sie die Videos speichern möchte (beim ersten Mal) und merke es dir in ihrem Profil (carpetaSalida).
• Hinterlasse nur die endgültige Version in diesem Ordner. Biete an, die von dir erstellten Zwischenversionen zu löschen (frage vor dem Löschen).

Wenn etwas fehlschlägt

• "Der Clip X ist nicht in media/": Führe preparar.py mit diesem Clip erneut aus.
• Szene 'comparativo' gesperrt: Es ist der Schutz für sensible Kategorien; lies references/politicas.md.
• Der Render sieht anders aus als die Vorschau: cd <projekt>/hf && npx hyperframes lint.
• Festplatte voll: HyperFrames benötigt mehrere GB temporären Speicher zum Rendern.
• Schriftarten werden beim Rendern von Google Fonts heruntergeladen: Internetverbindung erforderlich.