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/brunojanvier77/ContentaSoft

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. Lo trovi in C:\Program Files\ContentaSoft\VideoRecompress Studio PREMIUM\; aggiungi quella cartella al PATH ed è disponibile da qualsiasi 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 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

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.

Attenzione ai flag preset. --preset-id phone_archive seleziona un preset di workflow con nome (codec, CRF e profilo di risparmio). --preset medium imposta la velocità del codificatore (da ultrafast a veryslow). Sembrano simili ma fanno cose completamente diverse — usa --preset-id per i preset di workflow e --preset solo per regolare la velocità del codificatore.

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-id 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 --folder 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, c'è una strada ancora più breve: la skill /contenta-video insegna all'agente l'intera CLI — comandi, preset, accelerazione hardware e ricette comuni. Installala clonando il repository pubblico e copiando le skill:

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

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 riferimento completo vive in un repository GitHub pubblico: documentazione CLI accurata per ogni comando e opzione, il riferimento completo del server MCP con tutti e 5 gli strumenti, e le skill installabili per Claude Code per VideoRecompress Studio e gli altri prodotti ContentaSoft. github.com/brunojanvier77/ContentaSoft

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

La CLI costa qualcosa in più?

No. La CLI, il server MCP e la skill per Claude Code arrivano nello stesso installer dell'app desktop e sono coperti dalla stessa licenza una tantum di $79. Non c'è nulla da acquistare o scaricare a parte.

Funziona durante la prova gratuita?

Sì. La prova gratuita di 30 giorni copre anche la CLI e il server MCP. I primi 10 file vengono ricompressi puliti; dopo, l'output porta una piccola filigrana ed è tagliato ai primi 10 minuti finché non ti registri con videorecompress register.

Posso usarla in script e pipeline CI?

È costruita esattamente per questo. Ogni comando supporta --json per un output strutturato e restituisce codici di uscita significativi (0 successo, 3 licenza richiesta, 5 file non trovato, e così via), quindi gli errori sono facili da rilevare e gestire.

Un solo installer. GUI, CLI, MCP e skill.

Scrivi lo script del tuo primo blocco in cinque minuti: la CLI è inclusa nell'app, nessun download separato. Prova gratuita di 30 giorni: i primi 10 file vengono convertiti senza filigrana; dopo, i file ricevono una filigrana e un limite di 10 minuti. L'acquisto rimuove entrambi.

Scarica la prova gratuita