openclip-transcription

OpenClip: 전사(transcription)

transcribe는 동영상 또는 오디오 파일을 시간 코드가 포함된 텍스트로 변환합니다. 무료이며 OpenClip 계정만 있으면 구독이나 크레딧이 필요 없습니다. 출력 형식: JSON(구조화, 시간 정보 포함), SRT, VTT.

설정 (최초 1회)

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를 호출해 보세요.

작업 흐름

1. 업로드. create_upload(파일명, 콘텐츠_유형)은 id와 upload_url을 반환합니다. upload_url에 원시 바이트를 PUT한 후, 그 id를 video로 전달하세요. complete_upload를 호출하지 마세요. 유료 클리핑 파이프라인이 시작됩니다. 무료 도구는 업로드된 파일을 직접 읽습니다. list_videos에 이미 있는 동영상도 입력으로 사용할 수 있습니다.
2. 전사. transcribe(video, 언어?, 화자_분리?)
   • 언어 - 생략하면 자동 감지됩니다. 이미 언어를 알고 있고 짧거나 잡음이 많은 클립이 잘못 감지되는 것을 막으려면 설정하세요.
   • 화자_분리 - 기본값은 true이며, 누가 말하고 있는지 표시합니다. 단일 화자 오디오의 경우 끄면 출력이 깔끔해집니다.
3. 폴링. tool_job 해시 ID를 반환합니다. 510초마다 get_tool_job_status(tool_job)을 폴링하세요. queued / processing은 진행 중, completed는 영구 CDN outputs URL(형식별: json, srt, vtt)을 반환, failed는 error를 반환합니다. 대부분의 작업은 12분 내에 완료됩니다.
4. 출력 읽기. 프로그램 작업에는 JSON 출력(시작 및 종료 시간, 화자 레이블이 있는 세그먼트)을 가져오세요. 사용자가 자막 파일을 원하면 SRT 또는 VTT URL을 건네주세요.

두 가지 다른 전사 도구

이것들을 혼동하지 마세요:

• transcribe - 무료 도구. 업로드한 모든 파일에서 작동합니다. 이 스킬입니다.
• get_transcript - 이미 유료 클리핑 파이프라인을 거친 동영상의 자막을 읽습니다. 문장 또는 단어 수준에서 start_ms / end_ms 윈도우를 지원합니다. 이미 클리핑 job_id가 있을 때 사용하며, 새 업로드에는 사용하지 마세요.

규칙

• 항상 폴링하세요. 전사는 비동기식이며 텍스트를 동기적으로 반환하지 않습니다.
• 시간은 밀리초 단위입니다.
• 출력 URL은 서명이 없거나 만료되지 않는 영구 CDN 링크입니다.
• 무료 사용은 하루에 파일당 크기 제한과 함께 속도 제한이 있습니다. 오류 텍스트에 제한 해제 방법이 설명되어 있습니다.

예시 프롬프트 → 동작

• "이 인터뷰를 받아적어 줘" - create_upload, PUT 바이트, transcribe(video), 폴링, 자막 반환.
• "이 동영상의 SRT가 필요해" - 동일한 과정, 그런 다음 srt 출력 URL을 건네줍니다.
• "이 회의 녹음에서 누가 뭐라고 했어?" - transcribe(video, diarize=true), 폴링, JSON 출력을 읽고 세그먼트를 화자별로 그룹화합니다.
• "이 강연에서 가장 좋은 인용문을 뽑아줘" - 전사, 폴링, JSON 읽기, 그런 다음 시간 코드와 함께 인용문을 선택합니다.
• "네덜란드어로 되어 있어, 받아적어 줘" - transcribe(video, language="nl"), 폴링.

관련 도구

그런 다음 해당 시간 코드로 동영상을 자르려면 openclip-video-editing (edit_video with operation="trim")을 참조하세요. 자동으로 자를 가치가 있는 순간을 찾으려면 openclip-clipping을 참조하세요.