XHS Parser - 小红书链接解析

基于 XHS-Downloader 实现小红书链接解析和下载。

环境要求

• Python 3.12+
• XHS-Downloader 安装在 ~/projects/xhs-downloader

安装依赖

# 如果还没有 Python 3.12
brew install python@3.12

# 创建虚拟环境并安装依赖
cd ~/projects/xhs-downloader
/opt/homebrew/bin/python3.12 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

使用方式

方式1：API 模式（推荐）

cd ~/projects/xhs-downloader
source venv/bin/activate
python main.py api --port 5556

然后调用：

curl -X POST "http://127.0.0.1:5556/xhs/detail" \
  -H "Content-Type: application/json" \
  -d '{"url": "xhslink链接", "download": false}'

方式2：命令行直接下载

cd ~/projects/xhs-downloader
source venv/bin/activate
python main.py -u "小红书链接" \
  --work_path ~/Desktop/ \
  --folder_name "下载文件夹名"

支持的链接格式

• http://xhslink.com/o/xxx （短链接）
• https://www.xiaohongshu.com/explore/作品ID
• https://www.xiaohongshu.com/discovery/item/作品ID

返回字段说明

注意事项

• 不设置 Cookie 时视频只能下载低分辨率
• 链接有日期限制，建议使用最新获取的链接