Skip to content

댓글 수사대

YouTube Shield는 YouTube 영상의 댓글을 AI로 분석하여 독성 댓글을 탐지하고 분류하는 웹 서비스입니다.

Code Video Cerebral Valley

Core trick

A keyword regex pre-filter sends surviving YouTube comments, plus the video transcript, to Gemini Flash for context-aware toxicity scoring.

Tags

security

Description

YouTube Shield는 YouTube 영상의 댓글을 AI로 분석하여 독성 댓글을 탐지하고 분류하는 웹 서비스입니다. 사용자가 YouTube URL을 입력하면 2단계 파이프라인으로 댓글을 분석합니다. 첫 번째 단계에서는 한국어 비속어 사전과 정규식 패턴을 활용한 Rule-based Pre-screen으로 빠르게 사전 필터링하고, 두 번째 단계에서는 Google Gemini 2.5 Flash 모델이 영상 트랜스크립트와 댓글을 함께 분석하여 문맥 기반의 정밀한 독성 판단을 수행합니다. 분석 결과로 각 댓글에 대해 0에서 100 사이의 독성 점수, 5단계 독성 레벨(안전, 경미, 주의, 심각, 매우 심각), 10가지 독성 카테고리(욕설/비속어, 비난/비방, 조롱/비꼼, 인신공격, 혐오 표현, 위협/협박, 성희롱, 차별, 팬덤 갈등, 스팸), 판단 근거 설명, 그리고 순화 표현 제안을 제공합니다. 한국 인터넷 문화와 K-POP 엔터테인먼트 맥락에 특화된 분류 체계를 사용하며, 초성 축약, 변형 표현, 반어법, 은유 등 한국어 특수 표현도 탐지합니다. 프론트엔드는 Next.js, 백엔드는 FastAPI로 구성되어 있으며, YouTube Data API v3를 통해 댓글과 영상 정보를 수집합니다.
euisuk-chung/gemini-hak-creator-hub★ 00 forksTypeScriptCreated Feb 28, 2026 · last push Mar 17, 2026

README excerpt

# Creator Hub — YouTube 악성 댓글 분석 서비스

Google Gemini Hackathon 출품작 (K-POP x Social Good x AI)

Gemini AI로 YouTube 댓글을 분석하여 악성 댓글을 자동 식별하고, 크리에이터에게 대응 방안을 제안하는 서비스입니다.

## 핵심 기술

- **Gemini 2.5 Flash** — 댓글 독성 분석 (한국어 특화, JSON 구조화 출력)
- **YouTube Data API v3** — 댓글/영상 정보 수집
- **Next.js 16** — 풀스택 프레임워크 (App Router + API Routes)

## 서비스 화면

### 메인 화면

YouTube 영상 URL을 입력하여 댓글 분석을 시작할 수 있습니다.

![메인 화면](imgs/main.png)

### URL 입력 & 영상 미리보기

URL을 입력하면 해당 영상의 썸네일과 제목을 미리 확인할 수 있습니다.

![URL 입력](imgs/inputurl.png)

### 분석 진행

혐오·욕설·위협 등 7가지 유형으로 댓글 패턴을 감지합니다.

![분석 중](imgs/analyze.png)

### 분석 리포트

독성 점수, 심각도 분포, Gemini AI 인사이트 등 종합 분석 결과를 제공합니다.

![분석 리포트](imgs/report.png)

## 실행 방법

```bash
cd frontend && npm install && npm run dev
```

## 환경변수

프로젝트 루트 `.env` 파일에 설정:

```bash
YOUTUBE_API_KEY=your_youtube_api_key
GOOGLE_API_KEY=your_google_api_key
GEMINI_MODEL=gemini-2.5-flash
```

자세한 내용은 [AGENT.md](AGENT.md) 참조.

Team