비디오 콘텐츠 추출기
개요
MP4 비디오 파일에서 설정 가능한 시간 간격으로 키 프레임을 자동으로 추출하고, 각 프레임에 대해 OCR 텍스트 인식을 수행하며, 구조화된 Markdown 보고서를 생성합니다. 보고서에는 비디오 메타데이터(지속 시간, 해상도, 코덱)와 타임스탬프 참조가 포함된 프레임별 OCR 전사가 포함됩니다.
이 스킬은 Codex CLI용으로 설계되었으며, 로컬 머신에 FFmpeg와 Tesseract OCR이 설치되어 있어야 합니다.
이 스킬을 사용해야 하는 경우
- 비디오 프레젠테이션, 강의 또는 스크린캐스트에서 텍스트 콘텐츠를 추출해야 할 때 사용하세요.
- 내장 자막이 없는 비디오 파일에서 검색 가능한 전사를 생성하려 할 때 사용하세요.
- 비디오 콘텐츠를 프로그래밍 방식으로 분석하고 구조화된 요약을 생성해야 할 때 사용하세요.
- 사용자가 "화면에 무엇이 표시되어 있는지 읽어줘" 또는 "이 비디오에서 콘텐츠를 추출해줘"라고 요청할 때 사용하세요.
작동 방식
1단계: 비디오 메타데이터 분석
스킬은 ffprobe를 사용하여 비디오 메타데이터(지속 시간, 해상도, 프레임 속도, 코덱 정보, 파일 크기)를 추출합니다.
2단계: 키 프레임 추출
FFmpeg를 사용하여 스킬은 설정된 간격(기본값: 30초마다)으로 프레임을 캡처합니다. 각 프레임은 타임스탬프가 포함된 JPEG 이미지로 저장됩니다.
3단계: OCR 텍스트 인식
추출된 각 프레임은 Tesseract OCR로 처리됩니다. 기본 PSM 모드에서 의미 있는 텍스트를 반환하지 않으면 완전 자동 페이지 분할로 대체됩니다.
4단계: Markdown 보고서 생성
추출된 모든 데이터는 구조화된 Markdown 문서로 조합됩니다.
예제
예제 1: 기본 추출
에이전트 프롬프트: video-content-extractor 스킬을 사용하여 lecture.mp4에서 콘텐츠를 추출해줘
출력은 lecture.md 파일과 lecture_frames/ 디렉토리를 생성합니다.
예제 2: 사용자 정의 간격
매개변수: video_path, output_dir, interval(seconds), lang 60초마다 추출하고 영어 전용 OCR 사용: python scripts/extract_video.py recording.mp4 ./output 60 eng
예제 3: 이중 언어 콘텐츠
기본 중국어 + 영어 OCR로 추출: python scripts/extract_video.py lecture.mp4 . 15 chi_sim+eng
모범 사례
- 텍스트 변경이 빈번한 빠른 콘텐츠에는 짧은 간격(10-15초)을 사용하세요.
- 중복 프레임을 줄이기 위해 프레젠테이션 슬라이드나 느린 강의에는 긴 간격(30-60초)을 사용하세요.
- 중국어 콘텐츠의 경우 Tesseract 중국어 언어 팩(chi_sim)이 설치되어 있는지 확인하세요.
제한 사항
- FFmpeg와 Tesseract OCR이 설치되어 있고 PATH를 통해 접근 가능해야 합니다.
- Tesseract OCR 정확도는 비디오 품질, 텍스트 크기 및 글꼴 선명도에 따라 달라집니다.
- 오디오를 추출하거나 음성을 텍스트로 변환하는 기능은 없습니다.
- 프레임 추출은 장면 변경 기반이 아닌 시간 기반이므로 거의 중복된 프레임이 생성될 수 있습니다.
- 짧은 간격의 대용량 비디오는 많은 프레임을 생성할 수 있으므로 충분한 디스크 공간을 확보하세요.
보안 및 안전 참고 사항
- 이 스킬은 비디오 파일만 읽고 추출된 프레임과 Markdown 보고서를 씁니다.
- 네트워크를 통해 데이터를 전송하지 않습니다. 모든 처리는 로컬에서 이루어집니다.
- FFmpeg와 Tesseract는 고정되고 사전 검증된 인수로 호출됩니다.
- 이 스킬은 원본 비디오 파일을 수정하거나 삭제하지 않습니다.
일반적인 실수와 해결 방법
-
문제: Tesseract가 왜곡된 텍스트를 반환합니다. 해결 방법: 올바른 언어 팩이 설치되어 있는지 확인하세요.
tesseract --list-langs를 실행하여 확인하세요. -
문제: FFmpeg가 "찾을 수 없음" 오류와 함께 실패합니다. 해결 방법: FFmpeg가 PATH에 있는지 확인하세요.
ffmpeg -version을 실행하여 확인하세요. -
문제: 대용량 비디오에서 OCR이 느립니다. 해결 방법: 간격 매개변수를 늘려 처리되는 프레임 수를 줄이세요.
관련 스킬
- @media-summarizer - 시각적 및 오디오 단서를 사용하여 비디오 콘텐츠를 요약합니다.
- @document-ocr - 비디오 처리 없이 정적 이미지나 스캔된 문서에 대해 OCR을 수행합니다.