Automatizza la compressione video con la CLI, il server MCP e gli agenti IA

2 luglio 2026 • VideoRecompress Studio Team

La maggior parte delle persone conosce VideoRecompress Studio tramite la procedura guidata di Windows: trascina una cartella di video, sceglie un preset, clicca Avvia. Ma la procedura guidata è solo uno dei modi per usarlo. Lo stesso motore di compressione — H.264, H.265, AV1, VP9, codifica hardware GPU — viene fornito anche con un'interfaccia a riga di comando completa chiamata videorecompress, un server MCP integrato e una skill installabile per Claude Code.

Questo articolo attraversa tutti e tre i livelli: creare script con la CLI videorecompress, collegare il server MCP a Claude Desktop o Claude Code, e lasciare che un agente IA esegua la pipeline di compressione a partire da una richiesta in linguaggio naturale. La reference completa di CLI e MCP si trova nel repository GitHub pubblico su github.com/contentasoftware/videorecompress-studio-plugin

Tre modi per automatizzare

• Riga di comando

  Script, attività pianificate ed esecuzioni in blocco.

• Server MCP

  Gli agenti IA usano VideoRecompress come strumento.

• Skill per Claude Code

  Claude Code impara i comandi dalla tua cartella skills.

La CLI videorecompress: lo stesso motore, in versione script

L'eseguibile si chiama videorecompress e si installa insieme all'app desktop — stesso installer, stessa licenza. Un'installazione predefinita lo mette in %LOCALAPPDATA%\Programs\VideoRecompressStudio\ e aggiunge quella cartella al PATH, quindi videorecompress funziona da qualsiasi nuovo terminale.

Espone 9 comandi: analyze, recompress, batch, presets, profile, watch, status, register e serve. Analizza un file, ricomprimi con codec e CRF, o elabora intere cartelle in batch — tutto in una riga:

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

Ogni comando accetta --json per un output leggibile dalle macchine (JSON o NDJSON per l'avanzamento batch) e restituisce codici di uscita corretti, così la CLI si inserisce senza attriti in script PowerShell, pipeline bash, job CI e attività pianificate.

Due opzioni di preset. --preset phone_archive sceglie un preset con nome (codec, CRF e risparmio previsto). --encoder-preset medium imposta la velocità dell'encoder (da ultrafast a veryslow). Usa --preset per i preset con nome e --encoder-preset solo per regolare la velocità dell'encoder.

Ricette di automazione reali

1. Il job di archivio pianificato

Punta batch a una cartella di footage grezzo e lascialo ricomprimere di notte con un preset orientato alla qualità. Un comando trasforma il contenuto di una scheda di memoria in una libreria archiviata:

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

Pianificalo settimanalmente in Utilità di pianificazione e le importazioni dalla fotocamera si comprimono automaticamente — file originali intatti, archivi H.265 pronti per la conservazione a lungo termine.

2. La cartella monitorata che lavora da sola

Il comando watch monitora una cartella e ricomprime automaticamente ogni nuovo video. Avvialo una volta e continua a girare — metti dentro i file, escono compressi:

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

Avvialo all'accesso tramite Utilità di pianificazione e avrai un servizio di compressione a zero clic: video dal telefono, registrazioni schermo e importazioni fotocamera arrivano nella cartella di ingresso, e pochi secondi dopo compaiono file H.265 più piccoli in quella di uscita.

Il server MCP: consegna il motore a un agente IA

MCP (Model Context Protocol) è lo standard aperto che gli assistenti IA usano per richiamare strumenti esterni. VideoRecompress include un server MCP integrato — si avvia con un solo comando:

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

Espone 5 strumenti — analizzare video, ricomprimere un file, batch, elencare preset e stimare risparmio di spazio — e funziona già durante la prova gratuita. Per collegare Claude Desktop, aggiungi questo al tuo claude_desktop_config.json:

Da quel momento puoi chiedere al tuo assistente cose come “ricomprimi tutti gli MP4 nella cartella Download con il preset phone_archive” e chiamerà direttamente il motore locale. I tuoi video non lasciano mai il computer — l'agente orchestra, la compressione gira in locale.

Skill Claude Code: compressione video in linguaggio naturale

Se usi Claude Code, la skill /contenta-video è inclusa nel plugin VideoRecompress Studio insieme al server MCP: una sola installazione dà all'agente entrambi. Due comandi:

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

In Cursor, Claude Desktop, VS Code o qualsiasi altro client MCP, aggiungi questa voce server (richiede Node.js 18 o successivo):

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

Poi descrivi il lavoro con parole tue — “ricomprimi in batch questa cartella del matrimonio con qualità massima” o “monitora la mia cartella di registrazioni schermo e comprimi i nuovi file”. La skill traduce la richiesta nei comandi videorecompress giusti e riferisce.

Tutto documentato su GitHub

Il sorgente del plugin, il riferimento del server MCP e la documentazione della CLI sono nel repository GitHub pubblico, e il pacchetto launcher è pubblicato su npm: github.com/contentasoftware/videorecompress-studio-plugin · npmjs.com/package/@contentasoft/videorecompress-mcp

La documentazione è mantenuta insieme al prodotto, quindi ciò che leggi lì corrisponde al binario sul tuo disco. Copia le ricette direttamente nei tuoi script, oppure apri una issue se incontri un caso limite.

Domande frequenti