小红书下载工具 XHS-Downloader 完整上手指南3 个场景讲透链接提取、作品采集与文件下载【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader收藏夹里躺着几百条小红书笔记真到做选题、攒素材时却一条都调不出来——不是内容没用是它们从来没离开过 App。XHS-Downloader是一款开源的小红书下载工具把账号页、搜索结果、推荐流里的作品链接批量提取出来再采集作品信息、下载图文与视频文件全程不要求你登录。整条找链接—取文件—归档的流程可以压缩成几分钟的事。它的分工很清晰浏览器侧的用户脚本负责收集链接终端侧的主程序负责下载需要自动化时命令行和本地服务随叫随到。下面不绕理论直接跟你走三个最真实的场景。场景一 · 批量提取作品链接逛一圈页面链接就进剪贴板 收集素材最烦的往往不是下载而是复制链接。一条笔记点开、复制、返回三百条就要重复三百次。装好用户脚本后这件事就变成了逛完即得。先给浏览器装 Tampermonkey再导入项目里的static/XHS-Downloader.js刷新任意小红书页面侧边就多出一个功能菜单。菜单里能一键提取推荐页的作品链接账号的发布、收藏、点赞、专辑作品链接搜索结果里的作品链接与用户链接默认情况下提取结果会自动写进剪贴板。脚本还提供自动滚动加载更多的开关页面划不到底时让它自己滚滚动次数也能自定义。建议批量提取时关掉自动滚动慢慢逛别让平台把你当成机器人。逛完这一圈剪贴板里就是一长串干净的作品链接。场景二 · 批量下载作品文件粘贴链接等文件落进硬盘 有了链接剩下的事交给 TUI 主程序。在项目根目录执行python main.py界面中央是一个输入框——把剪贴板里那一长串链接一次性粘进去空格分隔即可程序会自动筛出有效链接然后点下载作品文件。这一步程序替你扛掉了大部分琐事重复下载的自动跳过、中断的断点续传、图文动图livePhoto的下载、图片按你选好的格式转换保存。下载完成后文件按默认规则命名整整齐齐躺在Volume/Download目录里。如果你只是偶尔收几条到这里已经够用但要是每周都要批量处理接着看场景三。场景三 · 命令行批量下载一条命令接管全部链接手动点按钮还是慢命令行模式把主程序的设置全部变成了参数适合写进脚本、挂进定时任务。最常用的三条命令记住就够python main.py --url 链接1 链接2 链接3 python main.py --url 作品链接 --index 1 3 5 python main.py --url 作品链接 --cookie 你的Cookie --image_format PNG第一条批量下载第二条只取图文作品的第 1、3、5 张图第三条是典型组合——带上 Cookie 拉高视频画质、指定图片格式。想让每个作品单独建文件夹就用--folder_mode想按作者归档就用--author_archive参数名和配置文件里的字段一一对应猜也能猜个八九不离十。实在记不住python main.py --help会把全部参数列成一张表。末尾加个--update_settings还能把这次的命令行参数写回配置文件下次 TUI 里直接生效。配置文件与 Cookie把下载行为调成你的规矩默认设置不会刚好贴合每个人的归档习惯好在所有行为都集中在Volume/settings.json一个文件里改完重启生效。几个值得动手的字段默认值它控制什么image_formatJPEG图片格式想保留原样就设 AUTOname_format发布时间 作者昵称 作品标题文件命名规则可加点赞数、作品 ID 等字段folder_modefalse开启后每个作品单独一个文件夹author_archivefalse按作者归文件夹昵称变了也会自动更新download_recordtrue记录已下载作品避免重复拉取write_mtimefalse把文件修改时间改成作品发布时间video_preferenceresolution视频优先分辨率、码率还是体积其中最值得配的是cookie。不配 Cookie 时视频只能拿到低分辨率版本。获取方法浏览器打开小红书任意页面按 F12 进开发者工具在网络面板里过滤web_session从任意请求的请求头复制整段 Cookie 填进来无需登录。API 与 MCP把下载能力开放给程序与 AI 如果你不满足于自己用python main.py api会在http://127.0.0.1:5556起一个本地服务浏览器打开/docs就能看到交互式接口文档POST /xhs/detail传一个 JSON 就能拿作品信息或触发下载。写几行脚本就能把下载能力嵌进自己的工作流。更省事的是 MCP 模式python main.py mcp启动后在支持 MCP 的 AI 客户端里配一个 Streamable HTTP 服务地址填http://127.0.0.1:5556/mcp/AI 助手就能直接指挥它获取数据、下载文件。想做深度二次开发example.py里XHS类的调用示例是最短的入门教材。三个高频问题现象、原因、解法 ⚠️视频画质低。现象下载的视频总是糊的。原因没配 Cookie拿不到高分辨率源。解法按上文把 Cookie 填进配置或命令行。同一个作品反复下载。现象明明下过还在下。原因下载记录Volume/ExploreID.db里没有对应条目比如文件被手动删除后。解法清掉数据库里对应作品的记录再下载或临时关掉download_record。请求偶发失败或超时。现象下载到一半报错。原因网络波动或触发平台风控。解法调大max_retry和timeout网络环境特殊就配上proxy。现在就能把它跑起来获取方式很直接git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader后用pip install -r requirements.txt或uv sync --no-dev装好依赖执行python main.py即可不想折腾环境直接用 Docker 镜像。跑通第一条链接、看到第一个规整的文件夹你就算从小红书手动搬运工毕业了——剩下的时间留给你真正该做的事。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考