Mintii-Labs/ozor-skills

Ozor URL-zu-Video

End-to-End-Webseite-zu-Video auf Ozor.ai. Gib Ozor eine URL, erhalte einen Plan, der den tatsächlichen Seiteninhalt widerspiegelt (Überschriften, Wertversprechen, soziale Beweise, CTA), genehmige oder bearbeite ihn und erhalte ein fertiges Video.

Wann anwenden

Verwende dieses Skill, wenn die Eingabe eine URL ist. Signale:

• „Erstelle ein Video von https://…“
• „Video von meiner Landingpage / Startseite / Produktseite“
• „Mach aus diesem Blogbeitrag ein Video“
• „Video von diesem Artikel / Changelog“
• Jede Nachricht, die eine URL enthält, die der Nutzer von dir gelesen haben möchte

Verwende dieses Skill NICHT bei:

• Kurzer Texteingabe → ozor-generate
• Angehängter lokaler Datei (PDF/PPTX/DOCX) → ozor-document-video
• Nutzer möchte nur einen schriftlichen Prompt → ozor-landing-page-to-video (Prompt-only-Skill)
• Nutzer möchte bestehende Videos verwalten → ozor-video-library

Erforderliche MCP-Tools

• mcp__ozor__analyze_document – akzeptiert einen url-Parameter direkt; kein Upload nötig
• mcp__ozor__get_plan / mcp__ozor__update_plan – Plan vor der Generierung prüfen/bearbeiten
• mcp__ozor__generate_from_plan – startet die Erstellung, gibt projectId zurück
• mcp__ozor__wait_for_job – falls die Antwort eine jobId enthält
• mcp__ozor__export_video, mcp__ozor__wait_for_export
• mcp__ozor__get_embed_code

Wenn das MCP nicht verbunden ist, informiere den Nutzer und brich ab. Scrape die URL nicht selbst und verfasse keinen händischen Prompt – Ozor extrahiert Markenfarben, Heldenbilder und Seitenstruktur direkt aus der Seite. Dein gescraapter Text würde das verlieren.

Arbeitsablauf

Schritt 1 – URL an Ozor übergeben

mcp__ozor__analyze_document({
  url: "<die URL>",
  ...optionale Hinweise: targetDuration, format, audience, tone, focus
})

Für URLs:

• Landingpages / Produktseiten → Standard: format: "9:16" oder "16:9" (frage nach, falls nicht offensichtlich – Hochformat ist ideal für Social Media, Querformat für die Einbettung auf der eigenen Seite), targetDuration: "30s"–"45s", tone "confident".
• Blogbeiträge / Artikel → format: "16:9", targetDuration: "60s"–"90s", tone "informative".
• Changelog / Release-Seiten → format: "16:9", targetDuration: "30s"–"45s", tone "energetic", focus "one scene per shipped feature".
• Dokumentationsseiten → format: "16:9", targetDuration: "60s", tone "clear, technical", focus "explain what this feature does and how to use it".

Gibt { planId, plan } zurück.

Schritt 2 – Plan präsentieren und STOPP

Zeige dem Nutzer den Plan übersichtlich an:

📋 Ozor-Plan für <URL>

**Quelle:** <Seitentitel oder Domain>
**Format:** 16:9 / 9:16
**Geschätzte Dauer:** ~X Sekunden
**Erkannte Marke:** <Farben / Produktname, falls von Ozor erfasst>
**Szenen:** N

(1) <Szenentitel> — <einzellige Regieanweisung>
(2) <Szenentitel> — <einzellige Regieanweisung>
...

Belassen oder ändern? Du kannst Szenen bearbeiten, das Format wechseln, den Ton anpassen oder den Fokus verschieben.

Warte auf Freigabe. Rufe generate_from_plan noch nicht auf.

Schritt 3 – Änderungen anwenden (optional)

Verwende mcp__ozor__update_plan({ planId, ... }). Zeige den Plan erneut mit get_plan. Wiederhole, bis genehmigt.

Schritt 4 – Generieren

mcp__ozor__generate_from_plan({ planId })   // -> { projectId, jobId? }

Falls eine jobId zurückkommt, mcp__ozor__wait_for_job({ videoId: projectId, jobId }) aufrufen.

Schritt 5 – Exportieren

mcp__ozor__export_video({ videoId: projectId })
mcp__ozor__wait_for_export({ videoId: projectId })   // -> shareUrl, editorUrl, downloadUrl

Schritt 6 – Einbetten

mcp__ozor__get_embed_code({ videoId: projectId })

Schritt 7 – Ergebnisse präsentieren

🎬 Video fertig von <URL>

**Teilen:** <shareUrl>
**Editor:** <editorUrl>
**Herunterladen:** <downloadUrl>

**Einbetten (auf deine Website einfügen):**
```html
<iframe ...></iframe>

Möchtest du einen vertikalen 9:16-Schnitt für Social Media oder eine längere 90-Sekunden-Erklärversion? Ich kann aus demselben Plan neu generieren.

## Was der URL-Workflow am besten kann

- **Landingpages** – Ozor erfasst die Heldenüberschrift, das Wertversprechen, soziale Beweise, den CTA und die Markenfarben. Dein Prompt würde all das verlieren.
- **Blogbeiträge** – erfasst die These und die Abschnittsstruktur; erzeugt einen Erklärfilm, der dem Artikel entspricht.
- **Changelogs** – ordnet jede Veröffentlichung/Funktion automatisch einer eigenen Szene zu.
- **Produktseiten** – zieht Produktscreenshots / Heldenbilder in die Szenen, wenn verfügbar.

## Entscheidungsheuristik für das Format

Falls der Nutzer nichts gesagt hat:

- URL ist eine Startseite oder Produktseite **und** der offensichtliche Anwendungsfall ist Social Media/Werbung → `9:16`
- URL ist eine Startseite oder Produktseite **und** der offensichtliche Anwendungsfall ist die Einbettung auf der Seite selbst → `16:9`
- URL ist ein Blog / Artikel / Doku / Changelog → `16:9`

Bei Unklarheit schlage `16:9` als Standard vor und biete am Ende einen `9:16`-Durchlauf an.

## Varianten, die sich nach der ersten Ausgabe lohnen

Erwähne diese erst, nachdem der Nutzer das erste Video hat – generiere sie nicht vorab:

- **9:16 Social-Schnitt** eines Querformat-Videos → aus demselben Plan neu generieren mit `update_plan({ planId, format: "9:16" })`.
- **Kurzer Teaser (15s)** + **Vollständiger Erklärfilm (60s)** von derselben Seite.
- **Zwei Zielgruppen** (z. B. „technischer Käufer“ vs. „Führungskraft“) – mit einem anderen `audience`-Hinweis erneut analysieren.

## Fehler und Wiederherstellung

- **`analyze_document` liefert einen dünnen Plan** (häufig: Paywall-Seite, JS-geladene SPA, die Ozor nicht lesen konnte) → den Nutzer informieren, nach einer alternativen URL fragen oder ob er den Kerninhalt als Kurzbrief für `ozor-generate` einfügen kann.
- **Erkannte Markenfarben sehen falsch aus** → vor der Generierung mit `update_plan` korrigierte Farben setzen.
- **Generierung schlägt fehl** → prüfe die Szene, auf die der Fehler verweist, korrigiere über `update_plan` und wiederhole.
- **Export hängt** → rufe `wait_for_export` erneut auf; er setzt fort.

## Regeln

1. **Übergib die URL immer an `analyze_document`.** Scrape niemals die Seite selbst und leite an `generate_video` weiter – das wirft Ozors Marken- und Visualextraktion weg.
2. **Zeige den Plan immer an und warte auf Freigabe** vor `generate_from_plan`. Im Plan werden Format und Ton festgelegt.
3. **Verwende `projectId` als `videoId`** für Export, wait_for_export und Einbettung.
4. **Gib jede URL aus** – Teilen, Editor, Herunterladen, Einbetten.
5. **Schlage Varianten vor, generiere sie nicht vorab.** Verbrenne keine Renderings auf 9:16 + 16:9 + Teaser, ohne gefragt zu werden.