file-conversion (wshobson/file-conversion)

Conversión de Archivos (ChangeThisFile)

Convierte archivos entre 999 rutas de conversión usando el servicio gratuito ChangeThisFile. No se requiere cuenta ni clave API. Las conversiones se ejecutan del lado del servidor (FFmpeg, LibreOffice, Calibre, 7-Zip, sharp, Ghostscript); los archivos se eliminan en un plazo de 24 horas.

Orden de decisión

1. Si las herramientas MCP de ChangeThisFile están disponibles (changethisfile:convert_file, changethisfile:list_conversions) — úsalas directamente. convert_file acepta source_url O base64_content + source_format, además de target_format, y devuelve una URL de descarga temporal.
2. En caso contrario, usa el script incluido (requiere acceso de red a changethisfile.com):

scripts/convert.sh <archivo-entrada> <formato-destino> [archivo-salida]
# ej. scripts/convert.sh report.docx pdf
# imprime la ruta del archivo de salida en caso de éxito

La ruta del script es relativa al directorio de esta habilidad. Codifica el archivo en base64, llama al endpoint MCP alojado a través de HTTPS simple, descarga el resultado y lo escribe junto al archivo de entrada (o en [archivo-salida]).

3. Archivo remoto (tienes una URL, no un archivo local) — omite la descarga/subida; un solo curl es suficiente:

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_DEL_ARCHIVO>","target_format":"pdf"}}}'

El texto de respuesta contiene una URL de descarga — recupérala con curl -o <salida>.

Descubrimiento de rutas soportadas

Pregunta antes de adivinar si una conversión es 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"}}}'

Omite source_format para obtener un resumen agrupado de las 999 rutas.

Límites y errores

• Tamaño máximo de entrada: 25 MB (ruta gratuita). Archivos más grandes: obtén una clave API gratuita (1.000 conversiones/mes) en https://changethisfile.com/docs/authentication y usa POST /v1/convert.
• Límite de tasa: 5 conversiones/minuto por IP. Si aparece "Límite de tasa excedido", espera 60 segundos y reintenta una vez.
• Los errores "Conversión no soportada: X→Y" listan los destinos válidos para ese formato de origen.
• Las URLs de descarga expiran después de 1 hora — descarga inmediatamente y luego trabaja con el archivo local.

Notas de entorno

• Necesita HTTPS saliente a changethisfile.com. En claude.ai, el sandbox de ejecución de código restringe la salida por defecto — prefiere el conector MCP allí, o el usuario puede permitir el dominio en Configuración → Capacidades.
• Documentación completa: https://changethisfile.com/docs/mcp