小红书下载工具 XHS-Downloader 完整指南链接提取到批量下载一次搞定【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader收藏夹里躺着上百条想保存的小红书笔记复制链接复制到手酸下载完图片才发现是 HEIC 格式电脑根本打不开。如果你也在为小红书下载发愁开源的小红书下载工具 XHS-Downloader 能把这些麻烦一次性收拾干净——它既能批量提取作品链接也能采集作品信息、下载无水印图文与视频把采集—下载—归档整条流水线压缩成一次操作。读完你将掌握用浏览器脚本在页面上批量圈链接几十上百条作品链接自动进剪贴板用 TUI 主界面一次粘贴多条链接一键拿下无水印图文与视频文件用命令行参数实现指定图片、指定格式的自动化下载用 API / MCP 把下载能力接入自己的程序与 AI 工作流用配置文件调教下载行为绕开 Cookie、格式、重复下载等高频坑三十秒上手装好依赖跑通第一条下载 老规矩先把工具请回家。项目基于 Python 3.12克隆后用 pip 装依赖即可git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader pip install -r requirements.txt python main.py用 uv 的话更省事uv sync之后直接uv run main.py。第一次运行会在Volume文件夹里自动生成settings.json配置文件不用手动创建任何东西。懒得装 Python 的也可以用docker pull joeanamier/xhs-downloader拉镜像跑。程序启动后是一个终端图形界面把任意一条小红书作品链接粘进输入框点绿色按钮下载无水印作品文件剩下的交给它。到这里事情已完成一大半。提示从 2.2 版本开始正常使用基本无需手动配置 Cookie开箱即用。把链接变成文件TUI 主界面一次粘贴多条链接 对不熟悉命令行的新手来说这款小红书下载工具最友好的入口就是 TUI 主界面。它长在终端里但操作方式像图形软件全程键盘可控比纯命令行友好得多。主界面正中是一个输入框支持一次粘贴多条链接链接之间用空格分隔即可程序会自动提取有效链接不用你手动清洗。支持的链接格式有链接类型示例探索页https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXX发现页https://www.xiaohongshu.com/discovery/item/作品ID?xsec_tokenXXX个人主页https://www.xiaohongshu.com/user/profile/作者ID/作品ID?xsec_tokenXXX分享短链https://xhslink.com/分享码点下下载按钮后程序会自动跳过已下载过的作品、支持断点续传、下载 livePhoto 动图还能按你设置的格式保存图片全程无需干预。想要下载小红书无水印图文与视频这是最省心的入口。在页面里圈链接小红书作品链接提取与批量入剪贴板 下载的前提是有链接。如果一条条手动复制攒一百条就要点一百次手都会抽筋。这时候轮到用户脚本出场——装好 Tampermonkey 扩展后导入项目里的static/XHS-Downloader.js打开小红书页面侧边就会多出一个功能菜单。脚本支持一键提取推荐页面的作品链接账号发布、收藏、点赞、专辑的作品链接搜索结果的作品链接与用户链接提取结果自动写入剪贴板还支持自动滚动页面加载更多内容默认关闭可在脚本设置里打开滚动次数也能自定义。这一步的关键在于你不再需要逐条复制逛一圈页面几十上百条链接就已经躺在剪贴板里转身粘进主程序就能实现小红书批量下载。提示脚本只做可见即可得的数据提取不涉及任何破解功能自动滚动建议谨慎开启避免被平台判定为自动化操作。一条命令直达硬盘XHS-Downloader 命令行批量下载 ⌨️如果你习惯终端操作或者想把下载写进定时任务小红书下载工具的命令行模式会更顺手。它把主程序的所有设置都变成了命令参数敲一句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 https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXX --index 1 3 5常用参数速查参数简写作用--url-u作品链接多个用空格分隔--index-i只下载指定序号的图片--image_format-if图片格式命令行下支持 PNG / WEBP--cookie-ck小红书网页版 Cookie--proxy-p网络代理--folder_mode-fm每个作品存进单独文件夹--author_archive-aa按作者归档文件夹名为作者ID_作者昵称--language-l界面语言zh_CN / en_US--update_settings-us把本次命令行参数写回配置文件--browser_cookie-bc从浏览器读取 Cookie提示未设置--index时支持传入多个链接设置了--index后程序只处理首个作品链接注意别混用。把采集能力开放出去API 与 MCP 接入程序与 AI 前几个场景都是人操作机器这一节反过来让别的程序来调用小红书下载工具。这对开发者和 AI 工具用户特别有价值。启动 API 模式只需一条命令python main.py api服务默认跑在http://127.0.0.1:5556浏览器打开/docs就能看到自动生成的交互式文档。核心接口是POST /xhs/detail传 JSON 即可获取作品信息或触发下载import httpx resp httpx.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 的客户端里配置一个可流式传输的 HTTP 服务地址填http://127.0.0.1:5556/mcp/AI 就能直接指挥它采集作品信息或下载文件这样一来你的微信公众号机器人、自动化脚本、AI 工作流都能复用这套采集能力把小红书内容采集从手动操作升级成程序调用。效率技巧三个省事的组合玩法 ⚡1. 用户脚本 主程序联动一键推送下载任务。在配置文件里把script_server设为true让主程序在后台运行浏览器里点用户脚本菜单的推送下载任务链接直接发给程序处理连剪贴板都不用碰。2. 命名与归档一次调好文件从此井井有条。name_format支持收藏数、点赞数、作品ID、发布时间、作者昵称等十余个字段配合folder_mode每作品一个文件夹、author_archive按作者建文件夹、write_mtime把文件修改时间改成发布时间归档习惯直接固化成默认。3. 命令行参数一键写回配置。用--update_settings参数运行一次本次命令行设置就会写进settings.json下次开主程序也沿用同样配置。懒得折腾界面的直接编辑Volume/settings.json也行改完重启生效。几个最值得动手的配置项配置项默认值说明image_formatPNG图片格式支持 AUTO / PNG / WEBP / JPEG / HEICname_format发布时间 作者昵称 作品标题文件命名规则folder_modefalse每个作品单独一个文件夹author_archivefalse按作者建文件夹昵称变更自动更新download_recordtrue记录已下载作品 ID避免重复下载write_mtimefalse把文件修改时间改成作品发布时间cookie空非必需但建议配置script_serverfalse用户脚本联动开关避坑清单三个高频问题一次说清 1. 视频画质太低怎么办原因未配置 Cookie 时视频作品只能下载低分辨率版本。办法去浏览器访问小红书任意页面按 F12 打开开发者工具在网络面板里过滤web_session从任意请求中复制完整的 Cookie 填入程序即可无需登录账号。2. 重复下载同一作品原因程序默认开启下载记录功能已下载过的作品 ID 会存在Volume/ExploreID.db数据库里再次下载会被自动跳过。办法如果文件被误删想重下先清理数据库里对应的作品 ID或暂时关闭download_record配置。3. 请求经常失败或超时原因平台对高频请求有风控或者你的网络环境不稳定。办法程序内置了请求延时机制你还可以在配置里调大max_retry失败重试次数和timeout超时时间网络环境特殊的话设置proxy代理即可。把采集变成你的日常习惯 一句话总结小红书下载工具 XHS-Downloader 把提取链接—采集信息—下载文件—归档落盘整条链路串成了一次操作新手用TUI 主界面 用户脚本组合就够用进阶玩家再补上命令行和 API / MCP下载能力就彻底长在自己手里了。还想更进一步的翻一翻项目里的 example.py里面的XHS类把全部能力封装成了可调用的代码几行就能把下载嵌进你自己的脚本——这才是这个工具的终极打开方式。完整的配置参数清单在 README.md 里收藏本文下次更新回来看看。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考