XHS Downloader
VerifiedExtract and download Xiaohongshu posts, links, and media via MCP.
What is the XHS Downloader MCP server?
Built for stdio transport, XHS Downloader integrates with MCP clients to handle link parsing and file downloads from xiaohongshu.com. It supports batch processing of multiple URLs, automatic file integrity checks, and persistent storage of downloaded content metadata.
The tool works without mandatory login but benefits from optional cookies for higher-quality video files. It records downloaded post IDs to avoid duplicates and organizes files into dedicated folders with customizable naming.
Install & connect
Add this to your MCP client config. Pick your client below and copy.
{
"mcpServers": {
"XHS-Downloader": {
"command": "uvx",
"args": [
"-i"
]
}
}
}Package: -i (pypi)
Other ways to install
pip
pip install -iDocker
docker run --name 容器名称(可选) -p 主机端口号:5556 -v xhs_downloader_volume:/app/Volume -it <镜像名称&Example prompts
Once connected, try asking your AI client:
Security & permissions
Runs locally via stdio; requires no remote API keys but can optionally read browser cookies for higher-quality downloads.
What you can do with XHS Downloader
Batch link extraction
Paste multiple Xiaohongshu post or profile URLs to extract all associated media links and metadata in one call.
Media archiving
Download images, videos, and live photos from user collections or search results while skipping already-saved files.
Metadata persistence
Save structured post information to JSON files for later analysis or reference.
How to use XHS Downloader
- 1Install Python 3.12+ and clone the XHS-Downloader repository.
- 2Run uv sync --no-dev or pip install -r requirements.txt to set up dependencies.
- 3Configure optional Cookie values in settings.json if higher video quality is needed.
- 4Start the MCP server using the provided stdio command in your client configuration.
- 5Send natural-language prompts to extract links or trigger downloads.
XHS Downloader: pros & cons
Pros
- +Handles batch URLs and automatically skips duplicates
- +Supports file resume and custom folder organization
- +Works offline after initial setup with no mandatory login
Cons
- –Cookie setup required for best video quality
- –No built-in tool schema documentation for MCP clients
- –Primarily designed for Chinese-language Xiaohongshu content
Frequently asked questions
No login is mandatory, but cookies improve video resolution.
User reviews
Verified reviews from the community shape this listing's rating.
Loading reviews…