如何快速无水印下载小红书笔记XHS-Downloader 完整教程【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-DownloaderXHS-Downloader 是一款开源的小红书笔记下载与采集工具解析作品链接、提取无水印原图与原视频地址并支持批量下载、剪贴板监听、API 与 MCP 集成。本文按链接到文件的流水线展开链接从哪来、怎么触发下载、文件如何落地、服务器怎么部署、疑难问题怎么排查。看完你就能跑通全流程。链接从哪来 最直接的方式是复制在小红书页面点击笔记的分享按钮得到的短链接形如 xhslink.com 域名程序可以直接识别explore、discovery/item、user/profile 这类官方格式的长链接同样支持。多链接时用空格分隔程序会自动提取出有效部分不用你手动清理。如果你的目标是批量收集浏览器用户脚本是更顺手的做法。安装 Tampermonkey 后导入项目自带的 static/XHS-Downloader.js小红书页面会出现一个操作菜单可以提取发布、收藏、点赞、专辑的作品链接也能提取搜索结果里的作品与用户链接。还有一种联动玩法在配置文件把 script_server 设为 true程序在后台作为服务器保持运行。你在浏览器脚本菜单里点推送下载任务任务就直接发到本地程序处理。浏览器端提取、本地端下载批量场景下这个组合很实用。触发下载界面、命令行与监听 ⚡先跑通源码方式。克隆仓库装依赖启动git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev uv run main.py启动后是 TUI 界面输入框粘贴链接点下载作品文件进度实时可见。几个快捷键能省掉大量点击——Q 退出、U 检查更新、S 进设置、R 看下载记录M 进入剪贴板监听模式。监听模式适合边刷边存开启后你继续刷小红书随手复制链接程序在后台检测到就自动下载不打断浏览。想停时在剪贴板输入 close 即可。需要更细的控制就用命令行。多链接批量下载、指定图片序号、选输出格式都可以直接传参python main.py --url 链接1 链接2 --image_format webp --folder_mode true有一点要注意使用了 --index 指定图片序号时程序只处理传入的第一个链接多链接批量就别带这个参数。文件落地命名、归档与格式 ️首次运行会在项目根目录生成 Volume/settings.json所有行为由这一个文件控制。界面交互不顺时直接编辑 JSON 再重启也一样。目录结构有两个开关folder_mode 让每个作品拥有独立文件夹方便整体搬移author_archive 按作者归档文件夹名为作者ID_作者昵称作者改名时程序会自动同步更新文件名。再配合 mapping_data 给作者设别名文件名里会用你起的别名替换昵称。文件名由 name_format 拼装可用字段包括发布时间、作者昵称、作品标题、作品ID、点赞数量等字段之间用空格排列。图文作品的 image_format 可选 AUTO、PNG、WEBP、JPEG、HEIC默认 JPEG视频侧提供分辨率优先、码率优先、文件大小优先三种偏好按需求取舍。可靠性方面也不用操心下载支持断点续传已完成的笔记 ID 会记入数据库重复下载时自动跳过。想强制重下先把对应记录删掉再跑。提升视频画质Cookie 配置 Cookie 不是必填项但有个现实差别不配置时视频作品只能拿到低清晰度源配置后才能拿到更高清的文件。而且只需要网页版 Cookie不必登录账号。获取路径很固定打开小红书探索页按 F12 打开开发者工具切到网络选项卡并勾选保留日志。在过滤框输入cookie-name:web_session选 Fetch/XHR 筛选器点击页面任意作品从请求列表里选中一个数据包把 Cookie 全选复制写进程序配置即可。服务器部署Docker、API 与 MCP 服务器或隔离环境建议直接用 Docker。以 API 模式为例挂载 Volume 卷保存数据docker run --name xhs-dl -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader python main.py apiAPI 模式自带交互式文档访问 http://127.0.0.1:5556/docs 就能看到。向 /xhs/detail 接口 POST 一个包含 url、download、index、proxy 等字段的 JSON即可返回作品信息或触发下载。MCP 模式同理运行python main.py mcp启动客户端指向 http://127.0.0.1:5556/mcp/ 就能让 AI 助手直接查询和下载作品。容器环境有一个限制需要知道Docker 下不可用剪贴板读取与监听命令行模式也不开放但粘贴链接下载功能正常。做二次开发的话看根目录 example.py 的注释就够了实例化 XHS 类传入 work_path、name_format、folder_mode 等参数再调用 extract() 拿结果这套调用可以原样搬进你自己的项目。疑难排查链接失效、慢速与环境差异 链接解析失败先怀疑时效作品链接携带日期信息复用过期的旧链接容易被风控用最新复制的链接重试。下载慢或不稳定调三个参数max_retry 加大重试次数timeout 放宽超时chunk 按网络情况调整分块大小。走公网特殊网络时在配置文件里设置 proxy。环境差异有两处macOS 的未签名可执行文件首次启动会被系统拦终端执行一次xattr -cr 项目文件夹路径即可Linux 的剪贴板功能依赖 xclip 或 xsel缺了它监听功能就不生效。以上就是 XHS-Downloader 的完整使用图景。项目的更新节奏比较快定期拉取新代码能拿到最新修复遇到本文没覆盖的问题直接在项目仓库提 Issue 反馈即可便于作者跟进处理。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何快速无水印下载小红书笔记：XHS-Downloader 完整教程
如何快速无水印下载小红书笔记XHS-Downloader 完整教程【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-DownloaderXHS-Downloader 是一款开源的小红书笔记下载与采集工具解析作品链接、提取无水印原图与原视频地址并支持批量下载、剪贴板监听、API 与 MCP 集成。本文按链接到文件的流水线展开链接从哪来、怎么触发下载、文件如何落地、服务器怎么部署、疑难问题怎么排查。看完你就能跑通全流程。链接从哪来 最直接的方式是复制在小红书页面点击笔记的分享按钮得到的短链接形如 xhslink.com 域名程序可以直接识别explore、discovery/item、user/profile 这类官方格式的长链接同样支持。多链接时用空格分隔程序会自动提取出有效部分不用你手动清理。如果你的目标是批量收集浏览器用户脚本是更顺手的做法。安装 Tampermonkey 后导入项目自带的 static/XHS-Downloader.js小红书页面会出现一个操作菜单可以提取发布、收藏、点赞、专辑的作品链接也能提取搜索结果里的作品与用户链接。还有一种联动玩法在配置文件把 script_server 设为 true程序在后台作为服务器保持运行。你在浏览器脚本菜单里点推送下载任务任务就直接发到本地程序处理。浏览器端提取、本地端下载批量场景下这个组合很实用。触发下载界面、命令行与监听 ⚡先跑通源码方式。克隆仓库装依赖启动git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev uv run main.py启动后是 TUI 界面输入框粘贴链接点下载作品文件进度实时可见。几个快捷键能省掉大量点击——Q 退出、U 检查更新、S 进设置、R 看下载记录M 进入剪贴板监听模式。监听模式适合边刷边存开启后你继续刷小红书随手复制链接程序在后台检测到就自动下载不打断浏览。想停时在剪贴板输入 close 即可。需要更细的控制就用命令行。多链接批量下载、指定图片序号、选输出格式都可以直接传参python main.py --url 链接1 链接2 --image_format webp --folder_mode true有一点要注意使用了 --index 指定图片序号时程序只处理传入的第一个链接多链接批量就别带这个参数。文件落地命名、归档与格式 ️首次运行会在项目根目录生成 Volume/settings.json所有行为由这一个文件控制。界面交互不顺时直接编辑 JSON 再重启也一样。目录结构有两个开关folder_mode 让每个作品拥有独立文件夹方便整体搬移author_archive 按作者归档文件夹名为作者ID_作者昵称作者改名时程序会自动同步更新文件名。再配合 mapping_data 给作者设别名文件名里会用你起的别名替换昵称。文件名由 name_format 拼装可用字段包括发布时间、作者昵称、作品标题、作品ID、点赞数量等字段之间用空格排列。图文作品的 image_format 可选 AUTO、PNG、WEBP、JPEG、HEIC默认 JPEG视频侧提供分辨率优先、码率优先、文件大小优先三种偏好按需求取舍。可靠性方面也不用操心下载支持断点续传已完成的笔记 ID 会记入数据库重复下载时自动跳过。想强制重下先把对应记录删掉再跑。提升视频画质Cookie 配置 Cookie 不是必填项但有个现实差别不配置时视频作品只能拿到低清晰度源配置后才能拿到更高清的文件。而且只需要网页版 Cookie不必登录账号。获取路径很固定打开小红书探索页按 F12 打开开发者工具切到网络选项卡并勾选保留日志。在过滤框输入cookie-name:web_session选 Fetch/XHR 筛选器点击页面任意作品从请求列表里选中一个数据包把 Cookie 全选复制写进程序配置即可。服务器部署Docker、API 与 MCP 服务器或隔离环境建议直接用 Docker。以 API 模式为例挂载 Volume 卷保存数据docker run --name xhs-dl -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader python main.py apiAPI 模式自带交互式文档访问 http://127.0.0.1:5556/docs 就能看到。向 /xhs/detail 接口 POST 一个包含 url、download、index、proxy 等字段的 JSON即可返回作品信息或触发下载。MCP 模式同理运行python main.py mcp启动客户端指向 http://127.0.0.1:5556/mcp/ 就能让 AI 助手直接查询和下载作品。容器环境有一个限制需要知道Docker 下不可用剪贴板读取与监听命令行模式也不开放但粘贴链接下载功能正常。做二次开发的话看根目录 example.py 的注释就够了实例化 XHS 类传入 work_path、name_format、folder_mode 等参数再调用 extract() 拿结果这套调用可以原样搬进你自己的项目。疑难排查链接失效、慢速与环境差异 链接解析失败先怀疑时效作品链接携带日期信息复用过期的旧链接容易被风控用最新复制的链接重试。下载慢或不稳定调三个参数max_retry 加大重试次数timeout 放宽超时chunk 按网络情况调整分块大小。走公网特殊网络时在配置文件里设置 proxy。环境差异有两处macOS 的未签名可执行文件首次启动会被系统拦终端执行一次xattr -cr 项目文件夹路径即可Linux 的剪贴板功能依赖 xclip 或 xsel缺了它监听功能就不生效。以上就是 XHS-Downloader 的完整使用图景。项目的更新节奏比较快定期拉取新代码能拿到最新修复遇到本文没覆盖的问题直接在项目仓库提 Issue 反馈即可便于作者跟进处理。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考