ClipRadar

ClipRadar는 치지직 VOD의 채팅 흐름을 분석해 편집자가 먼저 확인할 하이라이트 후보와 추천 컷 범위를 만드는 로컬 도구입니다. 여러 VOD를 한 번에 분석하고, 결과를 ClipCatcher나 편집 작업표로 넘길 수 있습니다.

실제 VOD 분석은 채팅량과 웃음·놀람·고점 표현이 포함된 반응 채팅 수를 사용합니다. 클립 생성량과 조회수는 API가 연결된 값이 아니며, 화면 기능을 설명하는 예시 데이터에서만 표시됩니다.

GitHub Pages 소개와 실제 리포트 · ClipCatcher

• 치지직 VOD URL 최대 12개 입력 및 중복 URL 자동 정리
• 빠른 분석, 정밀 분석, 전체 분석 모드
• 여러 VOD를 입력 순서대로 묶은 주간 하이라이트 리포트
• VOD별 탭과 실제 재생 시간 비율을 유지하는 Moment Map
• 핵심 반응 구간과 앞 30초·뒤 60초를 포함한 추천 컷 범위
• 웃긴 리액션, 고점 리액션, 놀람/사건, 채팅 급증 타입 분류
• 실제 수집 채팅을 이용한 대표 채팅과 선정 이유
• 후보 고정·제외 및 제외 항목 숨김
• ClipCatcher용 JSON, CSV 작업표, 편집자 HTML, 주간 HTML 내보내기
• 일부 VOD가 삭제·비공개 상태여도 성공한 VOD 결과 보존
• 스트리머 프로필 이미지와 해당 시점 치지직 링크

Python 3.9 이상이 설치된 환경에서 저장소를 받은 뒤 실행합니다. 별도 Python 패키지는 필요하지 않습니다.

git clone https://github.com/ThankyouJerry/ClipRadar.git
cd ClipRadar
python3 server.py

브라우저에서 http://localhost:5173을 엽니다. 서버는 127.0.0.1에만 열리며, 분석한 URL과 채팅 데이터는 별도 서버나 AI API로 전송하지 않습니다.

빠른·정밀 분석의 채팅 수와 급증 배수는 전체 채팅의 절대 통계가 아니라 수집된 샘플 안의 상대값입니다. 전체 분석도 치지직이 제공하는 다시보기 채팅 범위와 네트워크 상태에 영향을 받습니다.

1. VOD 메타데이터와 재생 시간을 읽습니다.
2. 선택한 모드에 따라 VOD 전역의 채팅 페이지를 수집합니다.
3. 채팅을 30초 단위로 묶고, 같은 VOD의 평소 구간과 비교합니다.
4. 반복된 ㅋㅋㅋㅋ처럼 한 채팅에 같은 표현이 여러 번 있어도 반응 채팅 1건으로 계산합니다.
5. 90초 이내로 이어지는 후보를 최대 3분 길이의 한 장면으로 병합합니다.
6. 핵심 구간 앞 30초와 뒤 60초를 붙여 편집용 추천 컷을 만듭니다.

여러 VOD를 넣으면 각 VOD를 자기 평소 수준과 먼저 비교한 뒤 후보를 한데 모읍니다. 긴 방송이나 채팅이 많은 방송이 절대 채팅량만으로 상단을 독점하지 않도록 VOD별 상대 점수를 유지합니다.

실제 VOD의 종합 하이라이트 점수는 다음 비율로 계산합니다.

채팅 급증도 70% + 반응 채팅 급증도 30%

• 채팅 급증도: 해당 구간 채팅량을 같은 VOD의 평소 구간과 비교한 배수입니다.
• 반응 채팅 급증도: 웃음·놀람·고점 표현이 들어간 채팅 수를 같은 VOD의 평소 수준과 비교한 배수입니다.
• 레이더 신뢰도: 두 신호가 같은 후보를 가리키는 정도와 실제 채팅 페이지 수집 완성도를 함께 반영합니다.
• 타입 신뢰도: 분류 타입을 뒷받침한 서로 다른 반응 표현의 비중입니다. 표현 하나만 잡힌 경우 과도하게 높아지지 않도록 제한합니다.

신뢰도는 정확도 보증이 아니라 먼저 확인할 순서를 정하는 보조 지표입니다. 점수가 높아도 해당 시점 링크와 대표 채팅으로 실제 맥락을 확인해야 합니다.

1. VOD URL을 한 줄에 하나씩 입력하고 분석 모드를 선택합니다.
2. 주간 전체 탭에서 후보를 비교하고, VOD별 탭에서 타임라인 위치를 확인합니다.
3. 좋은 후보는 고정, 불필요한 후보는 제외로 표시합니다.
4. ClipCatcher용 JSON을 내려받습니다.
5. ClipCatcher에서 파일 > ClipRadar JSON 가져오기를 선택해 추천 구간을 순차 다운로드합니다.

JSON은 고정 후보를 먼저 정렬하고 제외 후보를 생략합니다. 각 항목에는 원본 VOD URL, 해당 시점 URL, 핵심 구간, 추천 컷, 선정 이유가 포함됩니다.

{
  "schemaVersion": "clipradar.report.v1",
  "exportTarget": "clipcatcher",
  "moments": [
    {
      "url": "https://chzzk.naver.com/video/123456",
      "watchUrl": "https://chzzk.naver.com/video/123456?t=00:20:30",
      "coreStartTimeSeconds": 1230,
      "coreEndTimeSeconds": 1320,
      "cutStartTimeSeconds": 1200,
      "cutEndTimeSeconds": 1380
    }
  ]
}

CSV와 편집자 HTML에는 추천 컷, 점수, 타입, 선정 이유, 해당 시점 링크가 들어갑니다. 주간 HTML은 앱 없이 공유할 수 있는 읽기 전용 리포트입니다.

docs/는 소개, 실제 정밀 분석 예시, 사용법, ClipCatcher 연동 안내를 제공하는 정적 사이트입니다. GitHub Pages에서는 새로운 VOD를 분석하지 않으며, 실제 분석은 로컬 서버에서만 실행합니다.

예시 스트리머와 수치는 화면 기능을 설명하기 위한 가상 데이터입니다. 실제 리포트 페이지에는 공개 VOD로 확인한 샘플 기반 정밀 분석 결과와 수집 범위를 명시합니다.

• 입력한 URL과 수집한 채팅은 실행 중인 컴퓨터 메모리에서 처리되며 저장소로 전송되지 않습니다.
• 공개 채팅에도 닉네임과 개인 정보가 포함될 수 있으므로 내보낸 파일을 공유하기 전에 확인해야 합니다.
• VOD, 채팅, 썸네일과 다운로드한 영상의 저작권은 각 원저작자와 권리자에게 있습니다.
• 다운로드와 편집은 서비스 약관, 저작권, 초상권 및 원저작자의 허용 범위 안에서 사용해야 합니다.

개발 환경과 테스트 방법은 CONTRIBUTING.md를 참고해주세요.

MIT License