VNDB-HTML-Generator_v1.1 (업로더용)

게임 업로드할 때 매번 똑같은 양식을 4~5개씩 작성하다 보면 너무 귀찮아서
준자동 프로그램 만들어서 쓰고 있었음

그럼 공지에 있는 업로드 양식을 조금 더 간소화 하면 되는거 아닌가요?
라는 나쁜말은 ㄴㄴ...

해당 프로그램은 vndb.org 주소를 입력하면
vndb api를 호출하여 데이터를 가지고와 정해진 양식에 따라 자동으로 html로 파싱해줌

제미나이키를 추가하면 개요 및 별칭 번역을 시도하고, 실패 시 영문으로 넣어줌

단 해당 게임 릴리즈 주소를 입력 (ex: https://vndb.org/r ~~) 하면 작동하지 않고
https://vndb.org/v56650 처럼 v로 시작하는 주소만 인식하여 동작함

캡처 이미지에서는 아이콘이 깨지고 있는데
아이콘 이미지가 안깨지게 수정했음

아무나 사용해도 상관없고 겸사겸사 기록용으로 작성함

다운로드 링크
v1.0 : https://workupload.com/file/q2EYTtQT9Zy
v1.1 : https://workupload.com/file/QcFBKLeeqjJ

- 준비물
Gemini key (무료로 발급 가능)

발급방법  (외부사이트 참조)

발급 받은 API 키를 복사 해야함

- 내부작동 로직

• 데이터 추출 및 API 연동: 입력된 URL에서 고유 식별자(VN ID)를 파싱한 후, 로컬 프록시 서버를 통해 VNDB API를 호출하여 원제, 제작사, 퍼블리셔, 평점 등의 메타데이터 원본을 수집합니다.

• 제미나이(Gemini) 기반 데이터 가공: 수집된 영문 시놉시스와 별칭(Alias) 데이터를 Gemini API로 전송하여, 자연스러운 한국어 번역 및 독음 텍스트로 변환하는 자연어 처리 과정을 거칩니다.

• 최종 HTML 구조화: 취합된 원본 데이터와 AI 번역 결과물을 미리 정의된 커뮤니티 게시 양식(HTML 테이블 및 details 태그)에 맞춰 렌더링하고, 사용자가 즉시 복사할 수 있는 최종 코드로 출력합니다.

• 입력된 제미나이키는 로컬 환경에서만 저장합니다. 외부 유출 없습니다.

Version 1.0

＊ 실행화면

1

＊ 사용 방법

1. 발급 받은 API 키를 프로그램 GEMINI API KEY 항목에 붙여넣기 (API KEY는 PC 브라우저 저장소에 저장)
   
   

2.  업로드 할 게임의 vndb.org 주소를 복사하여 프로그램 VNDB URL에 붙여넣고 생성 버튼 클릭
   
   

   1

   

   
   
   

3. 생성된 코드를 프로그램 하단에 클립보드 복사 버튼을 선택
   
   

   1

   

   
   
   

4. 게시글 작성 버튼을 선택 후 편집모드로 변경 하여 복사된 코드를 그대로 내용에 붙여넣기
   v.1.1은 편집모드로 변경하지 않고 게시글 내용 그대로 복사하기가 가능
   

   1

   

＊ 결과

1

Version 1.1 (04/16 Update)

1

＊ 신규 기능

•  Gemini 번역 모델 드롭다운 선택 추가 (gemini-2.5-flash / gemini-2.5-flash-lite / gemini-2.5-pro)

• VNDB 이미지 업로드 모드 추가 — 커버 + 스크린샷 URL을 태그로 자동 삽입
  - 일반 이미지만 (최대 5장) / 성인 이미지 포함 (최대 6장) 선택
  - Pool 방식으로 이미지 수집, 부족 시 하위 수위 이미지로 자동 보완
  - 커버 없을 경우 스크린샷으로 슬롯 대체

• 생성 완료 시 자동 클립보드 복사 (글 내용에 바로 붙이기 가능)

• TXT 파일 다운로드 기능 추가 (HTML 다운로드 대체)

• API Key 표시/숨기기 토글 (눈 아이콘)

• 창 크기 및 위치 기억

＊ 개선 및 버그 수정

•  Gemini 번역 실패 시 서버에서 2회 자동 재시도

• 콘텐츠 필터(SAFETY) 거부 시 CONTENT_BLOCKED 반환, 원문 삽입 후 프론트에 메시지 표시

• 번역모델, 업로드 모드 토글, 이미지 모드 선택 값을 재실행해도 초기화 되지 않게 개선

＊ v1.1 사용 방법

1. Gemini api key를 발급 받아 프로그램에 추가한다.
   
   

2. URL에 업로드할 게임의 VNDB 주소를 붙인다. (VNDB에 저장된 게임 이미지까지 포함시키고 싶다면 옵션 선택)
   
   

   1

   

   
   

3. 자동으로 클립 보드에 복사되니 작성할 게시글 내용에 그대로 Ctrl+V로 붙여 넣는다. (원본유지 선택)