★ FEATURED ARTICLE XHS-Downloader 小红书批量下载指南【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader做竞品分析时我常需要把某个账号最近发布的图文和视频完整搬到本地手动逐个保存既慢又容易漏。XHS-Downloader 是一款开源的小红书批量下载工具把作品链接交给它就能解析下载地址、采集作品信息并保存文件图形界面、命令行、浏览器脚本到 API 都有对应入口。 项目概览能采集与下载哪些内容XHS-Downloader 的定位是小红书RedNote作品采集与下载工具输入作品链接即可完成数据请求、文件下载与本地归档配套的浏览器用户脚本还能在网页端直接提取批量作品链接。作品类型图文、视频、LivePhoto 动图图片文件支持 PNG、WEBP、JPEG、HEIC信息字段点赞、评论、收藏、分享数量、发布时间、作者昵称等可另存为 txt/md 笔记或写入 SQLite文件管理记录已下载作品 ID 自动去重、断点续传、自定义命名格式、按作者归档调用方式GUI、TUI 终端界面、命令行、HTTP API、MCP、浏览器用户脚本 安装部署三种方式跑起来直接运行可执行文件Windows 10 及以上与 macOS 用户可下载最新发布的压缩包解压后双击main即可。默认下载目录是./Volume/Download配置文件为./Volume/settings.jsonmacOS 首次运行需在终端执行xattr -cr 项目文件夹路径移除安全标记。源码运行git clone uv要求 Python 3.12 及以上推荐用 uv 管理依赖git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev uv run main.pyDocker 一键部署docker pull joeanamier/xhs-downloader docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader镜像名后可追加python main.py api或python main.py mcp启动 API 或 MCP 模式下载数据放在挂载卷里重建容器不会丢失。Docker 环境不支持命令行调用与剪贴板监听。⌨️ 使用方式三种入口按场景挑图形界面适合低频下载的个人用户把作品链接粘贴到输入框即可下载程序还能后台监听剪贴板复制链接的动作本身就能触发下载已下载过的作品自动跳过避免重复占空间。命令行适合批量与自动化脚本完整参数用python main.py --help查看实现位于 source/CLI/基础用法python main.py --url https://www.xiaohongshu.com/explore/作品ID常用参数--index只下载图文作品中指定序号的图片如1 3 5设置后仅处理首个链接--name_format文件命名字段如发布时间 作者昵称 作品标题--author_archive按作者分文件夹归档作者改名时自动同步文件名--image_format图片输出格式可选 PNG / WEBP / JPEG / HEIC / AUTO多个链接放在同一引号内、以空格分隔即可一次传入。浏览器脚本适合边浏览边收集给浏览器装上 Tampermonkey 扩展并添加用户脚本后就能在小红书网页端提取推荐页、搜索结果、账号发布/收藏/点赞/专辑的作品链接或把当前作品打包下载把程序配置的script_server设为true脚本还可以把下载任务推送给本地程序执行。 关键配置获取高清视频的 Cookie 配置未设置 Cookie 时视频作品只能取到低分辨率文件配置后就能下载高清版本无需登录账号浏览器访问https://www.xiaohongshu.com/explore建议用无痕模式按 F12 打开开发者工具切到「网络」选项卡过滤框输入cookie-name:web_session点击页面中任意作品选中产生的请求包复制请求头中的完整 Cookie粘贴进配置文件的cookie字段重启程序生效配置文件位于./Volume/settings.json首次运行自动生成修改后需重启程序。 进阶玩法MCP 接入 AI 与二次开发MCP 与 AI 助手集成源码运行先装 MCP 依赖uv sync --no-dev --extra mcp再执行python main.py mcp启动服务。把下面配置写进 AI 助手的 MCP 服务列表对话中即可查询作品信息或触发下载令牌为启动时输出的鉴权令牌{ mcpServers: { XHS-Downloader: { url: http://127.0.0.1:5556/mcp, headers: { Authorization: Bearer 鉴权令牌 } } } }Python 二次开发下载核心逻辑在 source/application/接口用法以example.py为准最小示例from source.application import XHS async with XHS(work_path./my_downloads, name_format发布时间 作者昵称 作品标题) as xhs: for link in links: info await xhs.extract(link, downloadTrue, index[1, 3, 5])两个落地场景内容创作者把对标账号的参考作品按「作者 主题」归档进本地素材库配合note_format导出每篇作品的笔记文件方便随时翻阅。运营团队用用户脚本从竞品主页批量提取链接再走 API 下载基于点赞、发布时间等字段产出周期性的竞品数据报告。❓ 常见问题与合规提醒Q下载的视频为什么画质不高视频清晰度依赖 Cookie。未配置时只能拿到低分辨率文件按上一节的 5 步把 Cookie 写入settings.json即可解决。Q想批量下载某个作者的所有作品怎么办用浏览器用户脚本提取「账号发布作品链接」脚本会自动滚动加载更多内容把结果粘贴到命令行--url参数中一次处理。Q下载的文件存放在哪里默认在./Volume/Download/可用work_path、folder_name修改位置与目录名下载记录存于./Volume/ExploreID.db作品数据存于./Volume/ExploreData.db。Q支持哪些链接格式explore/作品ID、discovery/item/作品ID、user/profile/作者ID/作品ID三类作品页与xhslink.com分享短链均可识别多链接用空格分隔程序会自动过滤无效项。合规提醒程序内置请求间隔默认 6 秒以控制频率不建议调低仅下载个人学习使用或已获授权的内容尊重原创作者的版权与平台规则。从链接提取到文件归档这条链路 XHS-Downloader 都封装成了可选的入口低频使用走图形界面批量任务走命令行或 API有 AI 工作流就接 MCP。作品链接自带日期信息时效过期可能触发风控遇到异常时优先检查 Cookie 与链接的新旧。git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev uv run main.py【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
