name: orcadub-plugin description: OrcaDub 공식 플러그인: @orcadub/MCP + 더빙 스킬을 통한 AI 비디오 더빙. assets/orcadub.png.

모든 비디오를 번역하세요. 목소리는 그대로.

에이전트를 위한 AI 비디오 더빙 — dub-video 스킬, @orcadub/cli 명령줄 도구 구동.

웹사이트 · CLI / 서버 저장소 · API 키 발급받기 · OrcaDub X

모든 에이전트에 비디오를 다른 언어로 대화식으로 더빙할 수 있는 기능을 제공합니다. 파일을 업로드하거나 URL을 전달하고, OrcaRouter 게이트웨이를 통해 orca/dub 모델에 작업을 제출하며, 진행 상황을 확인하고 완료된 MP4를 다운로드합니다.

하나의 도구, 하나의 스킬:

CLI @orcadub/cli — 일회성 명령줄 도구(npx -y @orcadub/cli <하위명령> 또는 미리 빌드된 orcadub 바이너리), 상주 서버가 필요하지 않습니다.
스킬 dub-video — 스킬을 지원하는 에이전트(Claude Code/Desktop, Codex, …)용 일반 SKILL.md 워크플로 가이드로, CLI를 호출합니다: 더빙 시점, 과금 전 필수 매개변수 확인, 폴링 규칙, 다운로드 전 확인.

설치

Claude Code — 원클릭 플러그인 (OrcaDub CLI를 호출하는 스킬):

/plugin marketplace add Continuum-AI-Corp/orcadub-plugin
/plugin install orcadub@orcadub-skills

Codex — 원클릭 플러그인 (OrcaDub CLI를 호출하는 스킬):

codex plugin marketplace add Continuum-AI-Corp/orcadub-plugin
codex plugin add orcadub@orcadub-skills

지원되는 모든 에이전트 — 안내 CLI 설치:

npx -y @orcadub/cli skill install

# 비대화형 예시:
npx -y @orcadub/cli skill install --platform codex --scope global --yes
npx -y @orcadub/cli skill install \
  --platform claude --platform cursor --scope project --yes

설치 프로그램은 기존 에이전트 플랫폼을 감지하고 프로젝트/전역 설치를 36개 플랫폼(Hermes, OpenClaw, Command Code 포함)에서 지원합니다. 이 저장소의 표준 dub-video 스킬을 다운로드하며, 기존 콘텐츠가 다를 경우 보존합니다(--force 옵션이 제공되지 않은 경우). 구조화된 --json 출력을 지원합니다.

수동 설치 대체 방법:

# 스킬 복사 (orcadub/ 폴더에 설치):
cp -r skills/dub-video ~/.claude/skills/orcadub   # Claude Code / Desktop
cp -r skills/dub-video ~/.agents/skills/orcadub   # Codex

# Node가 사용 가능한지 확인하여 스킬이 `npx -y @orcadub/cli`를 실행할 수 있도록 하고
# (또는 미리 빌드된 `orcadub` 바이너리를 PATH에 추가), API 키를 내보냅니다:
export ORCADUB_API_KEY=sk-orca-...

OrcaRouter API 키(sk-orca-...)가 필요합니다. OrcaRouter 콘솔(토큰 관리 페이지)에서 생성하세요. CLI가 인증할 수 있도록 ORCADUB_API_KEY로 내보냅니다. 더빙 작업은 소스 비디오 시간당 요금이 부과됩니다.

사용법

그냥 요청하세요:

이 비디오를 일본어로 더빙해줘: https://www.youtube.com/watch?v=…

dub-video 스킬이 전체 흐름을 처리합니다. 필요한 세부 사항(소스/대상 언어, 소스 파일 또는 URL, 제목)을 확인하고, 작업을 제출하며, 완료될 때까지 폴링한 후 MP4를 로컬에 저장할지 묻습니다.

더빙 옵션

create에는 --source-lang, --target-lang, 소스(upload의 --file-id 또는 원격 --url), 그리고 --video-name(--file-id 사용 시)이 필요합니다. 선택적 전환은 OrcaDub 사이트의 레이블에 매핑되며 반복 가능한 --opt <파라미터>=true 플래그로 전달됩니다:

사이트 레이블	파라미터	사이트 레이블	파라미터
배경 음악 유지	`--opt preserve_bgm=true`	음량 매칭	`--opt loudness_enabled=true`
워터마크 오버레이	`--opt watermark=true`	노래 번역	`--opt song_translation=true`
워터마크/자막 제거 (유료)	`--opt remove_watermark=true`

자세한 내용은 skills/dub-video/SKILL.md를 참조하세요.

구성 요소

구성 요소	기능
CLI `@orcadub/cli`	5개의 하위 명령어: `health`, `upload`, `create`, `get`, `download`
스킬 `dub-video`	에이전트에게 더빙 시점과 업로드 → 생성 → 폴링 → 다운로드 흐름 실행 방법을 가르칩니다 (과금 전 질문, 다운로드 전 확인)

CLI / 바이너리 세부 사항

미리 빌드된 바이너리, Docker 사용법 및 전체 하위 명령어 참조는 orcadub-mcp-server 저장소에 있습니다. 동일한 바이너리는 하위 명령어 없이 호출되면 MCP 서버로 실행되어, 일회성 CLI 대신 상주 MCP 연결을 선호하는 호스트를 지원합니다.

라이선스

MIT

OrcaDub 공식 플러그인