wshobson/file-conversion

Dateikonvertierung (ChangeThisFile)

Konvertiere Dateien zwischen 999 Konvertierungsrouten mit dem kostenlosen ChangeThisFile-Dienst. Kein Account oder API-Key erforderlich. Konvertierungen laufen serverseitig (FFmpeg, LibreOffice, Calibre, 7-Zip, sharp, Ghostscript); Dateien werden innerhalb von 24 Stunden gelöscht.

Entscheidungsreihenfolge

1. Wenn ChangeThisFile MCP-Tools verfügbar sind (changethisfile:convert_file, changethisfile:list_conversions) – verwende sie direkt. convert_file erwartet source_url ODER base64_content + source_format, plus target_format und gibt eine temporäre Download-URL zurück.
2. Andernfalls verwende das gebündelte Skript (erfordert Netzwerkzugriff auf changethisfile.com):

scripts/convert.sh <input-datei> <ziel-format> [output-datei]
# z. B. scripts/convert.sh report.docx pdf
# gibt bei Erfolg den Pfad zur Ausgabedatei aus

Der Skriptpfad ist relativ zum Verzeichnis dieses Skills. Es kodiert die Datei base64, ruft den gehosteten MCP-Endpoint über einfaches HTTPS auf, lädt das Ergebnis herunter und schreibt es neben die Eingabedatei (oder in [output-datei]).

3. Remote-Datei (du hast eine URL, keine lokale Datei) – überspringe das Herunterladen/Neu-Hochladen; ein curl reicht:

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

Die Antwort enthält eine Download-URL – lade sie mit curl -o <output> herunter.

Unterstützte Routen ermitteln

Frage nach, bevor du direkt eine exotische Konvertierung durchführst:

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"}}}'

Lasse source_format weg, um eine gruppierte Zusammenfassung aller 999 Routen zu erhalten.

Grenzen und Fehler

• Maximale Eingabe: 25 MB (kostenloser Pfad). Größere Dateien: Besorge einen kostenlosen API-Key (1.000 Konvertierungen/Monat) unter https://changethisfile.com/docs/authentication und verwende POST /v1/convert.
• Ratenlimit: 5 Konvertierungen/Minute pro IP. Bei „Rate limit exceeded“ 60 Sekunden warten und einmal wiederholen.
• „Unsupported conversion: X→Y“-Fehler zeigen die gültigen Ziele für das Quellformat an.
• Download-URLs verfallen nach 1 Stunde – lade sofort herunter und arbeite dann mit der lokalen Datei.

Hinweise zur Umgebung

• Benötigt ausgehendes HTTPS zu changethisfile.com. Auf claude.ai schränkt die Code-Ausführungs-Sandbox standardmäßig den Egress ein – bevorzuge dort den MCP-Connector, oder der Benutzer kann die Domain unter Settings → Capabilities erlauben.
• Vollständige Dokumentation: https://changethisfile.com/docs/mcp