XHS-Downloader 实操教程3 种用法把小红书收藏变成本地文件【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader右键另存了一下午打开文件夹里全是电脑打不开的 HEIC 图视频存回来只有标清跟手机上看到的完全两码事——这就是手动存小红书素材的常态。XHS-Downloader 是一款免费开源的小红书下载工具它在浏览器里帮你批量圈出作品链接在本地解析作品信息、下载图文与视频格式转换和归档也一并处理好。先跑起来四行命令装好并启动运行方式有三种源码、Docker 容器、打包好的可执行文件。想最快看到效果就走源码运行前提是 Python 3.12 及以上版本git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader pip install -r requirements.txt python main.py习惯 uv 的话把后两条换成uv sync --no-dev和uv run main.py即可。启动后进的是 TUI 界面长得像图形软件但操作全靠键盘。正中间是一个大输入框把作品链接贴进去就行多条链接用空格隔开程序会自动筛出有效链接输入框正下方是一排按钮下载作品文件触发下载读取剪贴板能把剪贴板内容直接填进输入框。界面底部有快捷键提示按S进设置按M开启剪贴板监听——开启后你在任何地方复制一条小红书链接程序就自动开始下载连粘贴都省了。它兼容explore、discovery/item、user/profile三种作品链接和xhslink.com短链。从单条下载到小红书批量下载三种使用深度跑通之后按你的情况挑深度。刷到好内容顺手存从浏览器批量提取小红书作品链接适合逛着逛着想囤点素材的人。装法就三步给浏览器装 Tampermonkey 扩展新建脚本把仓库里static/XHS-Downloader.js的内容整段粘进去保存刷新小红书页面。跑起来之后页面上会多出脚本菜单能提取账号发布、收藏、点赞、专辑的作品链接也能提取搜索结果里的作品、用户和推荐页作品。提取结果自动写入剪贴板逛一圈页面几十条链接就躺在剪贴板里了切回主程序直接粘。菜单里还有推送下载任务把Volume/settings.json里的script_server设为true、保持主程序后台运行浏览器一点任务直接送到本地程序下载全程不用切窗口。容易踩的坑脚本默认不自动滚动页面你得自己往下滑加载内容再提取。设置里可以打开自动滚动但官方明确提醒过开启后可能被平台判定为自动化操作、有账号风控风险。低频操作手动滚一滚更稳妥。手里有一批链接丢进命令行批处理适合明确知道自己要下载什么的人。命令行模式把主程序的设置全变成了参数python main.py --help看一眼就能上手。三条最高频命令python main.py --url https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXX多条链接整体加引号、空格分隔python main.py --url 链接1 链接2 链接3长图集只挑几张用--index指定序号python main.py --url 作品链接 --index 1 3 5其余参数收进这张速查表参数作用什么时候用--index 1 3 5只下指定序号的图片长图集只要精选几张--image_format JPEG指定图片格式不想收到 HEIC/WEBP 时--folder_mode每个作品独立文件夹作品文件多、想分门别类--author_archive按作者归档长期追更某几个博主--update_settings把本次参数写回配置文件试到顺手想固化下来--cookie ...本次运行临时指定 Cookie不想改配置文件时坑有两个一是加了--index就只处理第一条链接多条批量时别带它二是--update_settings会把参数写回Volume/settings.json之后所有模式都沿用这套设置写之前想清楚。写脚本或搭 AI 工作流把下载能力当接口用适合做内容运营、写自动化脚本、搭 AI 工作流的人。启动 API 服务一条命令python main.py api服务默认跑在http://127.0.0.1:5556浏览器打开/docs是自动生成的交互文档。最小可用调用就这几行download为true时顺便下载文件cookie和proxy不传就沿用配置文件里的值from httpx import post resp post( http://127.0.0.1:5556/xhs/detail, json{ url: https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXX, download: True, index: [1, 3, 5], }, timeout60, ) print(resp.json())MCP 模式是给 AI 助手留的门运行python main.py mcp在支持 MCP 的客户端里配置 Streamable HTTP 服务地址填http://127.0.0.1:5556/mcp/之后直接用自然语言让它取作品信息或下载文件。坑就一个批量任务里记得把skip设为true已有下载记录的作品会被跳过不会白跑一遍。调几个配置参数修掉常见问题所有模式的参数最后都汇总到Volume/settings.json首次运行自动生成改完重启生效不想碰 JSON 就在 TUI 里按S效果一样。下面 7 个参数是体感差异最大的按新手到进阶排序参数默认值什么情况下值得改改成什么cookie空视频想要高画质不配只能拿标清浏览器里取到的web_session无需登录image_formatJPEG想要接近原图质量AUTO跟随服务器返回格式folder_modefalse作品文件多、想单独一个文件夹trueauthor_archivefalse长期追更博主、按作者归档truename_format发布时间 作者昵称 作品标题想用自己的归档命名习惯换入点赞数量、作品ID 等字段download_recordtrue文件误删后想重新下载先清掉Volume/ExploreID.db里的对应 IDvideo_preferenceresolution存储紧张、想优先小体积size或bitrate高频问题直接给解法。现象下载回来的视频只有标清。原因没配 Cookie未登录状态下只能拿到低分辨率版本。解法浏览器打开小红书任意页面按 F12在网络面板过滤web_session从任意请求里复制完整 Cookie 填进配置文件即可全程不需要登录账号。现象明明没下载过程序却直接跳过。原因下载记录默认存进Volume/ExploreID.db只要记录里有这个作品 ID哪怕文件已被你删掉也会被当作已下载。解法删掉数据库里对应的记录或者把download_record临时关掉程序会改为检查文件是否存在。现象链接经常报错、请求失败。原因作品链接自带日期信息用很久之前提取的链接容易触发风控也可能是网络本身不稳。解法改用最新提取的链接下载同时调大配置文件里的max_retry和timeout网络特殊再补上proxy比反复重启程序有效。明天先下 5 个作品试试手再把folder_mode和author_archive打开。跑顺之后刷小红书时复制即下载。想再往深走项目根目录的README.md是完整说明example.py里的XHS类调用示例是把它嵌进自己脚本的起点。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考