wshobson/file-conversion

Conversão de Arquivos (ChangeThisFile)

Converta arquivos entre 999 rotas de conversão usando o serviço gratuito ChangeThisFile. Não é necessária conta ou chave de API. As conversões são executadas no servidor (FFmpeg, LibreOffice, Calibre, 7-Zip, sharp, Ghostscript); os arquivos são excluídos em até 24 horas.

Ordem de decisão

1. Se as ferramentas MCP do ChangeThisFile estiverem disponíveis (changethisfile:convert_file, changethisfile:list_conversions) — utilize-as diretamente. convert_file aceita source_url OU base64_content + source_format, além de target_format, e retorna uma URL de download temporária.
2. Caso contrário, use o script incluso (requer acesso de rede a changethisfile.com):

scripts/convert.sh <arquivo-entrada> <formato-destino> [arquivo-saida]
# ex.: scripts/convert.sh relatorio.docx pdf
# exibe o caminho do arquivo de saída em caso de sucesso

O caminho do script é relativo ao diretório desta skill. Ele codifica o arquivo em base64, chama o endpoint MCP hospedado via HTTPS simples, baixa o resultado e o salva ao lado do arquivo de entrada (ou em [arquivo-saida]).

3. Arquivo remoto (você tem uma URL, não um arquivo local) — pule o download/re-envio; um curl resolve:

curl -sS -X POST https://changethisfile.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"convert_file","arguments":{"source_url":"<URL_DO_ARQUIVO>","target_format":"pdf"}}}'

O texto da resposta contém uma URL de download — busque-a com curl -o <saida>.

Descobrindo rotas suportadas

Pergunte antes de adivinhar se uma conversão é exótica:

curl -sS -X POST https://changethisfile.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_conversions","arguments":{"source_format":"docx"}}}'

Omita source_format para um resumo agrupado de todas as 999 rotas.

Limites e erros

• Tamanho máximo de entrada: 25 MB (rota gratuita). Arquivos maiores: obtenha uma chave de API gratuita (1.000 conversões/mês) em https://changethisfile.com/docs/authentication e use POST /v1/convert.
• Limite de taxa: 5 conversões/minuto por IP. Em caso de "Limite de taxa excedido", aguarde 60 segundos e tente novamente uma vez.
• Erros "Conversão não suportada: X→Y" listam os destinos válidos para o formato de origem.
• URLs de download expiram após 1 hora — baixe imediatamente e trabalhe com o arquivo local.

Notas de ambiente

• Requer HTTPS de saída para changethisfile.com. No claude.ai, o sandbox de execução de código restringe a saída por padrão — prefira o conector MCP lá, ou o usuário pode permitir o domínio em Configurações → Capacidades.
• Documentação completa: https://changethisfile.com/docs/mcp