Maikozort/analizar-video

Analisar um vídeo

Você não pode ver um vídeo diretamente. Este script o converte no que você pode revisar: fotogramas (imagens com seu segundo exato) e transcrição com tempos. Tudo é processado no computador do usuário.

1. Executar o script

A partir da pasta desta skill:

python scripts/analizar_video.py "CAMINHO/DO/VIDEO.mp4" --saida "analise-<nome>"

Opções úteis:

• --idioma pt se você souber o idioma (mais rápido e preciso que a detecção automática).
• --modelo base em equipamentos lentos; --modelo medium se o áudio for difícil.
• --max-fotogramas 40 para vídeos longos.
• --sem-transcricao se precisar apenas do visual.

Se falhar:

• ffmpeg não encontrado → peça para instalá-lo (https://ffmpeg.org/download.html) ou trabalhe com o resumo do usuário.
• Sem motor de transcrição → o script informa em info.json. Continue com os fotogramas e peça ao usuário um resumo do que é dito, ou sugira pip install faster-whisper.
• Transcrever demora (a primeira vez baixa o modelo) → execute em segundo plano se seu ambiente permitir.

2. Revisar a saída

• info.json: duração, resolução, orientação, áudio, lista de fotogramas e status da transcrição.
• fotogramas/*.jpg: veja todos, em ordem. O nome contém o tempo (f03_00-12.jpg = segundo 12).
• transcricao.txt: o que é dito, com tempos. transcricao.srt: pronto para enviar como legendas.

Se um trecho importante ficar sem fotograma (uma mudança brusca entre dois), extraia um extra:

ffmpeg -v error -ss 00:00:15 -i "VIDEO.mp4" -frames:v 1 extra_00-15.jpg

3. Relatório

Entregue este relatório, curto e concreto:

## Análise do vídeo

**Ficha técnica:** 0:42 · vertical 1080x1920 · 60 fps · com áudio · idioma: português

**Do que se trata:** <2-3 linhas>

**O que se vê, por trechos**
- 00:00-00:05: …
- 00:05-00:18: …

**O que se diz:** <resumo; citações textuais curtas das frases-chave>

**Tema / jogo detectado:** <nome> (certo / provável / não identificado; por quê)

**Melhor momento para o hook:** <segundo e por quê>. O vídeo começa com ele? Se não, sugira cortar.

**Fotograma recomendado para capa:** <arquivo e segundo>

**Capítulos sugeridos** (apenas vídeos longos, mínimo 3, cada um ≥10 s):
00:00 …

**Palavras-chave detectadas:** <ditas ou vistas na tela>

**Alertas**
- Música comercial ou áudio de terceiros → risco de Content ID ou silenciamento
- Marcas ou produtos visíveis → patrocínio?
- Conteúdo sensível (violência gráfica, linguagem forte) → restrição de idade
- Pessoas ou cenas que pareçam alteradas com IA → etiqueta de IA
- Texto ou elementos importantes em zonas cobertas pela interface (vertical: cima, baixo, lado direito)
- Legendas já queimadas no vídeo → não ativar legendas automáticas que se sobreponham (Facebook)
- Rótulos ou textos na tela que prometem algo que o vídeo não cumpre
- Cortes, telas pretas ou perda de captura
- Qualidade: áudio baixo ou saturado, imagem borrada, início lento

**O que não fica claro para o espectador:** <contexto que falta; o que explicar na descrição>

**Recomendações:** <2-4 ações concretas>

Regras

• Descreva o que vê e ouve, não o que supõe. Se algo for incerto, diga ("parece ser…").
• Se o usuário forneceu um resumo, compare com o que encontrou. Se houver contradição, pergunte.
• Whisper escreve mal nomes próprios (classes, personagens, jargão). Corrija-os com o que se vê na tela e não os copie errado para a descrição.
• Identificar o jogo: observe a interface (HUD), menus, logos e nomes na tela. Se não tiver certeza, pergunte.
• Não identifique pessoas reais pelo rosto. Use apenas nomes que apareçam na tela, no áudio ou que o usuário forneça.
• A pasta de análise fica no computador do usuário. Ao finalizar, informe onde está e que pode excluí-la.