NovelMetadata-Python
작품 정보와 내 EPUB 서재를 연결하세요.
웹소설 작품 정보를 수집·검색하고 내 EPUB과 연결합니다. 변경 미리보기와 백업을 거쳐 책 정보를 반영하고, 로컬 DB로 자료를 관리합니다.
실제 프로그램 UI에 직접 만든 가상 자료를 표시했습니다. 이미지를 누르면 원본 크기로 볼 수 있습니다.
어떤 프로그램인가요?
Windows에서 사용하는 로컬 소설 메타데이터·서재 관리 프로그램입니다. 네이버 시리즈의 작품 정보를 모으고 내 EPUB 폴더의 책과 연결합니다. Python/FastAPI와 React 화면을 사용하며, 브라우저의 로컬 주소에서 실행됩니다.
주요 기능
작품 검색
제목·작가·소개·표지·장르·출판사·완결 여부·회차 수·평점을 조회합니다. 제목 접미사를 고려한 후보 검색으로 판본 차이를 확인합니다.
수집 관리와 재시도
지원하는 공개 목록에서 작품을 발견하고 상세 정보를 수집합니다. 중단된 수집을 재개하고 실패 항목을 재시도하며 접근 제한을 상태로 안내합니다.
EPUB 서재 연결
등록한 폴더의 EPUB을 검사하고 작품 후보를 연결합니다. 자동 판정이 모호하면 수동 확정·제외할 수 있고 소장 상태와 파일 열기를 지원합니다.
미리보기·반영·복원
EPUB 책 정보의 변경 내용을 먼저 보고 선택한 항목만 반영합니다. 원본을 백업하고 복원 전 현재 파일도 추가로 보관합니다.
백업과 자료 내보내기
여러 DB 백업 위치와 보관 개수를 설정하고 JSON/XLSX로 내보냅니다. 기존 C#판 DB는 원본을 읽기 전용으로 다루어 별도 Python판 DB로 가져옵니다.
이용량·댓글 지표
완결 작품의 지표를 백그라운드에서 순차 수집해 당시 수치와 날짜를 보관합니다. 카카오 공식 sitemap의 공개 작품 ID는 TSV로 따로 내보낼 수 있습니다.
이런 분께 추천합니다
- EPUB 파일에 빠진 작가·표지·줄거리 정보를 채우고 싶은 분
- 작품 카탈로그와 소장 여부를 한곳에서 관리하고 싶은 분
이렇게 사용하세요
- Python 3.13을 준비하고 권한이 있는 저장소의 run.bat을 실행합니다.
- 열린 로컬 웹 화면에서 서재 폴더와 백업 위치를 설정합니다.
- 수집 관리에서 작품을 수집하고 내 서재에서 EPUB 연결 후보를 확인합니다.
- 변경 미리보기에서 반영할 항목을 선택하고 필요하면 원본을 복원합니다.
지원 환경
- Windows · PowerShell · Python 3.13
- 소스 웹 빌드: Node.js 22 권장 · npm · 최초 설치 인터넷 필요
- 빌드된 wheel 설치본은 Node.js/npm 없이 실행 가능 · 기본 주소 127.0.0.1:5179
공개 배포 안내
공개 배포 전
현재 비공개로 개발 중인 프로그램입니다. 소스 코드와 설치 파일은 아직 공개하지 않았습니다. 공개 배포를 시작하면 이 페이지에서 다운로드 방법을 안내하겠습니다.
사용 전에 알아두세요
처음에는 빈 카탈로그로 시작합니다. 소설 본문이나 회차 콘텐츠는 수집하지 않으며, 카카오 ID 목록도 작품 상세 DB로 자동 등록되지 않습니다.
사이트 구조나 요청 제한에 따라 수집이 달라집니다. 이용량은 독자 수와 다를 수 있습니다. JSON/XLSX는 검토용 내보내기이며 DB 재가져오기는 지원하지 않습니다.
기본 DB는 %LOCALAPPDATA%\NovelMetadata_v2에 저장됩니다. EPUB 파일 반영은 사용자가 선택한 경우에만 수행합니다.
2026년 10월 8일 저장소 문서 기준으로 정리했습니다. 배포 상태와 요구사항은 이후 변경될 수 있습니다.