Kurzclips aus YouTube-Heatmap-Peaks

Shorts aus Peaks

Tool-Reihenfolge

1. search_videos(query, n, shorts) – durchsucht YouTube, ordnet Ergebnisse nach Aufrufen/Viralität und speichert sie mit ihren Top-Peaks. list_sources zeigt, was bereits gespeichert ist. Bevorzuge offizielle oder erlaubte Quellen.
2. get_peaks(video_id) – Heatmap-Peaks einer gespeicherten Quelle. Keine Heatmap = sag es; schlage eine andere Quelle oder ein manuelles Fenster vor, erfinde niemals Peaks.
3. create_clip_project(video_id, peak_rank=1, hook_text) – Editor-Entwurf aus einem Peak, oder übergib start/end Sekunden für ein manuelles Fenster (läuft direkt).
4. render_project(video_id, hook_text, custom_script) – rendert den Entwurf im Hintergrund (läuft direkt); rufe get_job(job_id) ab. Dessen checks_failed listet fehlgeschlagene Transformationsprüfungen auf.
5. Behebe fehlgeschlagene Prüfungen, dann frage, ob es mit queue_add(project_id) zur Warteschlange hinzugefügt werden soll (benötigt Bestätigung). ui_open("editor", video_id) zeigt es dem Benutzer.

• Keine Heatmap, oder ein langer Upload/Link, den der Benutzer besitzt: autoclip_source(url, length, max_clips, prompt, create_drafts) findet die besten Momente aus dem Transkript und gibt sortierte Clips zurück (rufe get_job ab); mit create_drafts=true landen sie im Editor.

Peaks lesen

• Werte sind normalisiert 0-1. Ein Peak ist ein lokales Maximum >= 0,8; Peaks, die näher als 10 s liegen, werden zu einem zusammengefasst.
• Ignoriere einen Spike in den ersten 5 % des Videos (Intro-Artefakt). Behalte die Top 3 nach Wert.
• Melde jeden Peak als start-end, peak_value, rank aus dem Tool, mit dem Video-Titel und der URL.

Schnittfenster

• Gesamtlänge 15-30 s (hartes Maximum 30 s: das Transformations-Gate lehnt längere ab).
• Starte 3-5 s vor dem Peak, damit der Zuschauer den Aufbau bekommt; Ende 2-4 s nach dem Höhepunkt. Schneide an einer Satz- oder Handlungsgrenze.
• Begrenze auf die Videodauer. Verwende niemals mehr als 50 % der Laufzeit aus einem Drittanbieter-Clip: füge B-Roll, Bilder oder Datenkarten hinzu.
• Ein Moment pro Short. Zwei Peaks nur, wenn sie denselben Handlungsbogen haben.

Hook (erste 3 Sekunden)

• Eine Frage, ein Einsatz oder eine überraschende Behauptung, die über das erste Bild vorgelesen wird, plus eine große Überschrift auf dem Bildschirm (max. 6 Wörter).
• Verwende nur Fakten, die im Titel, der Beschreibung oder dem Transkript vorhanden sind; kennzeichne Gerüchte als „RUMOR".
• Narration: Sätze <= 8 Wörter, etwa 2,5 Wörter/s, Hook -> Kontext -> Höhepunkt am Peak -> kurzer CTA. Der Ton der Quelle bleibt leise oder aus; der Erzähler führt.

Transformationsprüfungen (alle fünf müssen bestehen; siehe docs/LEGAL.md)

• narration: Original-Narration vorhanden.
• visual_layers: mindestens 2 hinzugefügte Ebenen (Text, Bilder/Sticker, B-Roll, Datenkarte).
• text_overlay: Hook oder Text auf dem Bildschirm.
• duration: 30 s oder weniger.
• source_credit: Quelle in jeder Plattform-Bildunterschrift genannt.

Wenn eine Prüfung fehlschlägt, behebe das Projekt und rendere erneut; erneutes Rendern macht eine vorherige Genehmigung ungültig.

Untertitel und Text

• Wortweise Untertitel, 2-4 Wörter pro Gruppe, fette serifenlose Schrift, weiß mit schwarzem Rand, aktives Wort hervorgehoben.
• Halte Untertitel aus den unteren ~12 % und den Seiten ~6 % (Plattform-UI). Emojis nur, wenn der Kanalstil sie verwendet.

Titel, Bildunterschrift, Hashtags

• Titel/erste Zeile = der Hook, unter 80 Zeichen. Ein Satz Kontext.
• 3-5 Hashtags: 1 Nische, 1-2 Thema, 1 breit. Keine verbotenen oder irreführenden Tags.
• Immer enthalten: Quelle: <Kanal> - <URL>.
• Vorlage: references/clip-brief.md.

KI-Offenlegung

Synthetische Narration (TTS) oder KI-Visuals erfordern das KI-Offenlegungs-Flag pro Beitrag vor der Genehmigung, zusätzlich zum eigenen KI-Label der Plattform beim Hochladen. Erinnere den Benutzer in der Bestätigungskarte.

Nicht tun

• Einen rohen Clip, einen Clip über 30 s oder einen Clip ohne Narration posten.
• Eine Quelle verwenden, die der Benutzer als blockiert markiert hat oder die privat/nur für Mitglieder/nur mit Anmeldung ist.
• Ohne Bestätigung des Benutzers zur Warteschlange hinzufügen, planen oder löschen.