# joeanamier/xhs-downloader **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/joeanamier-xhs-downloader).** 11,574 stars · 1,732 forks · Python · GPL-3.0 ## Links - GitHub: https://github.com/JoeanAmier/XHS-Downloader - Homepage: https://discord.com/invite/ZYtmgKud9Y - awesome-repositories: https://awesome-repositories.com/repository/joeanamier-xhs-downloader.md ## Topics `api` `docker` `download` `fastapi` `httpx` `javascript` `json` `linux` `macos` `mcp-server` `pyinstaller` `python` `rednote` `server` `sqlite` `tampermonkey` `textual` `userscript` `windows` `xiaohongshu` ## Description 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. ## Tags ### Business & Productivity Software - [Media Downloaders](https://awesome-repositories.com/f/business-productivity-software/media-downloaders.md) — Extracts and saves images, videos, and metadata from Xiaohongshu profiles, search results, and shared links to local storage. - [Social Media Scrapers](https://awesome-repositories.com/f/business-productivity-software/content-publishing/video-publishing-integrations/social-media-scrapers.md) — Collects posts, bookmarks, and user metadata from the platform for local storage and analysis. - [Profile Archivers](https://awesome-repositories.com/f/business-productivity-software/user-profile-management/profile-archivers.md) — Provides a way to backup all published albums and posts from a specific user profile into local archives. ### Graphics & Multimedia - [Media Downloaders](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/media-downloaders.md) — Retrieves images and videos from web addresses with support for file-type identification and resumable transfers. ([source](https://cdn.jsdelivr.net/gh/joeanamier/xhs-downloader@master/README.md)) - [Media Content Archivers](https://awesome-repositories.com/f/graphics-multimedia/media-production-suites/media-management-production/media-archiving/media-content-archivers.md) — Saves images and videos from profiles and search results to local storage for permanent offline use. - [Download API Interfaces](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/media-downloaders/download-api-interfaces.md) — Exposes a programmatic HTTP interface to trigger media extraction and downloads via POST requests. - [Automated Media Extractors](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/media-manipulation/media-processing/automated-media-extractors.md) — Provides a server endpoint to programmatically trigger media extraction and downloads via HTTP POST requests. ### Content Management & Publishing - [Community Content Downloaders](https://awesome-repositories.com/f/content-management-publishing/community-content-feeds/community-content-downloaders.md) — Automatically triggers the retrieval and download of user-generated content from social media libraries via clipboard monitoring. - [Content Extraction Engines](https://awesome-repositories.com/f/content-management-publishing/content-processing-transformation/content-extraction-engines.md) — Extracts structured posts, images, videos, and bookmarks from user profiles into a usable local format. ([source](https://cdn.jsdelivr.net/gh/joeanamier/xhs-downloader@master/README.md)) - [Recursive Content Crawlers](https://awesome-repositories.com/f/content-management-publishing/recursive-content-crawlers.md) — Traverses user profiles and search results recursively to collect all associated media links and metadata. - [Media Content Managers](https://awesome-repositories.com/f/content-management-publishing/content-management-systems/content-architecture-modeling/content-organization-systems/media-content-managers.md) — Implements a system for organizing downloaded media into custom local folders based on author and work metadata. - [Automated File Organizers](https://awesome-repositories.com/f/content-management-publishing/media-management/file-management-systems/automated-file-organizers.md) — Organizes downloaded media into custom folders using rule-based filename formats derived from author metadata. ([source](https://cdn.jsdelivr.net/gh/joeanamier/xhs-downloader@master/README.md)) - [Search Result Extractors](https://awesome-repositories.com/f/content-management-publishing/search-result-extractors.md) — Collects work and user links directly from the results of search query pages. ([source](https://cdn.jsdelivr.net/gh/joeanamier/xhs-downloader@master/README.md)) ### Development Tools & Productivity - [Clipboard Managers](https://awesome-repositories.com/f/development-tools-productivity/clipboard-management/clipboard-managers.md) — Monitors the system clipboard in the background to trigger automatic downloads when valid links are detected. ([source](https://cdn.jsdelivr.net/gh/joeanamier/xhs-downloader@master/README.md)) - [Automatic Triggered Downloaders](https://awesome-repositories.com/f/development-tools-productivity/clipboard-management/clipboard-managers/automatic-triggered-downloaders.md) — Functions as a background service that automatically downloads media when specific social media URLs are copied. - [Clipboard Event Listeners](https://awesome-repositories.com/f/development-tools-productivity/clipboard-management/system-clipboard-access/clipboard-event-listeners.md) — Implements a background listener that automatically initiates downloads when matching social media URLs are copied. - [Social Media Content Retrievers](https://awesome-repositories.com/f/development-tools-productivity/integration-metadata-retrievers/media-metadata-retrievers/security-protected-media-retrievers/social-media-content-retrievers.md) — Fetches media, captions, and metadata from social media profiles via a programmatic API endpoint. ### Web Development - [Social Media Extraction Tools](https://awesome-repositories.com/f/web-development/social-media-extraction-tools.md) — Provides programmatic utilities to scrape posts, bookmarks, and user profile data from the Xiaohongshu platform. - [Download Managers](https://awesome-repositories.com/f/web-development/download-managers.md) — Maintains a database of download records to manage queues and avoid redundant retrieval of the same content. ([source](https://cdn.jsdelivr.net/gh/joeanamier/xhs-downloader@master/README.md)) ### Data & Databases - [Media Deduplication](https://awesome-repositories.com/f/data-databases/data-management/media-deduplication.md) — Uses a database to track processed content identifiers, preventing redundant downloads of the same media files. - [File Storage and Metadata Management](https://awesome-repositories.com/f/data-databases/file-storage-and-metadata-management.md) — Extracts detailed work information and saves the associated metadata into local files for future reference. ([source](https://cdn.jsdelivr.net/gh/joeanamier/xhs-downloader@master/README.md)) ### Operating Systems & Systems Programming - [Filename Templates](https://awesome-repositories.com/f/operating-systems-systems-programming/system-administration-maintenance/file-system-management/file-systems/filename-templates.md) — Generates local folder structures and filenames using customizable metadata patterns based on author and work details. ### Software Engineering & Architecture - [Programmatic Extraction APIs](https://awesome-repositories.com/f/software-engineering-architecture/integration-patterns/programmatic-extraction-apis.md) — Provides a server endpoint that allows external tools to programmatically trigger content extraction and media downloads. ([source](https://cdn.jsdelivr.net/gh/joeanamier/xhs-downloader@master/README.md))