小红书下载工具实战指南XHS-Downloader 一站式批量采集图文与视频【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader设想一个很常见的场景你在小红书刷到一篇高质量的旅行攻略想把它收进自己的资料库慢慢研究或者你负责账号运营需要把竞品最近一个月发布的笔记全部拉下来做内容分析。小红书本身没有一键保存截图拿不到原图视频更是无从下手。XHS-Downloader 正是为解决这类需求而生的开源小红书下载工具它能批量提取账号发布、收藏、点赞、专辑中的作品链接采集作品信息并自动下载图文、视频与 livePhoto 文件把存不下来变成批量带走。一张能力清单它到底能做什么在动手之前先看清这套工具覆盖了哪些环节。简单来说XHS-Downloader 横跨找链接、取信息、下文件、管文件四个阶段能力维度具体能力使用价值链接提取账号发布、收藏、点赞、专辑作品链接一次拿到某个博主或自己账号下的全部作品入口链接提取搜索结果的作品链接与用户链接按关键词批量锁定目标内容与账号信息采集作品标题、描述、标签、互动数据等无需下载也能沉淀结构化内容数据文件下载图文、视频、livePhoto 文件支持断点续传、完整性校验与格式选择文件管理按作者归档、自定义命名、去重记录下载结果自动整理更新程序也不丢记录它支持https://www.xiaohongshu.com/explore/作品ID、discovery/item、user/profile以及xhslink.com分享码等多种链接形式单次可以粘贴多个链接用空格分隔即可程序会自动提取有效部分不用你手工清洗。四种运行形态按你的场景挑选同样是这套工具XHS-Downloader 提供了四种入口覆盖从零基础用户到开发者的全部人群运行形态适合谁亮点图形界面TUI普通用户、新手可视化操作支持读取与监听剪贴板命令行CLI技术用户、脚本化任务参数丰富可批量、可定时、可指定图片序号浏览器用户脚本网页端重度用户边逛边提取还能向主程序推送下载任务API / MCP 服务开发者、AI 工作流开放 5556 端口可接入自建系统其中图形界面基于终端渲染主界面提供下载作品文件读取剪贴板清空输入框等按钮底部快捷键支持 Q 退出、S 设置、R 查看下载记录、M 开启剪贴板监听等日常使用几乎不需要记任何参数。XHS-Downloader 使用教程10 分钟完成首次部署上手成本不高按自己的技术背景选一条路线即可三条路线的功能内核完全一致。路线一程序包开箱即用零门槛从项目发布页下载对应系统的程序压缩包解压后双击运行main即可。Windows 与 Mac 都适用需要注意两点Mac 首次运行可能被系统安全限制拦截在终端执行xattr -cr 项目文件夹路径即可解除之后可正常使用程序包模式下文件默认保存到.\_internal\Volume\Download配置文件位于.\_internal\Volume\settings.json更新版本时把这个 Volume 文件夹整体复制到新版即可保留全部配置与下载记录。路线二源码运行功能完整、可定制需要 Python 3.12 及以上版本适合想二次开发或深度配置的用户git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader python -m venv venv # Windows: .\venv\Scripts\activate # Mac/Linux: source venv/bin/activate pip install -r requirements.txt python main.py如果本机装有 uv也可以走更简洁的方式uv sync --no-dev同步依赖后用uv run main.py启动。路线三Docker 容器化环境零污染熟悉容器的用户可以直接拉取镜像docker pull joeanamier/xhs-downloader docker run --name xhs-downloader -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader默认进入图形界面模式想在容器里跑 API 或 MCP只需在镜像名后追加python main.py api或python main.py mcp。注意 Docker 模式下剪贴板读取与监听功能不可用其余功能正常。小红书作品批量下载实战命令行模式详解命令行是批量下载和自动化场景的主力。最简单的用法是把链接直接传给--url# 下载单个作品 python main.py --url https://www.xiaohongshu.com/explore/作品ID # 批量下载多个链接用空格分隔、整体加引号 python main.py --url 链接1 链接2 链接3 # 指定保存目录与代理 python main.py --url 链接 --work_path D:/XHS --proxy http://127.0.0.1:7890 # 只下载图文作品的第 1、3、5 张图片 python main.py --url 链接 --index 1 3 5几个值得注意的细节--index只对图文/图集作品生效且一旦设置即使传入多个链接也只会处理第一个这是刻意设计避免误下载布尔型参数支持true/false/1/0/yes/no/on/off不区分大小写传值其他常用参数还有--folder_name存储文件夹名、--name_format文件命名格式、--image_format图片格式、--languagezh_CN/en_US等输入python main.py --help可查看完整参数表。让网页端也能一键采集浏览器用户脚本如果你习惯在小红书网页端浏览内容可以配合 Tampermonkey 等脚本管理器安装项目自带的用户脚本把采集动作直接嵌进网页里。脚本安装后小红书页面左侧会出现功能菜单包括提取发布作品链接提取点赞作品链接提取收藏作品链接提取专辑作品链接以及搜索场景下的作品/用户链接提取所有结果会写入剪贴板方便粘贴到主程序批量下载。更强的玩法是脚本 主程序联动在配置文件中把script_server设为true保持主程序后台运行TUI、API、MCP 模式均支持浏览到感兴趣的作品时点击脚本菜单里的推送下载任务网页端负责收集链接主程序负责下载归档浏览器与本地各司其职。脚本还提供自动滚动页面、多文件打包下载等选项需要提醒的是自动滚动功能默认关闭开启后可能被平台识别为自动化操作存在账号风控风险请谨慎使用。把工具接进你的系统API 与 MCP 双通道对于有集成需求的团队XHS-Downloader 自带服务器模式不需要再写爬虫。API 模式运行python main.py api访问http://127.0.0.1:5556/docs可查看自动生成的交互式接口文档。核心接口为POST /xhs/detail一个最小的调用示例如下import requests server http://127.0.0.1:5556/xhs/detail data { url: https://www.xiaohongshu.com/explore/作品ID, download: True, # 是否同时下载文件 index: [1, 3, 5], # 仅对图文作品生效 proxy: http://127.0.0.1:10808, } response requests.post(server, jsondata, timeout10) print(response.json())MCP 模式运行python main.py mcp后把 MCP 地址http://127.0.0.1:5556/mcp/配置到支持 MCP 的 AI 客户端中就能用自然语言向工具下达指令——例如获取这个作品的信息或下载这篇笔记的前三张图片工具会以结构化结果返回。优化小红书图文视频下载体验的三个配置工具默认配置即可跑通但下面三个设置能明显改善下载质量。其一配置 Cookie 提升视频画质。Cookie 并非强制项但不配置时视频只能拿到低分辨率版本。获取方法很简单浏览器打开小红书 explore 页面按 F12 打开开发者工具切到网络标签并勾选保留日志筛选web_session相关请求后复制完整 Cookie 填入配置文件即可全程无需登录账号。其二按需选择图片格式。图文作品支持AUTO、PNG、WEBP、JPEG、HEIC五种格式默认 JPEG。追求无损选 PNG苹果生态选 HEIC拿不准就保持 AUTO 让程序根据服务器响应自动决定。其三理解下载记录机制。程序会把已下载作品的 ID 写入数据库Volume/ExploreID.db默认开启去重重复链接会自动跳过。如果某次文件被误删、想重新下载记得先清掉数据库中对应的作品 ID否则程序仍会判定已下载。此外项目内置了请求延时机制批量采集时会对平台更友好。高频疑问速查疑问解决办法视频画质不高怎么办按上文配置 Cookie无需登录即可获得更高分辨率怎么批量下载某个作者的整页作品用用户脚本提取发布作品链接再把全部链接粘贴到程序批量下载下载的文件存在哪里程序包模式默认.\_internal\Volume\Download源码模式默认./Volume/Download均可在设置中自定义下载到一半断了怎么办项目支持断点续传重新运行会自动从断点继续保证文件完整想重新下载某个作品但被跳过了删除ExploreID.db中对应的作品 ID 后再下载换了新版本程序配置会丢吗保留旧版的 Volume 文件夹并复制到新版即可配置、记录、数据都在里面结语从一个作品开始XHS-Downloader 的价值在于把手动截图、逐条复制的零碎劳动替换成提取链接、批量下载、自动归档的完整流水线。无论你只是想把喜欢的笔记存下来还是需要为数据分析准备一批样本它都能覆盖到。下一步你可以这样走先按自己的技术背景选一条部署路线跑通第一个作品再配上 Cookie 提升画质然后尝试用命令行或用户脚本做一次批量下载最后按需接入 API 或 MCP把它变成自己工作流的一部分。项目采用 GPL-3.0 开源协议源码结构清晰example.py中给出了可直接运行的二次开发示例想定制命名规则、存储结构或对接业务系统都可以在此基础上快速扩展。最后也提醒一句请将工具用于合法合规的用途尊重内容创作者的版权批量采集时注意频率与平台规则。工具本身是中立的怎么用好它取决于你。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考