XHS-Downloader is a media downloader and content scraper for Xiaohongshu designed to extract and save images, videos, and metadata from profiles, search results, and shared links. It functions as a background service that can automatically detect and download media when platform URLs are copied to the system clipboard.
The project provides a server with an HTTP API endpoint for programmatically triggering media downloads and extracting work details via external scripts. It includes a media asset manager that sorts downloaded content into custom folders using filename patterns based on author and work metadata.
The system supports bulk profile backups through recursive crawling of user profiles and search results. It utilizes a database-backed tracking system to prevent redundant downloads and implements resumable transfers to ensure complete media recovery.
