원문 캡처 · github.com
원문 캡처 · github.com

watchall은 Claude가 유튜브, 틱톡, 인스타그램 릴스 등 1,800여 사이트의 영상과 컴퓨터에 저장된 영상을 분석하도록 돕는 Claude 스킬이다. 제작자는 요약, 타임스탬프가 포함된 답변과 자막 생성, 영상 개선 피드백 등에 쓸 수 있다고 설명한다.

사용자는 Claude Code에서 /watchall 뒤에 영상 URL이나 파일 경로, 원하는 요청을 입력한다. 예를 들어 영상의 특정 구간을 검토하거나, 스웨덴어 요약과 타임스탬프를 요청할 수 있다. 로컬 파일은 mp4, mov, mkv, webm, avi, wmv, m2ts, 3gp 등의 형식을 지원한다고 안내한다.

처리 과정에서는 영상의 장면 전환, 검은 화면, 정지 화면을 확인하고, 타임스탬프가 표시된 프레임 모음과 첫 5초를 초당 2프레임으로 추출한 모음을 만든다. 오디오 음량과 무음 구간을 분석하며, 자막이 없을 때는 Groq, 로컬 faster-whisper, OpenAI 순으로 전사 수단을 이용한다. 분석 결과는 report.md에 정리되고 Claude가 프레임 모음과 전사 내용을 바탕으로 답변한다.

제작자는 일반적인 영상 분석 스킬과 비교해 다음 기능을 제공한다고 소개한다.

기능watchall의 설명일반적인 영상 스킬
로컬 영상모든 형식과 라이브러리 검색(예: “my latest video”)경로 지정, 제한된 형식
자막이 없는 음성의 텍스트 변환무료 오프라인 faster-whisper(GPU/CPU), Groq, OpenAI유료 API 키 필요
이미지당 읽는 프레임 수타임스탬프가 있는 연락처 시트, 이미지당 12프레임읽기당 1프레임
중복 프레임제거해 정적인 장면이 토큰을 낭비하지 않도록 함유지
검은 화면·정지 화면·긴 무음타임스탬프와 함께 감지제공하지 않음
음량·트루 피크·클리핑EBU R128 기준으로 측정제공하지 않음
플랫폼 적합성TikTok, Reels, Shorts, YouTube, LinkedIn 검토제공하지 않음
크리에이터 및 AI 영상 검토 기준훅, 페이싱, 인공적인 흔적, 프롬프트 포함제공하지 않음
특정 구간 확대frame --range 12-15 --fps 6전체 파이프라인 재실행
TikTok브라우저 가장 기능으로 작동자주 차단됨
Windows우선 지원, winget으로 ffmpeg 자동 설치수동 설치
자막 내보내기모든 영상에 .srt 제공제공하지 않음
캐시영상과 옵션별 저장으로 후속 요청을 빠르게 처리다시 다운로드

설치와 이용 조건

Claude Code 플러그인으로 설치할 때는 다음 명령을 사용한다.

/plugin marketplace add admjal/claude-watchall /plugin install watchall@watchall

수동 설치는 저장소를 내려받은 뒤 운영체제에 맞는 설치 스크립트를 실행하는 방식이다.

git clone https://github.com/admjal/claude-watchall cd claude-watchall ./install.ps1 # Windows ./install.sh # macOS / Linux

설치 프로그램은 스킬을 ~/.claude/skills/watchall에 복사하고 ffmpeg, yt-dlp, curl_cffi, Pillow, faster-whisper를 설치한다. claude.ai에서는 Releases의 watchall.skill 파일을 내려받아 Settings → Capabilities → Skills에서 올려야 하며, 코드 실행을 켜야 한다. 대안으로 python tools/build_skill.py를 사용할 수 있다.

명령줄 도구는 영상 분석, 프레임 추출, 라이브러리 검색, 설치 확인과 캐시 정리를 지원한다.

watchall.py <url|file> [--start 1:00 --end 1:30] [--res 1280] [--lang sv] [--max-frames N] [--hook 5] [--no-transcript] [--fresh] [--cookies-from-browser edge|chrome|firefox] [--transcriber auto|captions|local|groq|openai] [--whisper-model small] watchall.py frame <media> --at 12.5 --at 1:03 | --range 10-14 --fps 4 watchall.py library [--dir PATH] [--name foo] [--days 7] [--probe] [--json] watchall.py setup [--install] [--whisper] [--update] watchall.py clean [--days 7 | --all]

Groq와 OpenAI 전사 기능을 쓰려면 ~/.config/watchall/.env에 선택적으로 API 키를 설정할 수 있다. 로컬 Whisper 모델은 WATCHALL_WHISPER_MODEL로 tiny, base, small, medium, large-v3 중 지정한다. 영상 길이에 따라 프레임 수는 15초 이하는 24개, 30초 이하는 30개, 1분 이하는 40개, 3분 이하는 60개, 10분 이하는 80개이며, 각 경우 첫 5초를 위한 프레임 10개를 추가한다. 더 긴 영상은 최대 100개를 사용한 뒤 --start와 --end로 구간을 좁혀 분석하도록 안내한다.

사이트 오류가 나면 watchall.py setup --update로 업데이트할 수 있다. 비공개 또는 연령 제한 영상은 브라우저 쿠키 옵션이 필요할 수 있고, 전사 결과가 없으면 Whisper를 설치하거나 GROQ_API_KEY를 설정하라고 안내한다. 작은 글자를 읽으려면 해상도를 높일 수 있다. 제작자는 접근 권한이 있는 콘텐츠만 분석하라고 명시하며, 라이선스는 MIT다.