Automatice la compresión de vídeo con la CLI, el servidor MCP y agentes de IA

2 de julio de 2026 • VideoRecompress Studio Team

La mayoría conoce VideoRecompress Studio por su asistente de Windows: arrastra una carpeta de vídeos, elige un preset y pulsa Iniciar. Pero el asistente es solo una forma de manejarlo. El mismo motor de compresión — H.264, H.265, AV1, VP9, codificación por hardware GPU — también incluye una interfaz de línea de comandos completa llamada videorecompress, un servidor MCP integrado y una skill instalable de Claude Code.

Este artículo recorre las tres capas: crear scripts con la CLI videorecompress, conectar el servidor MCP a Claude Desktop o Claude Code, y dejar que un agente de IA ejecute su pipeline de compresión a partir de una petición en lenguaje natural. La referencia completa de CLI y MCP está en el repositorio público de GitHub en github.com/contentasoftware/videorecompress-studio-plugin

Tres formas de automatizar

• Línea de comandos

  Scripts, tareas programadas y ejecuciones por lotes.

• Servidor MCP

  Los agentes de IA usan VideoRecompress como herramienta.

• Skill de Claude Code

  Claude Code aprende los comandos desde tu carpeta de skills.

La CLI videorecompress: el mismo motor, en scripts

El ejecutable se llama videorecompress y se instala junto con la aplicación de escritorio — mismo instalador, misma licencia. Una instalación por defecto lo coloca en %LOCALAPPDATA%\Programs\VideoRecompressStudio\ y añade esa carpeta a su PATH, así que videorecompress funciona desde cualquier terminal nuevo.

Ofrece 9 comandos: analyze, recompress, batch, presets, profile, watch, status, register y serve. Analice un archivo, recomprima con códec y CRF, o procese carpetas enteras por lotes — todo en una línea:

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 los comandos aceptan --json para salida legible por máquina (JSON o NDJSON para el progreso por lotes) y devuelven códigos de salida correctos, así que la CLI encaja limpiamente en scripts de PowerShell, pipelines de bash, trabajos de CI y tareas programadas.

Dos opciones de preajuste. --preset phone_archive elige un preajuste con nombre (códec, CRF y ahorro esperado). --encoder-preset medium fija la velocidad del codificador (de ultrafast a veryslow). Use --preset para los preajustes con nombre y --encoder-preset solo para ajustar la velocidad del codificador.

Recetas de automatización reales

1. El trabajo de archivo programado

Apunte batch a una carpeta de material en bruto y déjelo recomprimir de noche con un preset orientado a la calidad. Un comando convierte el contenido de una tarjeta de memoria en una biblioteca archivada:

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

Prográmelo semanalmente en el Programador de tareas y sus importaciones de cámara se comprimirán automáticamente — archivos originales intactos, archivos H.265 listos para almacenamiento a largo plazo.

2. La carpeta vigilada que trabaja sola

El comando watch vigila una carpeta y recomprime automáticamente cada vídeo nuevo. Inícielo una vez y seguirá funcionando — deje archivos dentro y salen comprimidos:

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

Ejecütelo al iniciar sesión con el Programador de tareas y tendrá un servicio de compresión sin un solo clic: vídeos del móvil, grabaciones de pantalla e importaciones de cámara llegan a la carpeta de entrada, y segundos después aparecen archivos H.265 más pequeños en la de salida.

El servidor MCP: ponga el motor en manos de un agente de IA

MCP (Model Context Protocol) es el estándar abierto que usan los asistentes de IA para invocar herramientas externas. VideoRecompress incluye un servidor MCP integrado — se inicia con un solo comando:

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

Expone 5 herramientas — analizar vídeo, recomprimir un archivo, procesar por lotes, listar presets y estimar ahorro de espacio — y funciona durante la prueba gratuita. Para conectar Claude Desktop, añada esto a su claude_desktop_config.json:

A partir de ahí puede pedirle a su asistente cosas como “recomprime todos los MP4 de mi carpeta Descargas con el preset phone_archive” y llamará directamente al motor local. Sus vídeos nunca salen de su equipo — el agente orquesta, la compresión se ejecuta en local.

Skill de Claude Code: compresión de vídeo en lenguaje natural

Si usa Claude Code, la skill /contenta-video viene incluida en el plugin de VideoRecompress Studio junto con el servidor MCP, así que una sola instalación le da ambos al agente. Dos comandos:

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

En Cursor, Claude Desktop, VS Code o cualquier otro cliente MCP, añada esta entrada de servidor (requiere Node.js 18 o superior):

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

Después, describa el trabajo con sus propias palabras — “recomprime por lotes esta carpeta de boda con máxima calidad” o “vigila mi carpeta de grabaciones de pantalla y comprime los archivos nuevos”. La skill traduce la petición a los comandos videorecompress correctos e informa del resultado.

Todo documentado en GitHub

El código fuente del plugin, la referencia del servidor MCP y la documentación de la CLI están en el repositorio público de GitHub, y el paquete lanzador está publicado en npm: github.com/contentasoftware/videorecompress-studio-plugin · npmjs.com/package/@contentasoft/videorecompress-mcp

La documentación se mantiene junto con el producto, así que lo que lee allí coincide con el binario de su disco. Copie las recetas directamente a sus propios scripts, o abra un issue si encuentra un caso límite.

Preguntas frecuentes