openclip-convert

에이전트에서 OpenClip으로 미디어를 변환하고 압축하세요. 비디오를 mp4, webm, mov, mkv 또는 gif로, 오디오를 mp3, aac, wav 또는 flac으로 변환합니다. OpenClip 계정만 있으면 무료로 사용할 수 있으며, 구독이 필요 없습니다. 요청 시 사용하세요.

openclip-convert란 무엇인가요?

이 스킬은 OpenClip의 `convert_media` 도구를 통해 미디어 파일의 컨테이너나 코덱을 변환하는 기능을 제공합니다. 비디오를 여러 형식(mp4, webm, mov, mkv)으로 변환하거나, 비디오에서 오디오만 추출(mp3, aac, wav, flac)할 수 있으며, 비디오를 GIF로 변환할 때는 fps와 width를 조정할 수 있습니다. 파일 업로드는 `create_upload`로 업로드 URL을 받아 바이트 데이터를 PUT한 후 반환된 ID를 사용하며, 변환 작업은 비동기로 진행되므로 결과를 얻기 위해 `get_tool_job_status`로 5~10초 간격으로 폴링해야 합니다. Claude Code, Claude Desktop, Cursor 등 다양한 MCP 지원 클라이언트에서 사용할 수 있으며, OpenClip 계정만 있으면 추가 비용 없이 무료로 사용 가능하지만 일별 요청 제한과 파일 크기 제한이 있습니다.

지원 대상✓Claude Code~Codex CLI✓Cursor

npx skills add https://github.com/OpenClip-App/agent-skills/tree/main/skills/openclip-convert

문서

OpenClip: 미디어 변환

convert_media는 파일의 컨테이너나 코덱을 변경합니다. 비디오를 GIF로 변환하거나 비디오를 오디오만 추출하는 것도 가능합니다. 무료이며, OpenClip 계정이 필요하지만 구독이나 크레딧은 필요하지 않습니다.

설정 (한 번만)

OpenClip은 https://openclip.app/mcp에 위치한 원격 MCP 서버입니다. OAuth 프롬프트가 나타나면 OpenClip 계정으로 로그인하세요. 복사할 API 키는 없습니다.

Claude Code: claude mcp add --transport http openclip https://openclip.app/mcp 실행 후 /mcp로 인증합니다.
Claude Desktop / 웹: 설정, 커넥터, "사용자 지정 커넥터 추가"에서 URL을 붙여넣고 로그인합니다.
Cursor (.cursor/mcp.json): { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
헤더 전용 클라이언트: openclip.app/settings/connect에서 MCP 토큰을 발급받고, Authorization: Bearer <token> 헤더와 함께 https://openclip.app/mcp/key에 연결합니다.

정상 동작 확인: get_account를 호출해 보세요.

파일 가져오기

create_upload(filename, content_type)은 id와 upload_url을 반환합니다.
원시 바이트를 upload_url에 PUT합니다.
반환된 id를 file 인자로 전달합니다.

complete_upload를 호출하지 마세요. 이 함수는 유료 클리핑 파이프라인을 시작합니다. 무료 도구는 업로드된 파일을 직접 읽습니다. 이미 list_videos에 있는 파일도 입력으로 사용할 수 있습니다.

변환 대상

convert_media(file, to, ...params)

비디오 컨테이너 - mp4, webm, mov, mkv. 사용자가 그냥 어디서나 재생되는 파일을 원할 경우 기본값은 mp4입니다.
gif - 선택적 fps (기본값 12) 및 width (기본값 480). 더 부드러운 움직임을 위해 fps를 높이고, 더 선명한 GIF를 위해 width를 높이세요. 둘 다 파일 크기가 크게 증가합니다. GIF는 급격히 커지므로 원본이 긴 경우 먼저 자르세요.
오디오 - mp3, aac, wav, flac. 비디오에서 오디오를 추출할 때 사용합니다. 공유용으로는 mp3, 무손실이 필요한 다른 도구에 입력할 때는 wav 또는 flac을 사용하세요.

파일 크기를 목표로 변환하려면 (형식 변경 대신) edit_video를 operation="compress" (target_mb 또는 crf)와 함께 사용하세요. openclip-video-editing 스킬을 참조하십시오.

폴링

convert_media는 status: "queued" 상태의 tool_job 해시 ID를 반환합니다. 5~10초 간격으로 get_tool_job_status(tool_job)을 폴링하세요:

queued / processing - 아직 작업 중이므로 계속 폴링합니다.
completed - 영구적인 CDN outputs URL과 result_meta를 반환합니다.
failed - error를 반환합니다.

호출이 동기적으로 완료된다고 가정하지 마십시오.

규칙

항상 폴링하세요. 변환은 비동기입니다.
출력 URL은 서명되지 않은 영구적인 CDN 링크입니다.
무료 사용은 일일 요청 제한과 파일별 크기 제한이 있습니다. 오류 텍스트에 제한 해제 방법이 설명되어 있습니다.
긴 비디오를 GIF로 변환하면 매우 큰 파일이 생성됩니다. 먼저 흥미로운 몇 초 부분으로 자른 후 변환하세요.

예시 프롬프트 → 동작

"이걸 mp4로 변환해 줘" - create_upload, 바이트 PUT, convert_media(file, to="mp4"), 폴링.
"이걸 GIF로 만들어 줘" - 먼저 edit_video로 원하는 부분을 자른 후, convert_media(file, to="gif", fps=15, width=640), 폴링.
"오디오만 추출해 줘" - convert_media(file, to="mp3"), 폴링.
"편집용 무손실 오디오가 필요해" - convert_media(file, to="wav"), 폴링.

openclip-convert