Automatize a conversão de imagens com a CLI Contenta, o servidor MCP e agentes de IA

Publicado em 2 de julho de 2026 · 9 min de leitura

A maioria das pessoas conhece o Contenta Converter pelo assistente do Windows: arrasta uma pasta de fotos, escolhe um formato, clica em converter. Mas o assistente é só uma das formas de usá-lo. Exatamente o mesmo motor de conversão — mais de 50 formatos, RAW de 600+ câmeras, redimensionamento, efeitos — também é entregue com uma interface de linha de comando completa, um servidor MCP integrado e skills prontas para agentes de programação com IA.

Este artigo percorre as três camadas: criar scripts com a CLI contenta, ligar o servidor MCP ao Claude Desktop ou ao Claude Code, e deixar um agente de IA executar toda a sua pipeline de imagens a partir de um pedido em linguagem natural. Tudo o que aparece aqui vem no instalador padrão — sem download separado, sem licença extra.

A CLI contenta: o mesmo motor, em scripts

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

Ela expõe 13 comandos: convert, batch, info, effects, formats, pdf-album, slideshow, ai-transform, watch, profile, register, status e serve. As entradas são posicionais — você aponta um comando para um arquivo ou pasta e adiciona opções. Converter um RAW da Canon em um JPEG de alta qualidade é uma linha:

contenta convert photo.cr2 --format jpg --quality 92

O processamento em lote funciona da mesma forma — aponte para uma pasta. Isto redimensiona um diretório inteiro de fotos de produto para caber em 2000 × 2000 pixels e as salva como JPEG:

contenta batch ./photos --output ./ready --format jpg --resize 2000x2000 --resize-mode fit

Todos os comandos aceitam --json para saída legível por máquina e devolvem códigos de saída adequados, então a CLI se encaixa perfeitamente em scripts PowerShell, pipelines bash, jobs de CI e tarefas agendadas.

Receitas de automação reais

Dois padrões cobrem a maior parte do que nossos usuários automatizam. Ambos rodam sem supervisão depois de configurados.

1. A pasta monitorada que trabalha sozinha

O comando watch monitora uma pasta e converte automaticamente cada imagem nova ou alterada. Inicie-o uma vez e ele continua rodando — arquivos entram, arquivos convertidos saem:

contenta watch ./incoming --output ./processed --format webp

Execute-o no logon pelo Agendador de Tarefas e você terá um serviço de conversão sem nenhum clique: digitalizações, fotos do celular e importações da câmera chegam à pasta de entrada, e segundos depois surgem WebP prontos para a web na pasta de saída.

2. A pipeline de redimensionamento para e-commerce

Os marketplaces são rigorosos com as dimensões — a Amazon, por exemplo, exige fotos de produto em uma tela de 2000 × 2000. Um único comando batch transforma o despejo de um cartão de memória em uma pasta pronta para upload:

contenta batch ./photos --output ./ready --format jpg --resize 2000x2000 --resize-mode fit

Embrulhe-o em um script de duas linhas e cada nova sessão de fotos de produto vai da câmera ao marketplace com um único comando — arquivos RAW incluídos, já que o motor decodifica nativamente mais de 600 formatos de câmera.

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 Contenta Converter traz um servidor MCP integrado — você o inicia com um único comando:

contenta serve

Ele expõe 10 ferramentas — conversão individual e em lote, detecção de formato, leitura e escrita de metadados, remoção de fundo com IA, álbuns PDF, slideshows e mais — e funciona durante o teste gratuito. Para conectar o Claude Desktop, adicione isto ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "contenta": {
      "command": "C:\\Program Files\\ContentaSoft\\Contenta Converter PREMIUM\\contenta.exe",
      "args": ["serve"]
    }
  }
}

A partir daí, você pode pedir ao assistente coisas como “converta todos os HEIC da minha pasta Downloads para JPEG” e ele chama o motor local diretamente. Suas imagens nunca saem da sua máquina — o agente orquestra, a conversão roda localmente.

Skills do Claude Code: processamento de imagens em linguagem natural

Se você usa o Claude Code, há um caminho ainda mais curto: a skill /contenta-image-processing ensina ao agente toda a CLI — comandos, opções, tamanhos por plataforma e receitas comuns. Instale-a clonando o repositório público e copiando as skills:

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

Depois, descreva a tarefa com suas próprias palavras:

• “Redimensione todas as fotos desta pasta para a Amazon e a Etsy”
• “Converta estes arquivos CR2 para JPEG com 92% de qualidade”

A skill traduz o pedido nos comandos contenta certos, executa-os, verifica os códigos de saída e reporta o resultado. Você revisa o plano; o agente digita.

Tudo documentado no GitHub

A referência completa vive em um 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 10 ferramentas, e as skills instaláveis do Claude Code para o Contenta Converter e os demais produtos ContentaSoft.

github.com/brunojanvier77/ContentaSoft

A documentação é mantida junto com o produto, então o que você 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