Back to Details

file-conversion

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

File Conversion (ChangeThisFile)

文件格式转换（ChangeThisFile）

Convert files between 999 conversion routes using the free ChangeThisFile service. No account or API key required. Conversions run server-side (FFmpeg, LibreOffice, Calibre, 7-Zip, sharp, Ghostscript); files are deleted within 24 hours.
使用免费的ChangeThisFile服务，在999种转换路径间转换文件。无需账户或API key。转换在服务器端运行（基于FFmpeg、LibreOffice、Calibre、7-Zip、sharp、Ghostscript）；文件会在24小时内删除。

Decision order

决策顺序

  1. If ChangeThisFile MCP tools are available (
    changethisfile:convert_file
    , 
    changethisfile:list_conversions
    ) — use them directly. 
    convert_file
    takes 
    source_url
    OR 
    base64_content
    + 
    source_format
    , plus 
    target_format
    , and returns a temporary download URL.
  2. Otherwise, use the bundled script (requires network access to changethisfile.com):
bash
scripts/convert.sh <input-file> <target-format> [output-file]
  1. 如果ChangeThisFile MCP工具可用（
    changethisfile:convert_file
    、
    changethisfile:list_conversions
    ）——直接使用它们。
    convert_file
    需要
    source_url
    或 
    base64_content
    + 
    source_format
    ，以及
    target_format
    ，返回临时下载链接。
  2. 否则，使用捆绑脚本（需要访问changethisfile.com的网络权限）：
bash
scripts/convert.sh <input-file> <target-format> [output-file]

e.g. scripts/convert.sh report.docx pdf

e.g. scripts/convert.sh report.docx pdf

prints the output file path on success

成功时输出文件路径


The script path is relative to this skill's directory. It base64-encodes the file, calls the hosted MCP endpoint over plain HTTPS, downloads the result, and writes it next to the input (or to `[output-file]`).

3. **Remote file (you have a URL, not a local file)** — skip the download/re-upload; one curl does it:

```bash
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":"<FILE_URL>","target_format":"pdf"}}}'
The response text contains a download URL — fetch it with 
curl -o <output>
.

脚本路径相对于此技能的目录。它会对文件进行base64编码，通过普通HTTPS调用托管的MCP端点，下载结果并写入输入文件所在目录（或指定的`[output-file]`）。

3. **远程文件（仅拥有URL，无本地文件）**——跳过下载/重新上传；一次curl调用即可完成：

```bash
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":"<FILE_URL>","target_format":"pdf"}}}'
响应文本包含下载链接——使用
curl -o <output>
获取文件。

Discovering supported routes

查看支持的转换路径

Ask before guessing if a conversion is exotic:
bash
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"}}}'
Omit 
source_format
for a grouped summary of all 999 routes.
如果转换格式较为特殊，先查询再尝试：
bash
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"}}}'
省略
source_format
可获取所有999种转换路径的分组汇总。

Limits and errors

限制与错误

  • Max input: 25 MB (free path). Larger files: get a free API key (1,000 conversions/month) at https://changethisfile.com/docs/authentication and use 
    POST /v1/convert
    .
  • Rate limit: 5 conversions/minute per IP. On "Rate limit exceeded", wait 60 seconds and retry once.
  • "Unsupported conversion: X→Y" errors list the valid targets for that source format.
  • Download URLs expire after 1 hour — download immediately, then work with the local file.
  • 最大输入文件：25 MB（免费通道）。更大文件：可在https://changethisfile.com/docs/authentication获取免费API key（每月1000次转换），并使用
    POST /v1/convert
    接口。
  • 速率限制：每个IP每分钟5次转换。若出现“Rate limit exceeded”（速率限制超出），等待60秒后重试一次。
  • “Unsupported conversion: X→Y”（不支持的转换：X→Y）错误会列出该源格式支持的目标格式。
  • 下载链接1小时后过期——请立即下载，之后使用本地文件操作。

Environment notes

环境说明

  • Needs outbound HTTPS to 
    changethisfile.com
    . On claude.ai, the code-execution sandbox restricts egress by default — prefer the MCP connector there, or the user can allow the domain under Settings → Capabilities.
  • Full docs: https://changethisfile.com/docs/mcp
  • 需要出站HTTPS访问
    changethisfile.com
    。在claude.ai上，代码执行沙箱默认限制出站流量——优先使用MCP连接器，或用户可在设置→功能中允许该域名。
  • 完整文档：https://changethisfile.com/docs/mcp