XHS-Downloader

XHS-Downloader extracts and downloads images, videos, and metadata from Xiaohongshu (RedNote/小红书) posts, profiles, and search results, with support for TUI, REST API, MCP server, and browser UserScript interfaces.

Evaluated Mar 06, 2026 (0d ago) vlatest
Homepage ↗ Repo ↗ Other xiaohongshu rednote downloader python mcp rest-api sqlite docker tui browser-extension social-media-scraping
⚙ Agent Friendliness
66
/ 100
Can an agent use this?
🔒 Security
76
/ 100
Is it safe for agents?
⚡ Reliability
69
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
65
Documentation
70
Error Messages
55
Auth Simplicity
65
Rate Limits
60

🔒 Security

TLS Enforcement
90
Auth Strength
80
Scope Granularity
65
Dep. Hygiene
75
Secret Handling
70

Community/specialized tool. Apply standard security practices for category. Review documentation for specific security requirements.

⚡ Reliability

Uptime/SLA
75
Version Stability
70
Breaking Changes
65
Error Recovery
65
AF Security Reliability

Best When

You need to batch-download or archive Xiaohongshu content locally, especially across multiple posts, profiles, or search results with deduplication.

Avoid When

You need to interact with or post to Xiaohongshu (download-only tool), or you require an account-free solution for video content (cookies needed for full quality).

Use Cases

  • • Batch downloading your own published content from Xiaohongshu for archival
  • • Researchers collecting post metadata and media from specific hashtags or user profiles
  • • Automating content extraction workflows via REST API or MCP integration
  • • Browser-based single-post downloads via UserScript without running a server

Not For

  • • Platforms other than Xiaohongshu/RedNote
  • • Large-scale commercial scraping (rate limiting and platform ToS apply)
  • • Users who need real-time streaming or push notification of new content

Interface

REST API
Yes
GraphQL
No
gRPC
No
MCP Server
Yes ↗
SDK
No
Webhooks
No

Authentication

Methods: cookie
OAuth: No Scopes: No

Operates without login for basic functionality. Optional browser cookie configuration for enhanced video quality. Supports custom User-Agent and HTTP/SOCKS proxies.

Pricing

Model: open_source
Free tier: Yes
Requires CC: No

Fully open source. No cloud service required.

Agent Metadata

Pagination
none
Idempotent
Yes
Retry Guidance
Not documented

Known Gotchas

  • ⚠ Xiaohongshu API changes can break the tool without notice
  • ⚠ Platform terms of service may prohibit automated scraping
  • ⚠ Cookie configuration required for full-quality video downloads
  • ⚠ Built-in throttling must be respected to avoid IP blocks
  • ⚠ Python 3.12+ required

Alternatives

gallery-dl yt-dlp

Full Evaluation Report

Detailed scoring breakdown, competitive positioning, security analysis, and improvement recommendations for XHS-Downloader.

$99
API endpoint ↗ Agent guide ↗ Report inaccuracy

Scores are editorial opinions as of 2026-03-06.

5182
Packages Evaluated
26151
Need Evaluation
173
Need Re-evaluation
♥
Community Powered