OpenClip: 긴 영상을 콘텐츠 배치로 재구성하기

이것은 종합 워크플로우 스킬입니다. 하나의 긴 동영상을 입력하면, 게시 준비가 완료된 여러 개의 세로 클립(각각 캡션과 카피 포함)이 출력됩니다. 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 / web: 설정 → 커넥터 → "사용자 지정 커넥터 추가" → URL을 붙여넣고 로그인합니다.
Cursor (.cursor/mcp.json): { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
헤더 전용 클라이언트: openclip.app/settings/connect에서 MCP 토큰을 발급받고 Authorization: Bearer <토큰> 헤더와 함께 https://openclip.app/mcp/key에 연결합니다.

정상 작동 확인: get_account를 호출하여 credits_remaining > 0인지 확인합니다.

워크플로우

시작하기 전에, 사용자와 두 가지를 합의하세요: 원하는 클립 수와 대상 플랫폼. 이 두 답변이 아래의 모든 결정을 좌우합니다. 사용자 몰래 선택하지 마세요.

소스 제출: submit_video(url) 호출. job_id와 상태 queued를 반환합니다. 로컬 파일인 경우: create_upload, PUT으로 바이너리 전송, complete_upload.
완료까지 폴링: completed 상태가 될 때까지 get_video_status(job_id)를 호출합니다. 거의 즉시 failed가 뜨면 활성 구독이 없는 것입니다. pending_credits는 크레딧이 부족하다는 의미입니다. 이 경우 명확히 말하고 중단하세요. 터미널 상태를 계속 폴링하지 마세요.
모멘트 가져오기: list_clips(job_id) 호출. virality_score (0~10) 기준으로 내림차순 정렬하여 사용자가 요청한 개수만큼 가져옵니다. 렌더링 전에 제목, 후크, 길이, 점수와 함께 후보 목록을 사용자에게 보여주고 거부권을 행사할 기회를 주세요. 렌더링에는 크레딧이 소모됩니다.
각 선택 항목에 캡션 입히기: list_caption_presets를 호출한 다음, 승인된 각 모멘트에 대해 render_clip(moment_id, caption_preset)을 호출합니다. 모든 모멘트에 rendered_clip이 생길 때까지 list_clips를 폴링합니다.
필요 시 리프레이밍: 파이프라인 출력은 이미 숏폼 지향적입니다. 특정 플랫폼에 대해 다른 종횡비가 필요하다면 렌더링된 클립에 대해 무료 edit_video(video, operation="crop", aspect="9:16" | "1:1" | "4:5")를 실행하세요.
배치 전달: 각 클립에 대해 다음 정보를 제공하세요: rendered_clip URL, title, hook, social_copy, duration_ms, virality_score, 그리고 추천 platforms 필드.

플랫폼 형태

TikTok, Reels, Shorts - 9:16 세로. 기본값이며 파이프라인이 이를 대상으로 합니다.
Instagram 피드 - 4:5 또는 1:1. edit_video로 렌더링된 클립을 자릅니다.
X 및 LinkedIn - 16:9 또는 1:1 모두 작동합니다. 캡션이 종횡비보다 중요합니다. 대부분 음소거 상태로 자동 재생됩니다.

각 모멘트는 파이프라인에서 생성된 platforms 필드를 가지고 있습니다. 이를 절대적인 규칙이 아닌 시작 제안으로 사용하고, 사용자가 실제로 게시하는 플랫폼과 조정하세요.

시퀀싱 및 비용

폴링은 배치로 처리하세요. 한 번 제출한 후, 다시 제출하지 말고 루프에서 get_video_status를 폴링하세요.
승인된 모멘트만 렌더링하세요. 모든 render_clip은 작업입니다. 사용자가 3개를 원하는데 10개 모두 렌더링하지 마세요.
반복 워크플로우 (매번 동일한 캡션, 동일한 구성, 동일한 로고 워터마크)의 경우 create_agent로 처리 에이전트를 저장하고 submit_video에 전달하세요. 그러면 매번 재지정할 필요 없이 향후 모든 배치가 동일해집니다. describe_agent_settings는 모든 필드를 보여줍니다.
큰 배치를 시작하기 전에 get_usage로 크레딧 잔액(크레딧은 처리 시간(분) 단위)을 확인하세요. 사용자가 많은 수의 클립을 요청할 때 확인하세요.

규칙

항상 폴링하세요. 모든 단계가 비동기입니다.
virality_score 기준으로 순위를 매기고, 높을수록 좋습니다. viral_score_details (후크 강도, 공유 가능성, 재시청 가능성, 놀라움, 감정적 영향)로 순위를 설명하세요.
시간 단위는 밀리초(ms)입니다.
클립 URL은 서명이나 만료가 없는 영구 CDN 링크입니다.
프로젝트와 폴더는 지원되지 않습니다. 사용자에게 폴더 구조를 약속하지 마세요.
요청하지 않는 한 social_copy를 인플루언서 말투로 다시 작성하지 마세요. 이는 클립에 맞게 생성된 것이며, 무리하게 다시 작성하면 대부분 더 나빠집니다.

예시 프롬프트 → 실행

"이 팟캐스트를 TikTok 10개로 만들어 줘" → 제출, 폴링, list_clips, 상위 10개 후보 표시, 승인, 각각 캡션 렌더링, 폴링, 배치 전달.
"이 웨비나로 일주일치 콘텐츠를 만들어 줘" → 동일하게, 5~7개 클립으로 조정하고 각 모멘트의 category를 기준으로 테마별로 그룹화.
"가장 좋은 거 하나만, MrBeast 스타일 캡션으로" → 제출, 폴링, 최고 virality_score 선택, render_clip(moment_id, caption_preset="beast"), 폴링.
"지난번과 동일한 스타일로" → submit_video에 저장된 에이전트 ID를 재사용.

openclip-repurpose