Communitygithub.com

tubecreate/tubecli

보간법을 통해 원본에 박힌 자막을 제거하고, 채널을 분석하며, 승인 기반 재업로드 파이프라인을 제공합니다.

tubecli란 무엇인가요?

Video Studio는 AI 에이전트(Claude Code, Cursor, Codex 등)를 위한 기술 스킬로, 동영상 작업 흐름에서 누락된 세 가지 핵심 기능을 제공합니다: **원본에 박힌 자막(hardsub) 제거**, **YouTube 채널 분석**, **승인 기반 재업로드 파이프라인**입니다. 이 스킬은 `video_studio` 확장으로 이미 설치되어 있을 것으로 가정하며, 다운로드, 자막 추출, 번역, TTS 등 다른 단계는 선택적 확장(video_downloader, subtitle_extractor, tts_vibevoice)으로 처리됩니다. 사용자가 요청한 기능의 확장이 설치되지 않은 경우, 에이전트는 단순히 '할 수 없다'고 말하는 대신 `video_capabilities` 액션을 실행하여 부족한 확장 목록과 Market 설치 경로를 정확히 안내합니다. 주요 기능으로는 `analyze_channel`(채널 분석 및 콘텐츠 제안), `remove_hardsub`(보간법 등 4가지 모드로 자막 제거), `reup_video`(전체 파이프라인을 Codex 태스크로 대기시켜 승인 대기)가 있으며, 모든 작업은 JSON 기반 액션 또는 HTTP API를 통해 수행됩니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/tubecreate/tubecli/tree/HEAD/tubecli/extensions/video_studio

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

🎬 Video Studio

시스템에 아직 없는 세 가지 기능을 추가합니다: 원본에 박힌 자막 제거, 채널 분석, 재업로드 파이프라인. 나머지 단계(동영상 다운로드, 자막 추출, 번역, TTS)는 다른 확장에서 처리합니다. 아래 규칙을 참고하세요.

🛑 중요 규칙: 도구가 없을 때는 "할 수 없습니다"라고 말하지 말고 사용자를 안내하세요

대부분의 동영상 작업 단계는 선택적 확장으로 처리됩니다. 사용자가 설치되지 않은 확장이 필요한 작업을 요청하면:

  1. 절대 "해당 기능이 없습니다"와 같은 일반적인 답변을 하지 마세요.
  2. {"action": "video_capabilities"}를 실행하여 정확한 목록을 가져오세요.
  3. 결과를 그대로 사용자에게 전달하세요. 목록에는 정확히 어떤 확장을 설치해야 하는지, 각각에 대한 설명, **Market(/market)**으로 이동한 후 서버를 재시작해야 한다는 안내가 포함되어 있습니다.

작업 → 필요한 확장:

작업필요한 확장
동영상 다운로드video_downloader
자막 추출 / 번역 / 자막 삽입subtitle_extractor
음성 더빙(TTS)tts_vibevoice
원본 자막 제거 · 채널 분석 · 파이프라인video_studio (이미 설치됨)
전체 재업로드 파이프라인위 4개 모두

📥 video_capabilities — 수행 가능한 작업 확인

{"action": "video_capabilities"}

동영상 관련 요청을 거절하기 전에 먼저 사용하세요.

📥 analyze_channel — 채널 분석 및 콘텐츠 제안

{"action": "analyze_channel", "url": "https://www.youtube.com/@tenkenh"}

결과: 주제, 시청자, 톤, 인기 동영상의 제목 공식, 그리고 5~8개의 새로운 동영상 아이디어와 훅을 반환합니다. 사용자가 "이 채널은 무엇에 관한 채널인가요", *"다음에 어떤 동영상을 만들어야 할까요"*라고 물을 때 사용하세요.

📥 remove_hardsub — 원본에 박힌 자막 제거

{"action": "remove_hardsub", "video_path": "C:/path/video.mp4", "mode": "delogo"}

mode: delogo (기본값 — 주변 테두리에서 보간하여 자막을 제거합니다. 평평한 배경에서는 자국을 남기지 않고 텍스트가 사라집니다), blur, pixel, fill.

📥 reup_video — 전체 파이프라인 실행

{"action": "reup_video", "url": "https://v.douyin.com/xxxx"}

다운로드 → 자막 추출 → 번역 → 원본 자막 마스킹 → 음성 더빙(TTS) → 새 자막 삽입. 승인을 기다리는 Codex 태스크를 생성합니다. 태스크 번호를 사용자에게 알리고 approve <n> 명령어를 상기시키세요. 실행이 완료되었다고 말하지 마세요. 방금 대기열에 추가된 상태일 뿐입니다.

🌐 HTTP API

메서드엔드포인트작업
GET/api/v1/video-studio/capabilities수행 가능/부족한 작업 확인
GET/api/v1/video-studio/capabilities/{job}특정 작업의 세부 정보
POST/api/v1/video-studio/hardsub/detect자막 영역만 감지, 동영상 수정 안 함
POST/api/v1/video-studio/hardsub/remove감지 + 마스킹
POST/api/v1/video-studio/channel/analyze채널 분석
POST/api/v1/video-studio/pipeline/plan파이프라인이 실행할 단계 확인
POST/api/v1/video-studio/pipeline/reup파이프라인을 Codex 태스크로 대기

💡 예시

사용자: "https://www.youtube.com/@abc 이 채널은 어떤 콘텐츠인가요?"

{"action": "analyze_channel", "url": "https://www.youtube.com/@abc"}

사용자: "이 동영상을 베트남어로 재업로드해 주세요 https://v.douyin.com/xxx"

{"action": "reup_video", "url": "https://v.douyin.com/xxx"}

사용자: "이 동영상에서 자막을 추출해 주세요" — 하지만 subtitle_extractor가 설치되지 않은 경우:

{"action": "video_capabilities"}

→ 그런 다음 원본 결과를 사용자에게 전달하여 무엇을 설치해야 하는지 알려주세요.

관련 스킬