renezander030/capcut-cli

해결하는 문제

CapCut과 JianYing 프로젝트는 일반적으로 GUI에서 수동으로 편집됩니다. capcut-cli는 명령줄 인터페이스를 통해 이러한 프로젝트를 프로그래밍 방식으로 생성하고 편집할 수 있는 방법을 제공하여, 공식 API나 실행 중인 서버 없이도 자동화 및 LLM 에이전트와의 통합이 가능하게 합니다.

작동 방식

이 도구는 CapCut/JianYing의 로컬 드래프트 저장소에 직접 작동하며, 프로젝트 데이터를 JSON 파일에 저장합니다. 이 도구는 이러한 JSON 파일을 로드하고, 버전 인식 스키마에 따라 검증한 후 요청된 편집을 적용하고, 변경 사항을 원자적으로 디스크에 다시 씁니다. 이를 통해 생성된 프로젝트는 CapCut/JianYing 애플리케이션 내에서 완전히 편집 가능하게 유지됩니다.

대상 사용자

• AI 에이전트 개발자: 자동 캡션 추가, 자르기, 번역과 같은 동영상 편집 작업을 수행할 수 있는 에이전트를 개발하는 개발자.
• 콘텐츠 제작자: 사운드 없는 부분 기반 자르기, 자막 가져오기와 같은 반복 작업을 자동화하고 싶은 편집자.
• 개발자: JSON 사양에서 프로그래밍 방식으로 동영상 프로젝트 파일을 생성하고 싶은 사람.

주요 기능

• 에이전트 호환: Claude Code 및 Cursor와 같은 에이전트용 "스킬 설치기"를 포함하고 있으며, 더 안전한 AI 검토를 위한 실험적 Wasm 기반의 "보기만 하기, 만지지 않기" 모드도 제공합니다.
• 의존성 없음: MCP 서버, HTTP 데몬, 클라우드 업로드 없이도 독립 실행형 바이너리로 작동합니다.
• 컷과 자막: 사운드 없는 부분 탐지, 장면 전환 탐지, 드래프트의 다국어 번역에 특화된 명령어를 제공합니다.
• 완전 편집 가능: 평탄화된 내보내기와 달리, CapCut 앱에서 수동으로 열고 조정할 수 있는 진짜 프로젝트 파일을 생성합니다.
• 크로스플랫폼: macOS와 Windows에서 CapCut과 JianYing 네임스페이스를 모두 지원합니다.