Welcome to Universal Novel Scraper
Universal Novel Scraper (UNS) is a powerful desktop application that lets you download web novels from supported websites and convert them into professionally formatted EPUB books. Built with Electron, React, and FastAPI, UNS provides a seamless experience across Windows, macOS, and Linux.Why UNS?
Unlike traditional scraping tools that are easily detected by anti-bot systems, UNS uses Electron’s built-in Chromium browser to scrape pages like a real user. This unique approach allows the application to:- Bypass Cloudflare and other bot protection systems
- Scrape dynamic websites that rely on JavaScript rendering
- Maintain browsing sessions for authenticated content
- Avoid detection by appearing as a normal browser
Key Features
Download Manager
Chapter-by-chapter scraping with progress tracking and resume capability
Library Manager
Organize your EPUB collection with cover images and metadata
Multi-Site Search
Search across multiple novel providers simultaneously
Built-in Reader
Read your downloaded novels directly in the app
Cloudflare Bypass
Manual browser control for handling protected sites
Provider Plugins
Community-driven provider system with automatic updates
How It Works
UNS uses a sidecar architecture where different components handle specific responsibilities:- React Frontend - Provides the user interface for managing downloads and your library
- Electron Main Process - Controls the Chromium browser and manages the scraping workflow
- Python FastAPI Backend - Stores chapters, tracks progress, and generates EPUB files
Cross-Platform Support
UNS is available as a native desktop application for:- Windows - Windows 10 and later
- macOS - macOS 10.13 (High Sierra) and later
- Linux - Most modern distributions
Next Steps
Installation
Download and install UNS on your system
Quickstart Guide
Start downloading your first novel in minutes
Architecture Overview
Learn how UNS works under the hood
API Reference
Explore the backend API endpoints