小红书下载工具XHS-Downloader实用指南批量提取作品链接、采集信息并下载高清图文视频【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader收藏夹里躺着几千条笔记真到要用的时候却一条也导不出来——这是大多数小红书用户的共同体验。小红书下载工具XHS-Downloader正是为解决这类场景而生的开源项目它能把账号发布、收藏、点赞、专辑里的作品链接成批提取出来采集作品的点赞、评论、发布时间等信息解析出真实下载地址再把图文、视频、LivePhoto一并保存到本地。上个月帮朋友整理一位美食博主的选题库我对着网页一篇篇右键另存为两小时才攒下十来篇还漏掉了评论区里客户最看重的互动数据。如果你也经历过这种看得见、拿不走的憋屈或者正在为批量整理素材发愁这篇文章值得读完。我会按这个工具能做什么 → 四种用法怎么选 → 怎么装怎么配 → 下载之外的细节 → 常见坑 → 开发者视角的顺序把它的家底一次讲清楚。小红书下载工具能替你完成哪些事先说能力边界免得期待错位。XHS-Downloader并不是一个万能扒手它的本职有三块提取链接给定某个账号可以批量拉取其发布、收藏、点赞、专辑里的作品链接在搜索场景下还能提取搜索结果里的作品和用户链接。这一步解决的是批量问题——不用再手动逐条复制。采集信息对每个作品抓取标题、作者、点赞数、评论数、发布时间等元数据。做竞品分析或数据整理时这些字段比图片本身更值钱。下载文件解析出作品的真实下载地址把图文PNG、WEBP、JPEG、HEIC 等格式、视频和 LivePhoto 动图存到本地并按你的偏好选择清晰度策略。它认识的小红书链接有三种常见形态日常遇到的分享码也都能识别链接形态示例说明探索页链接https://www.xiaohongshu.com/explore/作品ID最常用短链分享码https://xhslink.com/分享码手机端复制来的那种发现页链接https://www.xiaohongshu.com/discovery/item/作品ID另一种站内路径换句话说你手里有什么样的链接它基本都能接得住。四种用法怎么选图形界面、命令行、浏览器脚本与API同一个工具入口却有四条。选哪条取决于你是偶尔存几张还是天天批量搬。入口适合谁上手成本典型场景图形界面零基础用户最低粘贴链接、点击下载命令行批量处理、脚本自动化中等多链接同时下载、指定图片序号浏览器用户脚本重度刷小红书的人中低边刷边把作品链接推给程序API / MCP开发者、AI 助手较高把下载能力接进自己的系统下面逐一展开。图形界面模式粘贴链接点一下下载这是最没有门槛的用法。双击运行程序后你会看到一个简洁的输入框把链接粘贴进去多个链接用空格分隔即可点下载作品文件按钮就完事。界面还提供了读取剪贴板按钮以及后台监听剪贴板的功能——开启监听后复制链接的程序会自动接手省掉一次手动粘贴。几个值得留意的细节已经下载过的作品会自动跳过不会重复占用流量界面下方有快捷键提示S打开设置、R查看下载记录、M开启监听、Q退出程序内置中英文两套界面在设置里切换即可。对完全不想碰命令行的朋友来说这条路已经够用了。命令行模式批量下载视频与图文的自动化选项当你需要处理几十个链接或者想把下载流程写进定时脚本时图形界面就有点手忙脚乱了。命令行模式把同样的能力拆成了参数一句命令跑完一批python main.py --url 小红书作品链接 --download true多个链接用空格分隔就能排队下载--index可以只下载图文作品中的指定图片序号比如只要第 1、3、5 张--work_path指定数据与文件的保存根目录--language切换程序语言。常用参数在程序里都有中文说明--help一下就能看到全貌。这套参数和图形界面背后是同一套逻辑所以不用担心命令行版功能更少——它只是换了个更省事的入口。浏览器用户脚本边刷小红书边收集作品链接如果你每天花大量时间泡在小红书网页版第三种方式最顺手。装上 Tampermonkey 这类脚本管理器从 URL 安装项目提供的用户脚本然后在程序设置里开启脚本服务之后打开小红书页面右下角就会多出一个菜单。菜单里直接列着提取发布作品链接提取点赞作品链接提取收藏作品链接等选项点一下对应分类的作品链接就被复制到剪贴板并推送给本地程序程序随即开始下载。这招最妙的地方在于你想收集某个博主发布过的所有作品不必先到处找链接直接在对方主页点一下剩下的交给程序排队处理即可。API 与 MCP把小红书作品采集能力接进自建系统对开发者来说程序内置了一个本地 HTTP 服务默认端口 5556可以用最普通的 POST 请求调起下载import requests def download_via_api(): server http://127.0.0.1:5556/xhs/detail data { url: 小红书作品链接, download: True, index: [1, 3, 5], # 只下载指定序号的图片 } response requests.post(server, jsondata, timeout10) return response.json()更时髦的是它支持 Model Context ProtocolMCP。在支持 MCP 的客户端里新建一个工具类型选可流式传输的 HTTP地址填http://127.0.0.1:5556/mcp/保存后 AI 助手就能直接调用获取小红书作品信息和下载小红书作品文件两个能力相当于给 AI 装上了小红书的内容触角。安装与高清权限三条路径一个关键配置装法三选一直接下载可执行文件从项目发布页拿到对应系统的压缩包解压后双击main即可适合不想装 Python 环境的用户。源码运行克隆仓库后用 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想要高清视频先配好 Cookie不带 Cookie 直接下载视频大概率只能拿到低清版本。原因很简单小红书需要登录态才能返回高码率源而 Cookie 就是那张门票。获取它不复杂打开浏览器访问小红书探索页按F12打开开发者工具切到网络选项卡在请求列表里过滤出web_session相关请求展开请求头就能看到一长串 Cookie。把这串内容完整复制粘贴到./Volume/settings.json配置文件里即可。配置完 Cookie再配合设置里的视频文件偏好选项分辨率优先、码率优先、文件大小优先基本就能按自己的需求拿到对应质量的视频了。下载之后的事去重、命名与归档文件一旦多起来真正的麻烦才刚开始同一篇笔记下载两遍、几百个文件名长得像乱码、想按作者找文件翻半天。程序在下载之后这三个环节做了设计恰好对症去重程序会记录已下载的作品 ID再次遇到时直接跳过。如果你想强制重下清理掉下载记录即可文件完整性也有校验不会出现下了个残缺文件的尴尬。命名默认格式是发布时间 作者昵称 作品标题一眼能看出内容是什么。当然可以自定义组合把作品 ID、作品类型、点赞数等字段任意拼进文件名。归档开启作者归档后文件会按作者 ID 分文件夹存放博主改昵称了程序还能通过别名映射自动更新不至于目录名和现实对不上号。这些功能在设置文件里分别对应name_format、author_archive、download_record等开关图形界面里也能改。它们的共同思路是让下载这件事一次做好而不是把整理工作留给你事后手工补。几个高频场景与对应解法场景一视频画质不满意。大概率是没配 Cookie按上文步骤配好再试如果仍然偏低检查设置里的视频文件偏好是否被改成了文件大小优先。场景二想把某个作者的全部作品搬下来。用浏览器用户脚本在作者主页点提取发布作品链接拿到链接后交给程序批量处理比手动翻页复制高效得多。场景三找不到下载的文件在哪。默认保存到./Volume/Download/目录也可以在设置里改folder_name或通过--work_path指定其他根路径。场景四网络环境不稳定。settings.json里暴露了timeout请求超时时间、max_retry最大重试次数、chunk分块下载大小和proxy代理地址几个参数按自己的网络情况调一调即可不必改代码。给开发者的三分钟上手如果你打算基于它做二次开发核心入口是一个异步上下文管理器最小示例长这样from source import XHS async def custom_download(): async with XHS( work_path./my_downloads, # 数据与文件保存根路径 folder_name小红书内容, # 下载文件夹名 name_format发布时间 作者昵称 作品标题, image_formatWEBP, # 图文输出格式 download_recordTrue, # 记录下载历史 author_archiveTrue, # 按作者归档 ) as xhs: links [链接1, 链接2, 链接3] for link in links: result await xhs.extract(link, downloadTrue) print(result.get(title))代码结构上source/application/是应用层请求、下载、图片视频处理source/module/是核心逻辑设置、数据模型、下载记录source/CLI/和source/TUI/分别对应命令行与终端界面source/translation/负责多语言。想深入某一块顺着这几个目录找对应的模块文件即可。写在最后用工具的同时守住边界XHS-Downloader 覆盖的场景足够广个人收藏整理、选题素材收集、竞品内容观察乃至团队共享素材库都能找到对应的用法。但有一件事必须提醒它面向的是个人学习、研究或已获授权的使用请控制请求频率尊重原作者版权遵守平台规则与当地法律——工具越强大越需要使用者自己把握分寸。第一次使用的话不必把全部功能研究透彻先跑通粘贴链接 → 点击下载这条最小链路等真正遇到批量、高清、自动化这类需求时再回头对照本文的对应章节。仓库里的 README 对每个参数和配置项都有说明example.py里还躺着一份可以直接跑的最小示例遇到说不清的问题去 Issues 里搜一搜多半已经有人问过了。收藏夹里的笔记是时候变成硬盘里随时能用的素材了。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
