XHS-Downloader:小红书内容采集与下载,一个工具全搞定
文章目录XHS-Downloader小红书内容采集与下载一个工具全搞定1、 这个工具解决什么问题2、 核心功能一览3、 三种运行方式4、 服务器模式5、 用户脚本6、 适合谁用XHS-Downloader小红书内容采集与下载一个工具全搞定XHS-Downloader 在 GitHub 上拿到了 11,683 Star。这是一个专门针对小红书的内容采集和下载工具。能提取账号发布、收藏、点赞、专辑的作品链接采集作品信息下载作品文件。支持命令行、API、MCP 多种调用方式也能通过浏览器用户脚本配合使用。1、 这个工具解决什么问题小红书没有提供官方的内容导出接口。想批量保存某个账号的作品或者把收藏夹里的内容下载到本地手动操作基本不现实。XHS-Downloader 做的事情很直接给它一个作品链接或者作者主页链接它能把作品的图片、视频、文案信息全部拉下来。图文作品支持自定义下载格式视频作品能选分辨率优先还是码率优先livePhoto 也能单独处理。已经下载过的作品会自动跳过不会重复下载。2、 核心功能一览功能覆盖面比较全采集作品信息提取下载地址下载文件一套流程走完支持单次输入多个作品链接程序自动提取有效链接后台监听剪贴板复制链接后自动触发下载图文作品可以指定下载哪些图片不用全部拉下来文件断点续传大文件下载中断后不用从头开始下载记录持久化下次运行自动跳过已下载内容支持将每个作者的作品分文件夹存储作者改名后自动更新文件夹名称3、 三种运行方式程序运行Mac OS 和 Windows 10 以上用户可以直接下载可执行文件解压后双击就能用。项目自带 GitHub Actions 自动构建随时可以基于最新源码打包。源码运行需要 Python 3.12 以上版本。用 pip 或 uv 安装依赖后直接运行。源码方式适合需要二次开发的场景项目提供了example.py作为调用示例。Docker 运行拉取镜像后创建容器即可支持 TUI、API、MCP 三种模式。Docker 方式不支持命令行调用模式和剪贴板功能。4、 服务器模式项目内置了 API 和 MCP 两种服务器模式方便程序化调用。API 模式启动后访问http://127.0.0.1:5556/docs能看到自动生成的接口文档。核心接口是/xhs/detailPOST 请求传入作品链接就能拿到作品信息设置download参数为true可以同时下载文件。MCP 模式提供了 Streamable HTTP 接口可以直接接入支持 MCP 协议的 AI 工具让 AI 助手帮你采集和下载小红书内容。5、 用户脚本除了主程序项目还提供了 Tampermonkey 浏览器脚本。安装后可以在浏览器里直接提取推荐页面、账号主页、搜索结果的作品链接也能一键下载作品文件。脚本支持自动滚动页面加载更多内容但默认关闭。开启后可能触发小红书的风控检测需要自行评估风险。脚本还能和主程序联动主程序开启script_server参数后作为后台服务器运行在浏览器中点击脚本菜单的「推送下载任务」就能把当前页面的作品直接推给主程序下载。6、 适合谁用需要批量保存小红书作品素材的内容创作者做竞品分析、需要采集特定账号内容的运营人员想把收藏夹内容备份到本地的普通用户有二次开发需求、想把采集能力集成到自己工具链里的开发者号内容的运营人员想把收藏夹内容备份到本地的普通用户有二次开发需求、想把采集能力集成到自己工具链里的开发者