claude-real-video (crv)의 개요
claude-real-video, 줄여서 crv는 Claude가 영상 파일을 받지 못하기 때문에 만들어졌습니다. yt-dlp로 URL을 내려받거나 로컬 파일을 읽고, ffmpeg로 장면이 바뀔 때마다 프레임을 뽑습니다(초당 최소 1장 포함). 최근 프레임의 슬라이딩 윈도와 비교해 거의 같은 프레임을 버리고, 영상에 자막이 없으면 Whisper로 오디오를 받아씁니다. 출력 폴더에는 프레임, 원본 타임스탬프를 담은 frames.json, 대본, 그리고 모델에게 읽는 방법을 알려주는 MANIFEST.txt가 들어갑니다.
Python 패키지(pip install "claude-real-video[whisper]"), npx skills add로 설치하는 에이전트 skill, Claude Code 플러그인, 로컬 웹 페이지(crv-web), 도구 5개를 갖춘 MCP 서버(crv-mcp)로 제공됩니다. 주된 경로는 skill과 플러그인이므로 MCP 서버가 아니라 이 분류에서 리뷰합니다. Leo Huang이 만들었고 MIT 라이선스이며 GitHub 스타는 약 2,280개입니다. 버전 0.10.7은 2026년 9월 26일에 PyPI에 올라왔습니다. 유료인 crv Pro는 일회성 $29에 카메라 움직임, 감정, 소리 이벤트 분석을 더합니다.
claude-real-video (crv), 쓸 만한 가치가 있습니까?
crv는 화려하지 않은 파이프라인으로 실제 빈틈을 메웁니다. 초당 1프레임 고정 샘플링은 정적인 화면 녹화에서는 컨텍스트를 넘치게 채우고 빠른 컷은 놓칩니다. 장면 전환 감지와 중복 제거를 쓰면 서로 다른 장면을 한 번씩만 보냅니다. README의 예시는 58초짜리 클립으로, 1 fps라면 58프레임이지만 crv는 26프레임을 남기고 --grid로 이를 콘택트 시트 3장에 담습니다. 남은 프레임은 중복 제거와 이름 변경을 거쳐도 원본 타임스탬프를 유지하므로, 모델은 추측하는 대신 'frame_012 @ 00:03:41'처럼 인용할 수 있습니다.
작성자의 측정치를 보면 비용 감을 잡을 수 있습니다. Mac mini M4에서 3분짜리 640x360 영상을 처리했을 때 기본 모드는 23.5초 만에 180프레임 중 170프레임을 남겼고, Anthropic이 공개한 요율로 이미지 토큰 약 52,000개로 추정됩니다. --max-frames 80을 쓰면 약 25,000개로 절반이 됩니다. 이는 작성자의 벤치마크 파일로 직접 보고한 수치이며, 움직임이 많은 영상은 싸지 않다는 점을 보여줍니다. 말하는 사람만 나오는 영상은 잘 줄어들지만 컷이 빠른 릴은 그렇지 않습니다. MCP 서버의 get_transcript는 말만 반환하므로, 프레임이 별 도움이 안 되는 긴 강연에 씁니다.
처리는 로컬에서 이뤄지며, 회의 녹화나 고객 영상에서는 이 점이 중요합니다. 머신 밖으로 나가는 것은 나중에 클라우드 모델에 넘기는 프레임과 텍스트뿐입니다. ~/.crv/memory.db의 로컬 SQLite 색인 덕분에 crv-ask로 이미 본 모든 영상을 검색할 수 있고, CRV_NO_MEMORY=1로 끌 수 있습니다. --cookies와 --cookies-from-browser 옵션은 접근이 제한된 영상을 가져오려고 브라우저의 로그인 쿠키를 읽습니다. 편리하지만 도구가 쓸 수 있는 자격 증명이 되므로 본인 계정에만 쓰는 것이 맞습니다.
한계는 개념적인 것입니다. 모델은 움직임이나 어조가 아니라 정지 화면과 대본을 봅니다. crv Pro의 카메라, 속도감, 감정 분석이 유료 해법이고, 화면 속 텍스트 인식은 $9.90 Codex 빌드에 는 있지만 무료 버전에는 없습니다. Gemini는 영상을 직접 읽어 파이프라인이 필요 없지만, 파일을 Google에 올려야 하고 고정 간격으로 샘플링합니다. Claude 사용자에게 crv는 이 작업을 위해 만들어진 오픈 도구 중 스타가 가장 많고, 전처리 단계가 아니라 완전한 에이전트 프레임워크가 필요하다면 videoagent가 대안입니다.
제 역할을 하는 곳
90분짜리 고객 통화 녹화를 놓친 프로덕트 매니저
고객이 가격에 대해 한 말과 그때 화면에 있던 내용 찾기
화면 공유 구간에 맞춰 --from과 --to를, --why 'pricing objections'를 지정해 녹화에 crv를 실행한 뒤 Claude에게 묻습니다. 무료이고 로컬에서 돌며, 모델로 가는 것은 선택된 프레임과 대본뿐입니다.
40분짜리 컨퍼런스 강연으로 공부하는 개발자
발표자의 말뿐 아니라 슬라이드에 나온 코드까지 얻기
슬라이드 글자가 읽히도록 --frame-width를 1600으로 높이고, 자막이 있으면 --text-anchors를 추가합니다. 프레임당 토큰 비용이 커진다는 점을 감안하십시오. 슬라이드가 필요 없으면 get_transcript만 쓰는 편이 쌉니다.
경쟁사 릴을 검토하는 소규모 에이전시의 소셜 미디 어 분석가
주당 짧은 영상 20편의 훅과 컷 분석하기
--grid로 링크들에 crv를 일괄 실행해 릴마다 콘택트 시트 몇 장으로 만들고, 나중에 crv-ask로 전체를 검색합니다. 속도감과 샷 유형 분석에는 일회성 $29인 crv Pro가 필요합니다.
도입 전 확인할 점
- 설정
- ffmpeg를 설치한 뒤 pip install "claude-real-video[whisper]"(faster-whisper는 [fast], Apple Silicon은 [mlx])와 npx skills add HUANGCHIHHUNGLeo/claude-real-video를 실행하거나 Claude Code 플러그인을 설치합니다. MCP는 pip install 'claude-real-video[mcp]'와 claude mcp add crv -- crv-mcp. Python 3.10 이상.
- 연동
- Claude Code, Cursor, Codex, Copilot, Gemini CLI용 skill. MCP 도구 watch_video, get_frames, get_transcript, search_memory, list_watched. Python API(process()). YouTube, Instagram, TikTok 등 여러 사이트용 yt-dlp.
- 데이터와 개인정보
- 다운로드, 프레임 추출, 받아쓰기는 로컬에서 실행되며, 프레임이나 텍스트를 모델에 넘기기 전에는 아무것도 전송되지 않습니다. ~/.crv/memory.db의 로컬 SQLite 메모리 색인이 대본과 타임스탬프를 저장하고(CRV_NO_MEMORY=1로 비활성화), MCP 분석 결과는 ~/.cache/crv-mcp에 캐시됩니다. 쿠키 옵션은 브라우저 로그인 쿠키를 읽습니다.
- 대규모 사용 시 비용
- 로컬에서는 무료이며 Whisper에 CPU나 Apple GPU 시간이 듭니다. 모델 비용은 이미지 토큰입니다. 작성자의 벤치마크에서 640x360 3분 영상의 170프레임에 약 52,000개가 들었으므로, 길거나 움직임이 많은 영상은 프레임 수를 제한하십시오.
- 제한
- 영상에 입혀진 자막은 자막으로 감지되지 않습니다. 화면 속 텍스트 인식은 무료 버전에 없고, 움직임, 어조, 감정에는 crv Pro가 필요합니다. 메인테이너는 한 명입니다.
좋은 점
- 원본 타임스탬프를 유지하는 장면 전환 프레임
- 로컬에서 실행되며 영상을 업로드하지 않음
- skill, 플러그인, CLI, 도구 5개짜리 MCP 서버
- 긴 녹화용 --from과 --to 구간 지정
아쉬운 점
- 컷이 빠른 영상은 여전히 이미지 토큰 수만 개가 듦
- 정지 화면과 말만 다루며 움직임과 어조는 유료 Pro
- 화면 속 텍스트 인식은 무료 버전에 없음
- ffmpeg를 따로 설치해야 함
추천 대상
영상을 업로드하지 않고 모델이 영상에 관한 질문에 답하게 하려는 Claude Code 및 기타 에이전트 사용자.
claude-real-video (crv) 대안
claude-real-video (crv): 자주 묻는 질문
- claude-real-video (crv), 쓸 만한 가치가 있습니까?
- 지금 Claude가 영상을 두고 추론하게 하는 합리적인 방법입니다. 로컬에서 돌고 토큰이 적게 들며 타임스탬프에 정직합니다. 다만 모델에게 보여주는 것은 움직임이 아니라 정지 화면과 말입니다. 평점은 5점 만점에 4.0점입니다.
- claude-real-video (crv)의 가격은 얼마입니까?
- 무료 오픈소스(MIT)입니다. 선택 사항인 crv Pro는 일회성 $29이고, 별도의 Codex 빌드는 일회성 $9.90입니다.
- claude-real-video (crv)의 단점은 무엇입니까?
- 컷이 빠른 영상은 여전히 이미지 토큰 수만 개가 듦; 정지 화면과 말만 다루며 움직임과 어조는 유료 Pro; 화면 속 텍스트 인식은 무료 버전에 없음; ffmpeg를 따로 설치해야 함.
- claude-real-video (crv)에 적합한 사람은 누구입니까?
- 영상을 업로드하지 않고 모델이 영상에 관한 질문에 답하게 하려는 Claude Code 및 기타 에이전트 사용자.
- 팀이나 프로덕션 환경에서 claude-real-video (crv)의 비용은 얼마입니까?
- 로컬에서는 무료이며 Whisper에 CPU나 Apple GPU 시간이 듭니다. 모델 비용은 이미지 토큰입니다. 작성자의 벤치마크에서 640x360 3분 영상의 170프레임에 약 52,000개가 들었으므로, 길거나 움직임이 많은 영상은 프레임 수를 제한하십시오.
- claude-real-video (crv)에 회사 데이터를 맡겨도 안전합니까?
- 다운로드, 프레임 추출, 받아쓰기는 로컬에서 실행되며, 프레임이나 텍스트를 모델에 넘기기 전에는 아무것도 전송되지 않습니다. ~/.crv/memory.db의 로컬 SQLite 메모리 색인이 대본과 타임스탬프를 저장하고(CRV_NO_MEMORY=1로 비활성화), MCP 분석 결과는 ~/.cache/crv-mcp에 캐시됩니다. 쿠키 옵션은 브라우저 로그인 쿠키를 읽습니다.
- claude-real-video (crv)의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 VideoAgent 및 MarkItDown입니다.
답변 확인일: 2026년 10월 31일.
claude-real-video (crv) 개발사입니까? 이 평점을 사이트에 표시하십시오
