Ozor URL-para-Vídeo

O que Ozor URL-para-Vídeo faz?

Transformação completa de página web para vídeo no Ozor.ai. Entregue uma URL ao Ozor, receba um plano que reflete o conteúdo real da página (títulos, propostas de valor, prova social, CTA), aprove ou edite, e publique um vídeo finalizado.

Quando usar

Use esta skill quando a entrada for uma URL. Sinais:

• "Faça um vídeo a partir de https://..."
• "Vídeo da minha página de destino / homepage / página de produto"
• "Transforme este post de blog em um vídeo"
• "Vídeo a partir deste artigo / página de changelog"
• Qualquer mensagem que contenha uma URL que o usuário espera que você leia

NÃO use esta skill quando:

• A entrada for um resumo curto de texto → ozor-generate
• A entrada for um arquivo local anexado (PDF/PPTX/DOCX) → ozor-document-video
• O usuário quiser apenas um prompt escrito → ozor-landing-page-to-video (skill somente de prompt)
• O usuário quiser gerenciar vídeos existentes → ozor-video-library

Ferramentas MCP necessárias

• mcp__ozor__analyze_document — aceita um parâmetro url diretamente; não precisa de upload
• mcp__ozor__get_plan / mcp__ozor__update_plan — revisar/editar o plano antes da geração
• mcp__ozor__generate_from_plan — inicia a construção, retorna projectId
• mcp__ozor__wait_for_job — se a resposta incluir um jobId
• mcp__ozor__export_video, mcp__ozor__wait_for_export
• mcp__ozor__get_embed_code

Se o MCP não estiver conectado, avise o usuário e pare. Não navegue pela URL você mesmo e escreva um prompt manualmente — o Ozor extrai cores da marca, imagens principais e estrutura diretamente da página. Seu texto raspado perderia tudo isso.

Fluxo de trabalho

Passo 1 — Entregue a URL ao Ozor

mcp__ozor__analyze_document({
  url: "<a URL>",
  ...dicas opcionais: targetDuration, format, audience, tone, focus
})

Para URLs:

• Páginas de destino / páginas de produto → padrão para format: "9:16" ou "16:9" (pergunte se não estiver óbvio — vertical é ótimo para redes sociais, paisagem para incorporação no próprio site), targetDuration: "30s"–"45s", tom "confiante".
• Posts de blog / artigos → format: "16:9", targetDuration: "60s"–"90s", tom "informativo".
• Páginas de changelog / release → format: "16:9", targetDuration: "30s"–"45s", tom "energético", foco "uma cena por funcionalidade lançada".
• Páginas de documentação → format: "16:9", targetDuration: "60s", tom "claro, técnico", foco "explique o que este recurso faz e como usá-lo".

Retorna { planId, plan }.

Passo 2 — Apresente o plano e PARE

Renderize o plano para o usuário de forma concisa:

📋 Plano Ozor para <URL>

**Fonte:** <título da página ou domínio>
**Formato:** 16:9 / 9:16
**Duração estimada:** ~X segundos
**Marca detectada:** <cores / nome do produto se o Ozor as trouxe>
**Cenas:** N

(1) <título da cena> — <direção de uma linha>
(2) <título da cena> — <direção de uma linha>
...

Aprove como está, ou quer mudar algo? Você pode editar cenas, trocar formato, alterar tom ou mudar o foco.

Aguarde a aprovação. Não chame generate_from_plan ainda.

Passo 3 — Aplique edições (se houver)

Use mcp__ozor__update_plan({ planId, ... }). Reexiba o plano com get_plan. Repita até aprovação.

Passo 4 — Gere

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

Se um jobId for retornado, use mcp__ozor__wait_for_job({ videoId: projectId, jobId }).

Passo 5 — Exporte

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

Passo 6 — Incorpore

mcp__ozor__get_embed_code({ videoId: projectId })

Passo 7 — Apresente os resultados

🎬 Vídeo pronto a partir de <URL>

**Compartilhar:** <shareUrl>
**Editor:** <editorUrl>
**Download:** <downloadUrl>

**Incorporar (cole no seu site):**
```html
<iframe ...></iframe>

Quer um corte vertical 9:16 para redes sociais, ou uma versão explicativa mais longa de 90s? Posso regenerar a partir do mesmo plano.

## O que o fluxo de URL faz de melhor

- **Páginas de destino** — O Ozor captura o título principal, a proposta de valor, a prova social, o CTA e as cores da marca. Seu prompt perderia tudo isso.
- **Posts de blog** — captura a tese e a estrutura de seções; produz um explicador que mapeia o artigo.
- **Changelogs** — mapeia naturalmente cada release/funcionalidade para sua própria cena.
- **Páginas de produto** — puxa capturas de tela do produto / imagens principais para as cenas quando disponíveis.

## Heurística de decisão de formato

Se o usuário não especificou:

- URL é uma homepage ou página de produto **e** o caso de uso óbvio é social/anúncios → `9:16`
- URL é uma homepage ou página de produto **e** o caso de uso óbvio é incorporação na própria página → `16:9`
- URL é um blog / artigo / doc / changelog → `16:9`

Quando ambíguo, proponha `16:9` como padrão e ofereça uma reexecução `9:16` no final.

## Variantes que vale a pena oferecer após a primeira renderização

Mencione estas apenas depois que o usuário tiver o primeiro vídeo — não as pré-gerencie:

- **Corte social 9:16** de um vídeo paisagem → regenere a partir do mesmo plano com `update_plan({ planId, format: "9:16" })`.
- **Teaser curto (15s)** + **explicador completo (60s)** a partir da mesma página.
- **Dois públicos** (ex.: "comprador técnico" vs "comprador executivo") — reanalise com uma dica de `audience` diferente.

## Erros e recuperação

- **`analyze_document` retorna um plano raso** (frequentemente: página com paywall, SPA renderizada com JS que o Ozor não conseguiu ler) → avise o usuário, peça uma URL alternativa ou se ele pode colar o conteúdo principal como um resumo para `ozor-generate`.
- **Cores da marca detectadas parecem erradas** → `update_plan` com cores corrigidas antes de gerar.
- **Falha na geração** → verifique a cena que o erro referencia, corrija via `update_plan`, tente novamente.
- **Exportação trava** → chame `wait_for_export` novamente; ele retoma.

## Regras

1. **Sempre passe a URL para `analyze_document`.** Nunca raspe a página você mesmo e direcione para `generate_video` — isso joga fora a extração visual e de marca do Ozor.
2. **Sempre mostre o plano e aguarde aprovação** antes do `generate_from_plan`. O plano é onde formato e tom são definidos.
3. **Use `projectId` como `videoId`** para export, wait_for_export e embed.
4. **Disponibilize todas as URLs** — compartilhar, editor, download, incorporar.
5. **Proponha, não pré-generare, variantes.** Não queime renderizações em 9:16 + 16:9 + teaser sem ser solicitado.