共计 1478 个字符,预计需要花费 4 分钟才能阅读完成。
开源地址:https://github.com/JoeanAmier/XHS-Downloader

视频演示:https://www.bilibili.com/video/BV1nQ4y137it/
功能清单
- ✅ 采集小红书图文 / 视频作品信息
- ✅ 提取小红书图文 / 视频作品下载地址
- ✅ 下载小红书无水印图文 / 视频作品文件
- ✅ 自动跳过已下载的作品文件
- ✅ 作品文件完整性处理机制
- ✅ 持久化储存作品信息至文件
- ✅ 作品文件储存至单独文件夹
- ☑️ 后台监听剪贴板下载作品(待支持)
- ☑️ 支持 API 调用功能(待支持)
链接支持
https://www.xiaohongshu.com/explore/作品 IDhttps://www.xiaohongshu.com/discovery/item/作品 IDhttps://xhslink.com/分享码
支持单次输入多个作品链接,链接之间使用空格分隔。
如果仅需下载无水印作品文件,建议选择 程序运行 ;如果有其他需求,建议选择 源码运行!
程序运行
Windows 10 及以上用户可前往 Releases 下载程序压缩包,解压后打开程序文件夹,双击运行 main.exe 即可使用。
若通过此方式使用程序,文件默认下载路径:.\_internal\Download;配置文件路径:.\_internal\settings.json
源码运行
- 安装版本号不低于
3.12的 Python 解释器 - 运行
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt命令安装程序所需模块 - 下载本项目最新的源码或 Releases 发布的源码至本地
- 运行
main.py即可使用
配置文件
项目根目录下的 settings.json 文件,首次运行自动生成,可以自定义部分运行参数。
如果您的计算机没有合适的程序编辑 JSON 文件,建议使用 JSON 在线工具 编辑配置文件内容
| 参数 | 类型 | 含义 | 默认值 |
|---|---|---|---|
| path | str | 作品数据 / 文件保存根路径 | 项目根路径 |
| folder_name | str | 作品文件储存文件夹名称 | Download |
| user_agent | str | 请求头 User-Agent | 默认 UA |
| cookie | str | 小红书网页版 Cookie,无需登录 | 默认 Cookie |
| proxy | str | 设置程序代理 | null |
| timeout | int | 请求数据超时限制,单位:秒 | 10 |
| chunk | int | 下载文件时,每次从服务器获取的数据块大小,单位:字节 | 1048576(1 MB) |
| max_retry | int | 请求数据失败时,重试的最大次数,单位:秒 | 5 |
| record_data | bool | 是否记录作品数据至 TXT 文件 |
false |
| image_format | str | 图文作品文件名称后缀,不影响实际文件格式 | webp |
| video_format | str | 视频作品文件名称后缀,不影响实际文件格式 | mp4 |
| folder_mode | bool | 是否将每个作品的文件储存至单独的文件夹;文件夹名称与文件名称保持一致 | false |
Cookie 获取
- 打开浏览器(可选无痕模式启动),访问小红书任意网页
- 按
F12打开开发人员工具 - 选择
控制台选项卡 - 输入
document.cookie后回车确认 - 输出内容即为所需 Cookie
如图:

备用下载地址
XHS-Downloader_V1.7
2023.12.23 更新日志:
- 优化配置文件的编码方式
- 更新无水印视频提取逻辑
- 更新无水印图片提取逻辑
- 优化无水印图片文件格式
- 优化作品文件名称格式
- 新增保存作品数据功能
- 增加作品归档保存功能
- 优化程序代码运行逻辑
- 优化 TUI 交互效果
- 其他细节优化
rztsz4
以上。
全文完