xiaohongshu-downloader

What This Skill Does

The xiaohongshu-downloader skill is a powerful utility designed for OpenClaw agents to capture and save video content from the Xiaohongshu (小红书) platform. Because Xiaohongshu relies heavily on blob URLs and dynamic content delivery networks (CDNs), standard HTTP requests are often insufficient to capture media files directly. This skill bridges that gap by utilizing headless browser automation to render the page content, extracting the authenticated CDN source URL, and executing a robust download routine.

Installation

To integrate this capability into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/hviktortsoi/xhs-video-downloader

Use Cases

This skill is intended for users who need to archive educational content, travel guides, or creative inspirations found on the Xiaohongshu platform. It is particularly useful for content creators, researchers, and social media analysts who need to manage visual datasets efficiently. By automating the extraction process, users no longer need to rely on third-party websites or screen recording software, ensuring higher video fidelity.

Example Prompts

1. "小红书视频下载: https://www.xiaohongshu.com/explore/64a1b2c3d4e5f6g7h8i9"
2. "Can you save this Xiaohongshu video for me? Please use the downloader skill: https://www.xiaohongshu.com/explore/64a1b2c3d4e5f6g7h8i9"
3. "保存小红书视频，保存到我的下载文件夹"

Tips & Limitations

• Header Compliance: Always ensure the User-Agent and Referer headers are included; the platform frequently returns 403 Forbidden errors if these are missing or mismatched.
• Dynamic Content: Since Xiaohongshu updates its UI regularly, the JavaScript extraction logic might require updates if the page structure changes.
• Rate Limiting: Frequent requests from the same IP may trigger CAPTCHA or temporary bans. Avoid scraping content at high velocity.
• Authentication: Some private notes may remain inaccessible if they require a logged-in session, which the basic script may not handle natively without browser session persistence.
• Storage: Files are saved to ~/Downloads/xiaohongshu/ by default. Ensure your environment has write permissions for this directory before initiating a large-scale download task.