Mídia de vídeo local (MCP)
A VidSeeds.ai segue uma abordagem client-first para mídia: o servidor MCP hospedado não lê arquivos do computador do usuário. As ferramentas retornam receitas (comandos ffmpeg/ffprobe) ou aceitam quadros base64 que o agente extraiu localmente.
Sondar um arquivo
vidseeds_probe_local_video— duração, resolução, codecs; usar antes de cortes ou seleção de quadros para miniaturas.
Quadros e clipes
| Objetivo | Ferramenta |
|---|---|
| Quadros fixos para miniaturas | vidseeds_extract_video_frames |
| Clipe curto para contexto | vidseeds_extract_video_clip |
| Receita genérica de transcodificação | vidseeds_transcode_format_recipe |
| Comandos auxiliares de mídia | vidseeds_get_local_media_recipe |
Execute os comandos shell retornados na máquina do usuário (requer ffmpeg/ffprobe instalados). Passe os resultados de volta para as ferramentas de miniatura como frames em vidseeds_generate_thumbnail quando necessário.
Corte de precisão
vidseeds_analyze_precision_trim— pontos de corte sugeridos, catálogo de segmentos, pré-visualização de custo de semente.vidseeds_plan_precision_trim— plano de edição com IA (CritiquePlan) com processamento consciente do gênero.vidseeds_execute_precision_trim— receita/comandos de exportação para ffmpeg local.
V3 — Processamento Consciente do Gênero (2026-06-27)
O Precision Trim V3 adiciona classificação de gênero + análise de paisagem sonora + perfil de movimento + detecção de ganchos + limites semânticos como sinais opcionais processados no lado do cliente. Estes são passados como metadados opcionais nas entradas de vidseeds_analyze_precision_trim / vidseeds_plan_precision_trim:
detectedGenre— substitui a detecção automática de gênero (speech_driven, action_dynamic, ambient_relax, visual_primary, mixed_narrative, tutorial)soundscape— classificação espectral a partir de PCM (silence/speech/music/ambient/noise)motionProfile— análise de diferença de pixel quadro a quadro (static/slow/action/scene_change)
Como afeta os planos:
- ambient_relax: alta tolerância a silêncio (15s+), preserva cenas sem fala, < 20% de taxa de corte
- action_dynamic: corte agressivo de pausas (500ms+), até 40% de taxa de corte
- speech_driven: corte em limites semânticos, corte moderado
- visual_primary: preserva cenas sem fala, corta apenas em silêncio verdadeiro
- mixed_narrative: usa todos os sinais — corta apenas quando múltiplos concordam
- tutorial: corte de precisão, sem aceleração ao redor de instruções
Posicionamento de midroll
vidseeds_analyze_midroll_opportunities— horários sugeridos de midroll a partir de transcrição/contexto (apenas análise; o usuário edita em seu editor).
Miniaturas a partir de arquivo local
Prefira a ferramenta MCP stdio vidseeds-local vidseeds_generate_thumbnail_from_video quando todo o pipeline deve ser executado no disco (consulte vidseeds-thumbnails).
Fonte hospedada no YouTube (não caminho local)
vidseeds_get_youtube_video_transcript,vidseeds_get_youtube_video_captions— texto do YouTube sem baixar o vídeo para o servidor.
Não fazer
- Esperar que ferramentas hospedadas aceitem caminhos de sistema de arquivos arbitrários para upload/processamento.
- Executar novamente sondagem/extração em loop — armazene em cache os resultados da sondagem para a sessão.