파일 변환 (ChangeThisFile)
무료 ChangeThisFile 서비스를 사용하여 999개의 변환 경로로 파일을 변환합니다. 계정이나 API 키가 필요 없습니다. 변환은 서버 측에서 실행됩니다(FFmpeg, LibreOffice, Calibre, 7-Zip, sharp, Ghostscript). 파일은 24시간 이내에 삭제됩니다.
결정 순서
- ChangeThisFile MCP 도구를 사용할 수 있는 경우 (
changethisfile:convert_file,changethisfile:list_conversions) — 직접 사용합니다.convert_file은source_url또는base64_content+source_format와target_format을 인자로 받아 임시 다운로드 URL을 반환합니다. - 그렇지 않은 경우, 번들 스크립트를 사용합니다 (changethisfile.com에 대한 네트워크 접근 필요):
scripts/convert.sh <input-file> <target-format> [output-file]
# 예: scripts/convert.sh report.docx pdf
# 성공 시 출력 파일 경로를 출력합니다
스크립트 경로는 이 스킬의 디렉터리를 기준으로 합니다. 파일을 base64로 인코딩하고, 호스팅된 MCP 엔드포인트를 일반 HTTPS로 호출하여 결과를 다운로드한 후 입력 파일 옆에 (또는 [output-file]에) 씁니다.
- 원격 파일 (로컬 파일이 아닌 URL) — 다운로드/재업로드 과정 없이 한 번의 curl로 처리합니다:
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"}}}'
응답 텍스트에는 다운로드 URL이 포함되어 있습니다. curl -o <output> 명령으로 받아옵니다.
지원 경로 확인
변환이 생소한 경우 추측하기 전에 먼저 질문하세요:
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개 경로에 대한 그룹화된 요약을 얻을 수 있습니다.
제한 사항 및 오류
- 최대 입력 크기: 25MB (무료 경로). 더 큰 파일은 https://changethisfile.com/docs/authentication 에서 무료 API 키를 받아(월 1,000회 변환)
POST /v1/convert를 사용하세요. - 속도 제한: IP당 분당 5회 변환. "Rate limit exceeded" 오류 발생 시 60초 대기 후 한 번 재시도하세요.
- "Unsupported conversion: X→Y" 오류는 해당 소스 형식에 유효한 대상 형식 목록을 표시합니다.
- 다운로드 URL은 1시간 후 만료됩니다. 즉시 다운로드한 후 로컬 파일로 작업하세요.
환경 참고 사항
changethisfile.com으로의 아웃바운드 HTTPS가 필요합니다. claude.ai에서는 코드 실행 샌드박스가 기본적으로 외부 전송을 제한하므로, MCP 커넥터를 사용하는 것이 좋습니다. 또는 사용자가 설정(Settings) → 기능(Capabilities)에서 해당 도메인을 허용할 수 있습니다.- 전체 문서: https://changethisfile.com/docs/mcp