极速上手XHS-Downloader3分钟保姆级教程免费下载小红书无水印图文与视频【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader想保存小红书里的高清图片和视频结果不是带水印就是被压缩成马赛克截图裁边、录屏剪辑折腾半天画质还是惨不忍睹别再手动存图了——XHS-Downloader就是一款专治小红书无水印下载的开源作品采集工具完全免费、无需登录图文与视频都能以原画质一键保存Windows、macOS、Linux 全平台可用。读完本文你将获得✅ 3 条难度递进的上手路径直接运行、Docker 部署、源码启动✅ 两种下载姿势图形界面粘贴即下、命令行批量下载✅ 文件命名规则、图片格式、保存路径等自定义技巧✅ 下载失败、批量采集等高频问题的排查方案工具速览它到底能帮你做什么XHS-Downloader 基于 AIOHTTP 模块开发定位是小红书链接提取/作品采集工具核心能力一句话概括把小红书网页版上你能看到的内容原画质搬运到本地。采集作品信息标题、描述、点赞、收藏、评论、标签等一键抓取提取下载地址自动解析图片、视频、动图livePhoto的真实直链无水印下载直接保存原始画质文件自动跳过重复文件支持断点续传批量操作多链接同时提交、后台监听剪贴板、记录已下载作品 ID使用场景说明单篇图文/视频粘贴链接直接下载多个作品空格分隔链接一次提交账号全量采集配合用户脚本批量提取发布/收藏/点赞/专辑链接开发者接入API 模式与 MCP 模式可二次开发支持的链接格式点击展开https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXXhttps://www.xiaohongshu.com/discovery/item/作品ID?xsec_tokenXXXhttps://www.xiaohongshu.com/user/profile/作者ID/作品ID?xsec_tokenXXXhttps://xhslink.com/分享码短链分享提示链接末尾的xsec_token参数建议保留程序会自动提取有效链接无需手动清理。上手路径三种方式按需选择方式一直接运行程序包零基础首选前往项目发布页下载对应系统的程序压缩包Windows / macOS / Linux解压后双击运行main即可无需安装 Python 或任何依赖。 macOS 用户首次运行如被系统拦截先在终端执行xattr -cr 项目文件夹路径移除安全标记之后就能正常打开了。适合人群只想快速下载、不想折腾环境的新手。方式二Docker 容器部署技术用户已装 Docker 的话两条命令即可拉起一个隔离环境docker pull joeanamier/xhs-downloader docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader容器内数据统一存放在Volume卷中便于备份与迁移。注意 Docker 模式不支持命令行调用、剪贴板读取与监听。适合人群熟悉容器、希望环境与系统隔离的用户。方式三源码运行开发者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。需要 Python 3.12 及以上版本。适合人群想跟进最新功能、参与二次开发的用户。核心操作两种下载模式任选场景一图形界面模式粘贴链接即下载启动程序进入交互式操作界面打开小红书复制作品链接分享复制或地址栏复制均可将链接粘贴到输入框中支持一次粘贴多个空格分隔点击「下载作品文件」按钮等待任务完成下载完成后文件默认保存在程序目录下的Volume/Download文件夹中文件名按发布时间 作者昵称 作品标题自动命名。场景二命令行模式一条命令批量下载命令行模式适合快速操作也支持图文作品按序号挑选图片# 下载单个作品 python main.py -u https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXX # 批量下载多个作品链接用空格分隔 python main.py -u 链接1 链接2 链接3 # 只下载图文作品的第1、3、5张图片 python main.py -u 作品链接 -i 1 3 5 # 临时指定保存路径 python main.py -u 作品链接 -wp D:/xhs_download更多参数代理、超时、语言切换等可通过python main.py -h查看完整说明。进阶玩法自定义设置与 API 集成自定义文件命名格式首次运行后程序会在Volume/settings.json生成配置文件。修改name_format即可定制文件名name_format: 作者昵称 作品ID 作品标题可用字段包括作品标题、作品描述、发布时间、作者昵称、作者ID、作品ID、作品类型、点赞/收藏/评论/分享数量、作品标签、最后更新时间等字段间用空格分隔。切换图片下载格式image_format参数控制图片输出格式可选AUTO、PNG、WEBP、JPEG、HEICPNG无损画质文件偏大WEBP压缩率高、质量好兼顾画质与体积JPEG兼容性最好通用场景首选HEIC高效压缩Apple 设备原生支持启动 API 服务接入自己的程序python main.py api服务启动后访问http://127.0.0.1:5556/docs可查看交互式接口文档调用示例import requests resp requests.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], }, timeout10, ) print(resp.json())如果你在用 AI 编程助手还可以通过python main.py mcp启动 MCP 服务把获取小红书数据/下载作品文件作为工具直接接入智能体。常见问题解决方案Q1下载失败或视频画质偏低怎么办XHS-Downloader 的 Cookie 配置是非必需的但不配置 Cookie 时视频默认只能下载低分辨率版本。建议按以下步骤补充 Cookie打开浏览器访问小红书网页版可开无痕模式按下F12打开开发者工具切换到「网络」选项卡并勾选「保留日志」在过滤框输入cookie-name:web_session点击任意一篇作品在请求数据包中全选复制 Cookie 值粘贴到程序设置或settings.json的cookie参数中获取 Cookie 无需登录账号不影响正常使用。若下载依然失败可尝试更新程序版本、检查网络代理或在命令行模式加--debug查看详细日志。Q2如何批量下载一个账号的全部作品推荐用户脚本 主程序的组合拳给浏览器安装 Tampermonkey 扩展并添加项目自带的用户脚本进入作者主页后即可一键提取发布、收藏、点赞、专辑的全部作品链接再把这些链接交给主程序批量下载。若在配置文件中把script_server设为true脚本还能把下载任务直接推送给后台运行的程序实现全自动。Q3下载文件默认存在哪里如何改路径源码运行默认保存到Volume/Download打包版程序保存在_internal/Volume/Download。三种改法任选在图形界面设置中修改「下载路径」编辑settings.json中的work_path与folder_name命令行加-wp 自定义路径临时指定总结合规使用也欢迎加入开源社区至此你已经掌握了 XHS-Downloader 的核心玩法从零开始安装、两种下载模式、命名与格式自定义再到 API/MCP 二次开发基本覆盖了日常所有使用场景。这款工具最大的价值在于免费、轻量、无广告把下载小红书无水印作品这件事做到了极致。最后提醒两点一是作品链接带有日期信息建议用最新获取的链接下载避免被风控二是请尊重原创作者的版权合理使用下载内容不要将工具用于任何侵权或违规用途。如果你喜欢这个项目可以这样支持它⭐ 在项目仓库点个 Star让更多人看到 遇到问题去 Issues 提交反馈附上复现步骤和日志 通过 Pull Request 贡献代码修复 Bug 或增加新功能 把使用技巧分享给需要的朋友帮助项目良性成长你的每一次参与都是开源项目持续迭代的动力。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
