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/contentasoftware/videorecompress-studio-plugin

Três formas de automatizar

• Linha de comandos

  Scripts, tarefas agendadas e execuções em lote.

• Servidor MCP

  Os agentes de IA chamam o VideoRecompress como ferramenta.

• Skill do Claude Code

  O Claude Code aprende os comandos a partir da sua pasta de skills.

A CLI videorecompress: o mesmo motor, em scripts

O executável chama-se videorecompress e é instalado junto com a aplicação de desktop — mesmo instalador, mesma licença. Uma instalação padrão coloca-o em %LOCALAPPDATA%\Programs\VideoRecompressStudio\ e adiciona essa pasta ao PATH, por isso videorecompress funciona em qualquer terminal novo.

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 info video.mp4 --json

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

videorecompress batch ./raw-footage --output ./archived --preset 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.

Duas opções de predefinição. --preset phone_archive escolhe uma predefinição com nome (codec, CRF e economia esperada). --encoder-preset medium define a velocidade do codificador (de ultrafast a veryslow). Use --preset para as predefinições com nome e --encoder-preset apenas para ajustar 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 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 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, a skill /contenta-video vem incluída no plugin VideoRecompress Studio juntamente com o servidor MCP, pelo que uma única instalação dá ambos ao agente. Dois comandos:

/plugin marketplace add contentasoftware/videorecompress-studio-plugin
/plugin install videorecompress-studio@videorecompress-studio-plugin

No Cursor, Claude Desktop, VS Code ou qualquer outro cliente MCP, adicione esta entrada de servidor (requer Node.js 18 ou mais recente):

{
  "mcpServers": {
    "videorecompress-studio": { "command": "cmd", "args": ["/c", "npx", "-y", "@contentasoft/videorecompress-mcp"] }
  }
}

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

O código-fonte do plugin, a referência do servidor MCP e a documentação da CLI estão no repositório público do GitHub, e o pacote de arranque está publicado no npm: github.com/contentasoftware/videorecompress-studio-plugin · npmjs.com/package/@contentasoft/videorecompress-mcp

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