joeanamier/xhs-downloader

XHS-Downloader is a Python tool for downloading content from XiaoHongShu, a Chinese social media platform known in English as RedNote or Little Red Book. The platform is popular for lifestyle posts, product reviews, and short-form content that mixes images, video, and text. The tool accepts a link to a post on XiaoHongShu and downloads the media attached to it: photos, videos, and live photos. It can also pull lists of post links from a user's profile, covering their published posts, saved favorites, liked posts, and collections. Extracting links from search results is also supported. Beyond individual downloads, the tool can monitor your clipboard in the background and start a download automatically when it detects a valid XiaoHongShu link. It tracks which files it has already downloaded to skip repeats, and supports resuming interrupted downloads rather than starting from scratch. Files can be saved into per-post folders with customizable naming formats, and post metadata can be saved alongside the downloaded media. The tool runs in several modes: an interactive terminal interface, a command-line mode where you pass links as arguments, an API server mode using FastAPI with auto-generated documentation, and an MCP mode for connecting the tool to AI systems. A browser user script is also included for downloading directly from the web page without running a local program. Docker is supported for all server modes. The README is primarily in Chinese with an English version linked at the top. Python 3.12 or higher is required to run the project from source.