XHS-Downloader 使用教程3 分钟跑通小红书无水印下载【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-DownloaderXHS-Downloader 是一款免费的 Python 开源工具专门做小红书无水印下载粘贴作品链接它就把图文或视频原样存到本地还提供批量保存账号作品和 API 接口。三分钟跑通从安装到第一次保存先确认本机装了 Python 3.12 及以上版本然后按下面顺序敲四条命令即可获取项目、装好依赖并启动程序。git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev # 没有 uv 就用pip install -r requirements.txt python main.py程序启动后会出现图形界面窗口。在输入框里粘贴任意一条小红书作品链接点「下载作品文件」稍等片刻无水印的图文或视频就存到本地了嫌手动粘贴麻烦可以直接点「读取剪贴板」。三个典型场景各走各的路单个作品识别这些链接格式就能下把下面任一格式的链接贴进输入框程序都能识别https://www.xiaohongshu.com/explore/作品IDhttps://www.xiaohongshu.com/discovery/item/作品IDhttps://www.xiaohongshu.com/user/profile/作者ID/作品IDhttps://xhslink.com/短链码输入框一次可以放多个链接用空格分隔即可批量下载。手机上复制出的短链不用转换直接粘就行。账号级批量一次性抓走发布、收藏、点赞作品要下载某个账号名下的内容最快的路是配合项目自带的浏览器用户脚本。在账号主页点脚本菜单里的「提取发布作品链接」「提取点赞作品链接」「提取收藏作品链接」页面会自动滚动加载并复制全部链接账号专辑、搜索结果里的作品链接和用户链接也能这样批量抓。提取结果都在剪贴板里回到程序输入框点「读取剪贴板」再触发一次下载就完成了小红书批量下载工具这一环。自动化联动用户脚本直接推送下载任务装好用户脚本后可以省掉复制粘贴这一步让 XHS-Downloader 在后台保持运行访问任意作品页时点脚本菜单里的「推送下载任务」链接会直接发给本地程序处理。在脚本设置中填入程序生成的鉴权令牌后即可用浏览到想存的笔记顺手推一下适合边刷边攒素材。进阶玩法命令行、API 与 MCP命令行常用参数习惯终端的话直接带参数调用四条命令覆盖最常用的用法python main.py --url https://xhslink.com/xxx python main.py --url 链接1 链接2 链接3 python main.py --url 作品链接 --index 1 3 5 # 只下载图集第 1、3、5 张 python main.py --url 作品链接 --work_path D:\XHS --cookie Cookie 值加--help可以看全部参数比如--folder_mode每个作品独立文件夹、--video_preference视频偏好。API 与 MCP 模式API 模式适合二次开发和系统对接MCP 模式则让 AI 助手直接调用下载能力两者都要携带启动时终端输出的鉴权令牌。python main.py api python main.py mcp模式端点用途APIhttp://127.0.0.1:5556/docsPOST/xhs/detail请求头带Authorization: Bearer 令牌即可下载作品example.py 里有完整调用示例MCPhttp://127.0.0.1:5556/mcp在 MCP 客户端添加该地址类型选可流式传输的 HTTPAI 助手即可发起下载文件存成什么样由你定默认情况下文件保存在项目根目录的Volume/Download里首次运行会生成Volume/settings.json改这一份配置就能固定你的保存习惯。配置项作用示例值work_path作品数据与文件的保存根路径D:\XHSfolder_name作品文件所在文件夹名Downloadname_format文件命名模板可组合多个字段发布时间 作者昵称 作品标题image_format图文下载格式JPEGfolder_mode每个作品是否独立文件夹falseauthor_archive每个作者是否独立文件夹false高清视频下载建议配上 Cookie不配也能下但视频画质受限。获取步骤浏览器无痕模式打开https://www.xiaohongshu.com/exploreF12 打开开发者工具 →「网络」勾选「保留日志」点进任意作品在请求头里找到带web_session的那条整段复制粘贴到程序的 Cookie 配置项即可视频就能下到更高清晰度。卡住了先看这里三类高频问题按这个顺序排查链接无效确认贴的是作品链接而不是纯用户主页短链或长链接都试试必要时换一个 Cookie。下载卡顿先检查网络与代理配置请求走不通时调大timeout和max_retry。保存失败看磁盘空间和work_path所在目录的写入权限路径里避免特殊字符。性能参数方面三个建议timeout按网络情况放宽、大文件用大一点的chunk、断点续传保持默认开启中断后再跑同一批链接即可接着下。下载的内容请留作个人学习研究尊重原创作者的权益并遵守小红书平台的服务条款。控制批量频率把工具用在该用的地方。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/11/3 19:12:32 · 阅读 1.2k XHS-Downloader 使用教程：3 分钟跑通小红书无水印下载
XHS-Downloader 使用教程3 分钟跑通小红书无水印下载【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-DownloaderXHS-Downloader 是一款免费的 Python 开源工具专门做小红书无水印下载粘贴作品链接它就把图文或视频原样存到本地还提供批量保存账号作品和 API 接口。三分钟跑通从安装到第一次保存先确认本机装了 Python 3.12 及以上版本然后按下面顺序敲四条命令即可获取项目、装好依赖并启动程序。git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev # 没有 uv 就用pip install -r requirements.txt python main.py程序启动后会出现图形界面窗口。在输入框里粘贴任意一条小红书作品链接点「下载作品文件」稍等片刻无水印的图文或视频就存到本地了嫌手动粘贴麻烦可以直接点「读取剪贴板」。三个典型场景各走各的路单个作品识别这些链接格式就能下把下面任一格式的链接贴进输入框程序都能识别https://www.xiaohongshu.com/explore/作品IDhttps://www.xiaohongshu.com/discovery/item/作品IDhttps://www.xiaohongshu.com/user/profile/作者ID/作品IDhttps://xhslink.com/短链码输入框一次可以放多个链接用空格分隔即可批量下载。手机上复制出的短链不用转换直接粘就行。账号级批量一次性抓走发布、收藏、点赞作品要下载某个账号名下的内容最快的路是配合项目自带的浏览器用户脚本。在账号主页点脚本菜单里的「提取发布作品链接」「提取点赞作品链接」「提取收藏作品链接」页面会自动滚动加载并复制全部链接账号专辑、搜索结果里的作品链接和用户链接也能这样批量抓。提取结果都在剪贴板里回到程序输入框点「读取剪贴板」再触发一次下载就完成了小红书批量下载工具这一环。自动化联动用户脚本直接推送下载任务装好用户脚本后可以省掉复制粘贴这一步让 XHS-Downloader 在后台保持运行访问任意作品页时点脚本菜单里的「推送下载任务」链接会直接发给本地程序处理。在脚本设置中填入程序生成的鉴权令牌后即可用浏览到想存的笔记顺手推一下适合边刷边攒素材。进阶玩法命令行、API 与 MCP命令行常用参数习惯终端的话直接带参数调用四条命令覆盖最常用的用法python main.py --url https://xhslink.com/xxx python main.py --url 链接1 链接2 链接3 python main.py --url 作品链接 --index 1 3 5 # 只下载图集第 1、3、5 张 python main.py --url 作品链接 --work_path D:\XHS --cookie Cookie 值加--help可以看全部参数比如--folder_mode每个作品独立文件夹、--video_preference视频偏好。API 与 MCP 模式API 模式适合二次开发和系统对接MCP 模式则让 AI 助手直接调用下载能力两者都要携带启动时终端输出的鉴权令牌。python main.py api python main.py mcp模式端点用途APIhttp://127.0.0.1:5556/docsPOST/xhs/detail请求头带Authorization: Bearer 令牌即可下载作品example.py 里有完整调用示例MCPhttp://127.0.0.1:5556/mcp在 MCP 客户端添加该地址类型选可流式传输的 HTTPAI 助手即可发起下载文件存成什么样由你定默认情况下文件保存在项目根目录的Volume/Download里首次运行会生成Volume/settings.json改这一份配置就能固定你的保存习惯。配置项作用示例值work_path作品数据与文件的保存根路径D:\XHSfolder_name作品文件所在文件夹名Downloadname_format文件命名模板可组合多个字段发布时间 作者昵称 作品标题image_format图文下载格式JPEGfolder_mode每个作品是否独立文件夹falseauthor_archive每个作者是否独立文件夹false高清视频下载建议配上 Cookie不配也能下但视频画质受限。获取步骤浏览器无痕模式打开https://www.xiaohongshu.com/exploreF12 打开开发者工具 →「网络」勾选「保留日志」点进任意作品在请求头里找到带web_session的那条整段复制粘贴到程序的 Cookie 配置项即可视频就能下到更高清晰度。卡住了先看这里三类高频问题按这个顺序排查链接无效确认贴的是作品链接而不是纯用户主页短链或长链接都试试必要时换一个 Cookie。下载卡顿先检查网络与代理配置请求走不通时调大timeout和max_retry。保存失败看磁盘空间和work_path所在目录的写入权限路径里避免特殊字符。性能参数方面三个建议timeout按网络情况放宽、大文件用大一点的chunk、断点续传保持默认开启中断后再跑同一批链接即可接着下。下载的内容请留作个人学习研究尊重原创作者的权益并遵守小红书平台的服务条款。控制批量频率把工具用在该用的地方。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考