XHS-Downloader is a downloader tool for extracting and collecting content from Xiaohongshu (RedNote), a Chinese social media platform.
The tool addresses the need to download videos, images, and metadata from Xiaohongshu posts. It works by accepting post links in various formats, extracting download URLs, and retrieving the associated media files. The project supports multiple input methods including direct link input, clipboard monitoring, and command-line arguments. It can intelligently identify file types, handle partial image downloads from multi-image posts, and resume interrupted downloads. The tool stores downloaded content in organized folders and maintains records of previously downloaded items to avoid duplication.
Developers should choose this tool if they need to programmatically access Xiaohongshu content or automate downloads at scale. It suits projects requiring batch downloading, content archival, or integration with other systems. The tool offers multiple deployment options: standalone executables for Windows and macOS, Docker containers, or source code execution. It provides both a terminal user interface for interactive use and server modes including a REST API with auto-generated documentation and an MCP (Model Context Protocol) interface for integration with AI systems. Cookie configuration is optional but recommended for accessing higher video quality. The project includes a Tampermonkey userscript for browser-based link extraction from recommendation feeds, user profiles, collections, and search results.
The project maintains active development with regular updates to handle platform changes. The codebase includes automated executable building through GitHub Actions, allowing users to build the latest source code into standalone binaries. The tool supports multiple operating systems including Windows, macOS, and Linux through Docker. Development includes code quality tooling integration and comprehensive documentation in both Chinese and English. The project provides multiple communication channels including a Discord community server for user support and feedback.
