비디오 분석하기
비디오를 직접 볼 수는 없습니다. 이 스크립트는 비디오를 여러분이 검토할 수 있는 형태인 프레임(정확한 시간이 찍힌 이미지)과 시간 정보가 포함된 대본으로 변환합니다. 모든 작업은 사용자의 컴퓨터에서 로컬로 처리됩니다.
1. 스크립트 실행
이 스킬의 폴더에서 다음 명령어를 실행하세요:
python scripts/analizar_video.py "비디오/경로/파일.mp4" --salida "분석-<이름>"
유용한 옵션:
--idioma ko: 언어를 정확히 알 때 사용합니다 (자동 감지보다 빠르고 정확).--modelo base: 느린 컴퓨터에서 사용;--modelo medium: 오디오 품질이 나쁠 때.--max-fotogramas 40: 긴 영상일 때.--sin-transcripcion: 시각 정보만 필요할 때.
오류 발생 시:
- ffmpeg를 찾을 수 없음 → 설치 안내 (https://ffmpeg.org/download.html) 또는 사용자 요약으로 대체.
- 변환 엔진 없음 → 스크립트가
info.json에 명시합니다. 프레임으로 계속 진행하고 사용자에게 대사 요약을 요청하거나pip install faster-whisper를 추천. - 변환 시간이 오래 걸림 (처음 실행 시 모델 다운로드) → 환경이 허락한다면 백그라운드에서 실행.
2. 출력 결과 검토
info.json: 길이, 해상도, 방향, 오디오 유무, 프레임 목록, 변환 상태.fotogramas/*.jpg: 모두 순서대로 확인하세요. 파일명에 시간이 표시됩니다 (f03_00-12.jpg= 12초).transcripcion.txt: 대사와 시간 정보.transcripcion.srt: 자막으로 바로 사용 가능.
중요한 구간에 프레임이 없으면 (두 프레임 사이에 급격한 변화가 있을 때) 추가로 추출하세요:
ffmpeg -v error -ss 00:00:15 -i "비디오.mp4" -frames:v 1 extra_00-15.jpg
3. 보고서
다음 형식으로 간결하고 구체적인 보고서를 제공하세요:
## 비디오 분석
**기술 사양:** 0:42 · 세로 1080x1920 · 60 fps · 오디오 있음 · 언어: 한국어
**내용 요약:** <2-3줄>
**구간별 장면 설명**
- 00:00-00:05: …
- 00:05-00:18: …
**대사 요약:** <요약; 핵심 문장 짧은 인용>
**감지된 게임/테마:** <이름> (확실 / 추정 / 미확인; 이유)
**후킹 최적 시점:** <초 단위 및 이유>. 영상이 바로 이 시점에서 시작하는가? 그렇지 않다면 자르기 제안.
**추천 썸네일:** <파일명 및 시간>
**제안 챕터** (긴 영상만, 최소 3개, 각 10초 이상):
00:00 …
**감지된 키워드:** <화면에서 보이거나 들린 단어>
**경고**
- 상업용 음악 또는 타인 오디오 → Content ID 위험 또는 음소거 가능성
- 브랜드 또는 제품 노출 → 협찬 확인 필요
- 민감 콘텐츠 (폭력적 장면, 강한 언어) → 연령 제한 필요
- AI로 조작된 듯한 인물 또는 장면 → AI 라벨 필요
- 인터페이스(세로: 위, 아래, 오른쪽)에 가려지는 중요한 텍스트 또는 요소
- 이미 영상에 포함된 자막 → 자동 자막 중복 방지 (Facebook)
- 영상이 약속하는 내용과 다른 텍스트 또는 자막
- 편집 끊김, 검은 화면, 캡처 손실
- 품질: 낮거나 포화된 오디오, 흐릿한 이미지, 느린 시작
**시청자에게 불명확한 점:** <부족한 맥락; 게시글에서 설명할 내용>
**권장 사항:** <2-4가지 구체적인 조치>
규칙
- 보고 들은 것을 설명하고 추측하지 마세요. 불확실하면 "~인 것으로 보입니다"라고 말하세요.
- 사용자가 요약을 제공한 경우, 여러분이 찾은 내용과 비교하세요. 모순되면 질문하세요.
- Whisper는 고유명사(클래스, 캐릭터, 은어)를 잘못 적을 수 있습니다. 화면에서 확인하여 수정하고 그대로 복사하지 마세요.
- 게임 식별: 인터페이스(HUD), 메뉴, 로고, 화면의 이름을 확인하세요. 확실하지 않으면 질문하세요.
- 실제 인물을 얼굴로 식별하지 마세요. 화면, 오디오 또는 사용자가 제공한 이름만 사용하세요.
- 분석 폴더는 사용자 컴퓨터에 남아 있습니다. 작업이 끝나면 폴더 위치를 알려주고 삭제할 수 있음을 안내하세요.