Automatize a compressão de vídeo com a CLI, o servidor MCP e agentes de IA

2 de julho de 2026 • VideoRecompress Studio Team

A maioria conhece o VideoRecompress Studio pelo assistente do Windows: arrasta uma pasta de vídeos, escolhe um preset, clica em Iniciar. Mas o assistente é só uma das formas de usá-lo. O mesmo motor de compressão — H.264, H.265, AV1, VP9, codificação por hardware GPU — também é entregue com uma interface de linha de comando completa chamada videorecompress, um servidor MCP integrado e uma skill instalável do Claude Code.

Este artigo percorre as três camadas: criar scripts com a CLI videorecompress, ligar o servidor MCP ao Claude Desktop ou ao Claude Code, e deixar um agente de IA executar o seu pipeline de compressão a partir de um pedido em linguagem natural. A referência completa de CLI e MCP está no repositório público do GitHub em github.com/brunojanvier77/ContentaSoft

A CLI videorecompress: o mesmo motor, em scripts

O executável chama-se videorecompress e é instalado junto com o aplicativo de desktop — mesmo instalador, mesma licença. Encontra-o em C:\Program Files\ContentaSoft\VideoRecompress Studio PREMIUM\; adicione essa pasta ao PATH e ele fica disponível em qualquer terminal.

Ela expõe 9 comandos: analyze, recompress, batch, presets, profile, watch, status, register e serve. Análise um ficheiro, recomprima com codec e CRF, ou processe pastas inteiras em lote — tudo numa linha:

videorecompress analyze video.mp4 --json

videorecompress recompress video.mp4 --output ./compressed --preset-id phone_archive

videorecompress batch ./raw-footage --output ./archived --preset-id wedding_archive --workers 2

Todos os comandos aceitam --json para saída legível por máquina (JSON ou NDJSON para progresso em lote) e devolvem códigos de saída adequados, pelo que a CLI se encaixa perfeitamente em scripts PowerShell, pipelines bash, jobs de CI e tarefas agendadas.

Atenção aos flags de preset. --preset-id phone_archive seleciona um preset de fluxo de trabalho com nome (codec, CRF e perfil de poupança). --preset medium define a velocidade do codificador (de ultrafast a veryslow). Parecem semelhantes mas fazem coisas totalmente diferentes — use --preset-id para presets de fluxo e --preset apenas para afinar a velocidade do codificador.

Receitas de automação reais

1. A tarefa de arquivo agendada

Aponte batch a uma pasta de material bruto e deixe-o recomprimir durante a noite com um preset orientado à qualidade. Um comando transforma o conteúdo de um cartão de memória numa biblioteca arquivada:

videorecompress batch ./raw-footage --output ./archived --preset-id wedding_archive --workers 2

Agende-o semanalmente no Agendador de Tarefas e as suas importações de câmara comprimem-se automaticamente — ficheiros originais intactos, arquivos H.265 prontos para armazenamento a longo prazo.

2. A pasta monitorizada que trabalha sozinha

O comando watch monitoriza uma pasta e recomprime automaticamente cada vídeo novo. Inicie-o uma vez e ele continua a correr — ficheiros entram, ficheiros comprimidos saem:

videorecompress watch --folder C:\Videos --preset phone_archive --output C:\Compressed

Execute-o no logon pelo Agendador de Tarefas e terá um serviço de compressão sem um único clique: vídeos do telemóvel, gravações de ecrã e importações de câmara chegam à pasta de entrada, e segundos depois surgem ficheiros H.265 mais pequenos na de saída.

O servidor MCP: entregue o motor a um agente de IA

MCP (Model Context Protocol) é o padrão aberto que os assistentes de IA usam para chamar ferramentas externas. O VideoRecompress traz um servidor MCP integrado — inicia-o com um único comando:

// claude_desktop_config.json
{
  "mcpServers": {
    "videorecompress": {
      "command": "videorecompress",
      "args": ["serve"]
    }
  }
}

Expõe 5 ferramentas — analisar vídeo, recomprimir um ficheiro, processar em lote, listar presets e estimar poupança de espaço — e funciona durante o teste gratuito. Para ligar o Claude Desktop, adicione isto ao seu claude_desktop_config.json:

A partir daí, pode pedir ao assistente coisas como “recomprime todos os MP4 da minha pasta Transferências com o preset phone_archive” e ele chama o motor local diretamente. Os seus vídeos nunca saem do seu computador — o agente orquestra, a compressão corre localmente.

Skill do Claude Code: compressão de vídeo em linguagem natural

Se usa o Claude Code, há um caminho ainda mais curto: a skill /contenta-video ensina ao agente toda a CLI — comandos, presets, aceleração por hardware e receitas comuns. Instale-a clonando o repositório público e copiando as skills:

git clone https://github.com/brunojanvier77/ContentaSoft.git
cp -r ContentaSoft/skills/* ~/.claude/skills/

Depois, descreva a tarefa com as suas próprias palavras — “recomprime em lote esta pasta do casamento com qualidade máxima” ou “monitoriza a minha pasta de gravações de ecrã e comprime ficheiros novos”. A skill traduz o pedido nos comandos videorecompress certos e reporta o resultado.

Tudo documentado no GitHub

A referência completa vive num repositório público no GitHub: documentação precisa da CLI para cada comando e opção, a referência completa do servidor MCP com as 5 ferramentas, e as skills instaláveis do Claude Code para o VideoRecompress Studio e os demais produtos ContentaSoft. github.com/brunojanvier77/ContentaSoft

A documentação é mantida junto com o produto, pelo que o que lê lá corresponde ao binário no seu disco. Copie as receitas direto para os seus scripts, ou abra uma issue se encontrar um caso extremo.

Perguntas frequentes

A CLI custa algo a mais?

Não. A CLI, o servidor MCP e a skill do Claude Code vêm no mesmo instalador do aplicativo de desktop e são cobertos pela mesma licença única de $79. Não há nada para comprar ou baixar separadamente.

Funciona durante o teste gratuito?

Sim. O teste gratuito de 30 dias também cobre a CLI e o servidor MCP. Os 10 primeiros ficheiros são recomprimidos limpos; depois disso, a saída recebe uma pequena marca d'água e é cortada aos primeiros 10 minutos até se registar com videorecompress register.

Posso usar em scripts e pipelines de CI?

É exatamente para isso que foi feita. Todos os comandos suportam --json para saída estruturada e devolvem códigos de saída significativos (0 sucesso, 3 licença necessária, 5 ficheiro não encontrado, e assim por diante), tornando as falhas fáceis de detectar e tratar.