- name
- xiaohongshu-downloader
- description
- Download videos from Xiaohongshu (小红书) pages. Use when the user wants to save or download a video from a xiaohongshu.com URL, or mentions "小红书视频下载", "保存小红书视频", or similar requests.
Xiaohongshu Video Downloader
Download videos from Xiaohongshu (小红书) by extracting the real CDN URL from the page.
How It Works
Xiaohongshu videos use blob URLs in the browser, which cannot be downloaded directly. This skill:
- Uses browser automation to load the page (required for JS rendering)
- Extracts the real CDN video URL from the page HTML
- Downloads the video with proper headers
Method 1: Browser Automation (Recommended)
Use the browser tool to extract the video URL:
- Navigate to the Xiaohongshu page:
browser action=navigate targetUrl="https://www.xiaohongshu.com/explore/NOTE_ID"- Extract the video URL with JavaScript:
(() => {
const html = document.documentElement.outerHTML;
const mp4Matches = html.match(/https?:\/\/[^"\s]+\.mp4[^"\s]*/g);
if (mp4Matches) return [...new Set(mp4Matches)];
return null;
})()- Download with curl:
curl -L -o output.mp4 "<VIDEO_URL>" \
-H "User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36" \
-H "Referer: https://www.xiaohongshu.com/"Method 2: Python Script
For pages that don't require authentication:
python3 scripts/download_video.py "https://www.xiaohongshu.com/explore/NOTE_ID"Note: The Python script may not work for all pages due to:
- JavaScript rendering requirements
- Authentication/login requirements
- Rate limiting
Notes
- Videos are typically hosted on
xhscdn.comCDN - User-Agent and Referer headers are required to avoid 403 errors
- Output directory:
~/Downloads/xiaohongshu/ - Video URLs follow pattern:
https://sns-video-*.xhscdn.com/stream/.../*.mp4