XiaoHongShu, or 'Red' as it's known in English, is a massive social and e-commerce platform that's notoriously difficult to save content from. If you've ever wanted to archive a favorite creator's posts, back up your own work, or analyze trends, you've likely run into a wall. XHS-Downloader is a powerful open-source tool that demolishes that wall, offering a suite of options for nearly every kind of user.
At its core, XHS-Downloader is a scraper. It takes a link to a XiaoHongShu post, profile, collection, or even a search result, and it downloads the associated media—images, videos, and even Apple's Live Photos—along with metadata. But calling it just a scraper undersells its flexibility. It’s a Swiss Army knife for accessing XiaoHongShu content.
A Flexible Toolkit for Every User
The project's greatest strength is that it caters to multiple audiences through its various modes of operation.
For non-technical users, the simplest entry point is the pre-built executable for Windows and macOS. You download a zip file, extract it, and double-click an icon. This launches a clean, text-based interface (TUI) in your terminal that guides you through pasting links and downloading files. It's about as user-friendly as a command-line program can get.
For those who prefer to automate, the command-line interface (CLI) is robust. You can pass URLs and various flags to script downloads, making it perfect for regular backups. The tool is packed with thoughtful features that show a mature understanding of the task: it can automatically skip files it has already downloaded, allows for custom file and folder naming conventions, and can even resume interrupted downloads. It also includes a Tampermonkey userscript, allowing you to extract links directly from your browser as you browse the XiaoHongShu site.
For developers, XHS-Downloader offers two server modes that turn it into a backend service. The API mode exposes its functionality over a standard REST API, complete with auto-generated interactive documentation. This means you could build your own web application or archival system on top of it. Even more forward-looking is the MCP (Model Context Protocol) mode. This allows the tool to be integrated as a 'skill' or 'plugin' for compatible large language models, hinting at a future where you could simply ask an AI assistant to "archive all cooking tutorials from user X on Red" and have it use XHS-Downloader to fulfill the request.
The Reality of Scraping: Setup and Rough Edges
While powerful, the tool isn't without its hurdles. The biggest is a problem shared by all scrapers: authentication. To download the highest quality media and avoid rate limits, you need to provide a Cookie from a logged-in browser session. The README is admirably honest that its previous feature to automatically read this from your browser is broken and no longer maintained. This means you have to dive into your browser's developer tools, find the cookie, and paste it into a configuration file. It's a tedious but necessary step, and one you may have to repeat periodically.
Setup is mostly smooth, especially with the pre-built programs, but Mac users will face a one-time ritual of running a terminal command to bypass Apple's security warnings for unsigned applications. It’s a simple copy-paste, but it’s a speed bump. Furthermore, while an English README exists, the project's soul is Chinese. The screenshots in the documentation, the primary language of the TUI, and likely the bulk of the community on the official Discord server are in Chinese. This isn't a critical flaw, but it's a barrier for non-speakers seeking community support.
Project Health and a Place in Your Stack
With over 12,000 stars on GitHub, XHS-Downloader is clearly popular and trusted. The list of open issues is surprisingly low (under 30), which suggests the existing codebase is stable for its main purpose. However, development appears to have slowed. The last release was in February 2026, about six months ago. This isn't necessarily a sign of abandonment—the tool may be considered feature-complete—but it does mean that if XiaoHongShu makes a significant change to its site, a fix might not be immediate.
For a data professional or developer, XHS-Downloader is a solid choice for the 'extraction' phase of an ETL pipeline focused on XiaoHongShu. Its API allows it to be neatly integrated as a microservice that feeds raw media and metadata into a larger data processing or storage system. For a marketer or content creator, it's a best-in-class standalone tool for archival and analysis. Despite the minor setup quirks and the universal pain of cookie management, its power and flexibility are unmatched in the open-source space for this specific platform.