Mintii-Labs/ozor-skills

Ozor URL vers Vidéo

Transformation de page web en vidéo de bout en bout sur Ozor.ai. Donnez une URL à Ozor, obtenez un plan reflétant le contenu réel de la page (titres, propositions de valeur, preuves sociales, CTA), approuvez ou modifiez, et recevez une vidéo finie.

Quand utiliser

Utilisez cette compétence lorsque l'entrée est une URL. Signaux :

• "Fais une vidéo à partir de https://..."
• "Vidéo de ma page d'accueil / page d'accueil / page produit"
• "Transforme cet article de blog en vidéo"
• "Vidéo de cet article / page de changelog"
• Tout message contenant une URL que l'utilisateur attend que vous lisiez

N'utilisez PAS cette compétence quand :

• L'entrée est un court texte d'instructions → ozor-generate
• L'entrée est un fichier local joint (PDF/PPTX/DOCX) → ozor-document-video
• L'utilisateur veut uniquement une invite écrite → ozor-landing-page-to-video (compétence invite uniquement)
• L'utilisateur veut gérer des vidéos existantes → ozor-video-library

Outils MCP requis

• mcp__ozor__analyze_document — accepte un paramètre url directement ; aucun téléchargement nécessaire
• mcp__ozor__get_plan / mcp__ozor__update_plan — examiner/modifier le plan avant la génération
• mcp__ozor__generate_from_plan — lance la construction, retourne projectId
• mcp__ozor__wait_for_job — si la réponse inclut un jobId
• mcp__ozor__export_video, mcp__ozor__wait_for_export
• mcp__ozor__get_embed_code

Si le MCP n'est pas connecté, informez l'utilisateur et arrêtez-vous. Ne parcourez pas vous-même l'URL et n'écrivez pas une invite manuellement — Ozor extrait les couleurs de marque, les images principales et la structure directement depuis la page. Votre texte récupéré perdrait tout cela.

Flux de travail

Étape 1 — Transmettez l'URL à Ozor

mcp__ozor__analyze_document({
  url: "<l'URL>",
  ...indices optionnels : targetDuration, format, audience, tone, focus
})

Pour les URLs :

• Pages d'accueil / pages produit → par défaut format: "9:16" ou "16:9" (demandez si ce n'est pas évident — le format vertical est idéal pour les réseaux sociaux, le paysage pour l'intégration sur le site lui-même), targetDuration: "30s"–"45s", ton "confiant".
• Articles de blog / articles → format: "16:9", targetDuration: "60s"–"90s", ton "informatif".
• Pages de changelog / version → format: "16:9", targetDuration: "30s"–"45s", ton "énergique", focus "une scène par fonctionnalité livrée".
• Pages de documentation → format: "16:9", targetDuration: "60s", ton "clair, technique", focus "expliquer ce que fait cette fonctionnalité et comment l'utiliser".

Retourne { planId, plan }.

Étape 2 — Présentez le plan et ARRÊTEZ

Affichez le plan à l'utilisateur de manière concise :

📋 Plan Ozor pour <URL>

**Source :** <titre de la page ou domaine>
**Format :** 16:9 / 9:16
**Durée estimée :** ~X secondes
**Marque détectée :** <couleurs / nom du produit si Ozor les a révélés>
**Scènes :** N

(1) <titre de la scène> — <direction en une ligne>
(2) <titre de la scène> — <direction en une ligne>
...

Approuvez tel quel, ou souhaitez-vous modifier quelque chose ? Vous pouvez éditer les scènes, changer le format, modifier le ton ou recentrer l'attention.

Attendez l'approbation. N'appelez pas generate_from_plan encore.

Étape 3 — Appliquez les modifications (si nécessaire)

Utilisez mcp__ozor__update_plan({ planId, ... }). Réaffichez le plan avec get_plan. Bouclez jusqu'à approbation.

Étape 4 — Génération

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

Si un jobId est retourné, mcp__ozor__wait_for_job({ videoId: projectId, jobId }).

Étape 5 — Exportation

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

Étape 6 — Intégration

mcp__ozor__get_embed_code({ videoId: projectId })

Étape 7 — Présentation des résultats

🎬 Vidéo prête depuis <URL>

**Partage :** <shareUrl>
**Éditeur :** <editorUrl>
**Téléchargement :** <downloadUrl>

**Code d'intégration (à placer sur votre site) :**
```html
<iframe ...></iframe>

Souhaitez-vous une version verticale 9:16 pour les réseaux sociaux, ou une version explicative plus longue de 90 secondes ? Je peux regénérer à partir du même plan.

## Ce que le flux URL fait de mieux

- **Pages d'accueil** — Ozor capture le titre principal, la proposition de valeur, les preuves sociales, le CTA et les couleurs de marque. Votre invite perdrait tout cela.
- **Articles de blog** — capture la thèse et la structure des sections ; produit une vidéo explicative qui suit l'article.
- **Changelogs** — associe naturellement chaque version/fonctionnalité à sa propre scène.
- **Pages produit** — intègre les captures d'écran / images principales du produit dans les scènes lorsque disponibles.

## Heuristique de décision du format

Si l'utilisateur n'a pas précisé :

- L'URL est une page d'accueil ou une page produit **et** le cas d'utilisation évident est les réseaux sociaux / publicités → `9:16`
- L'URL est une page d'accueil ou une page produit **et** le cas d'utilisation évident est l'intégration sur la page elle-même → `16:9`
- L'URL est un blog / article / doc / changelog → `16:9`

En cas d'ambiguïté, proposez `16:9` par défaut et proposez une version `9:16` à la fin.

## Variantes à proposer après le premier rendu

Mentionnez-les uniquement après que l'utilisateur a la première vidéo — ne les générez pas par anticipation :

- **Version sociale 9:16** d'une vidéo paysage → regénérez à partir du même plan avec `update_plan({ planId, format: "9:16" })`.
- **Teaser court (15s)** + **explication complète (60s)** à partir de la même page.
- **Deux audiences** (par ex. "acheteur technique" vs "acheteur exécutif") — réanalyse avec un indice `audience` différent.

## Erreurs et reprise

- **`analyze_document` retourne un plan maigre** (souvent : page payante, SPA rendue en JS qu'Ozor n'a pas pu lire) → informez l'utilisateur, demandez une URL alternative ou s'il peut coller le contenu clé sous forme d'invite pour `ozor-generate`.
- **Les couleurs de marque détectées semblent erronées** → `update_plan` avec des couleurs corrigées avant génération.
- **La génération échoue** → vérifiez la scène à laquelle l'erreur fait référence, corrigez via `update_plan`, réessayez.
- **L'exportation se bloque** → rappelez `wait_for_export` ; elle reprend.

## Règles

1. **Passez toujours l'URL à `analyze_document`.** Ne récupérez jamais la page vous-même et ne redirigez pas vers `generate_video` — cela jette l'extraction de marque et visuelle d'Ozor.
2. **Affichez toujours le plan et attendez l'approbation** avant `generate_from_plan`. Le plan est l'endroit où le format et le ton sont verrouillés.
3. **Utilisez `projectId` comme `videoId`** pour exportation, wait_for_export et intégration.
4. **Affichez chaque URL** — partage, éditeur, téléchargement, intégration.
5. **Proposez les variantes, ne les pré-générez pas.** Ne brûlez pas de rendus sur 9:16 + 16:9 + teaser sans demande.