작품 검색
제목·작가·소개·표지·장르·출판사·완결 여부·회차 수·평점을 조회합니다. 제목 접미사를 고려한 후보 검색으로 판본 차이를 확인합니다.
작품 정보·서재 관리
NovelMetadata-Python
작품 정보와 내 EPUB 서재를 연결하세요.
웹소설 작품 정보를 수집·검색하고 내 EPUB과 연결합니다. 변경 미리보기와 백업을 거쳐 책 정보를 반영하고, 로컬 DB로 자료를 관리합니다.
- 지원 환경
- Windows · PowerShell · Python 3.13
- 배포 상태
- 공개 배포 전
설치 파일과 소스는 현재 비공개입니다.
NovelMetadata-Python실제 프로그램 화면
화면 크게 보기 작품 정보·서재 관리
프로그램 소개
Windows에서 사용하는 로컬 소설 메타데이터·서재 관리 프로그램입니다. 네이버 시리즈의 작품 정보를 모으고 내 EPUB 폴더의 책과 연결합니다. Python/FastAPI와 React 화면을 사용하며, 브라우저의 로컬 주소에서 실행됩니다.
이런 분께 추천합니다
- EPUB 파일에 빠진 작가·표지·줄거리 정보를 채우고 싶은 분
- 작품 카탈로그와 소장 여부를 한곳에서 관리하고 싶은 분
할 수 있는 일
주요 기능을 살펴보세요.
수집 관리와 재시도
지원하는 공개 목록에서 작품을 발견하고 상세 정보를 수집합니다. 중단된 수집을 재개하고 실패 항목을 재시도하며 접근 제한을 상태로 안내합니다.
EPUB 서재 연결
등록한 폴더의 EPUB을 검사하고 작품 후보를 연결합니다. 자동 판정이 모호하면 수동 확정·제외할 수 있고 소장 상태와 파일 열기를 지원합니다.
미리보기·반영·복원
EPUB 책 정보의 변경 내용을 먼저 보고 선택한 항목만 반영합니다. 원본을 백업하고 복원 전 현재 파일도 추가로 보관합니다.
백업과 자료 내보내기
여러 DB 백업 위치와 보관 개수를 설정하고 JSON/XLSX로 내보냅니다. 기존 C#판 DB는 원본을 읽기 전용으로 다루어 별도 Python판 DB로 가져옵니다.
이용량·댓글 지표
완결 작품의 지표를 백그라운드에서 순차 수집해 당시 수치와 날짜를 보관합니다. 카카오 공식 sitemap의 공개 작품 ID는 TSV로 따로 내보낼 수 있습니다.
일상과 작업에 맞게
이렇게 활용해 보세요.
책 정보가 제각각인 EPUB 서재 정리
서재 폴더를 등록하고 작품 연결 후보를 살펴봅니다. 제목이 비슷하거나 판본이 다른 책은 직접 확정합니다. 미리보기에서 작가·소개·표지 등 필요한 변경만 선택해 반영합니다.
새로 찾은 작품과 소장 여부 비교
수집한 카탈로그에서 제목과 작가를 검색하고 내 서재의 파일과 연결합니다. 작품 설명과 소장 상태를 함께 살펴보며 다음에 읽을 책을 고르는 데 활용할 수 있습니다. 처음 실행하면 빈 카탈로그이므로 수집이나 기존 DB 가져오기가 먼저 필요합니다.
작품 목록을 별도 정리 자료로 활용
JSON·XLSX로 내보낸 자료를 열어 개인 분류나 검토에 사용합니다. 이용량과 댓글 지표는 수집 날짜를 함께 읽습니다. 내보내기 자료는 검토용이며 수정한 JSON·XLSX를 DB에 다시 가져오는 기능은 지원하지 않습니다.
작업 흐름
사용 흐름을 살펴보세요.
프로그램의 작업 순서를 설명하는 예시입니다. 현재 설치 파일과 소스 코드는 공개하지 않았습니다.
실행 환경 준비
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일 저장소 문서 기준으로 정리했습니다. 배포 상태와 요구사항은 이후 변경될 수 있습니다.
공개 배포 전
공개 배포를 준비하고 있습니다.
현재 비공개로 개발 중인 프로그램입니다. 소스 코드와 설치 파일은 아직 공개하지 않았습니다. 공개 배포를 시작하면 이 페이지에서 다운로드 방법을 안내하겠습니다.