神器推荐 | XHS-Downloader

阳光艺创站 | 分享创意・连接艺术与科技

推荐前言

作为内容创作者和艺术设计爱好者，我们常常需要在社交平台上收集、整理灵感与素材。小红书因其海量的优质图片和原创内容而成为素材宝库，但其本身不便于内容批量保存和离线整理。最近，我发现了一个实用的开源工具——XHS-Downloader，它极大地提升了我的内容采集效率。在这里，强烈将这个神器推荐给大家！

XHS-Downloader不是我开发，而是来自GitHub的一位开发者JoeanAmier的原创作品。我只是以普通用户的身份体验并推荐，分享真实使用心得。

项目简介

XHS-Downloader 是一个基于 Python 的免费开源项目。它可以帮助你批量下载小红书的图片、视频和直播内容，支持多种运行环境（Windows/Mac/Linux、Docker、API模式等）。项目地址：

https://github.com/JoeanAmier/XHS-Downloader

核心功能一览

• 支持批量下载小红书任意笔记的图片、视频、长图、合集等内容

• 轻松下载包括多图笔记和动图在内的优质素材

• 可保存直播内容（需配合选项设置）

• 支持多种图片、视频格式选择（PNG/WEBP/JPEG/HEIC/原创格式等）

• 可通过API接口自动批量处理，极大提升工作效率

• Docker一键部署，云服务器无需繁琐环境配置

• 高度自定义的文件命名和保存目录，智能区分重复内容

• 便捷友好的命令行TUI界面，支持用户参数编辑

• 提供浏览器油猴脚本，一键直达内容下载

• 内置数据库记录功能，防止重复下载，实现素材数据管理

安装方式

• Windows用户：

  前往 项目Releases页面 ，下载对应的压缩包，解压运行“run.bat”或“.exe”即可。

• Mac / Linux 用户：

  需安装 Python 3.12 及以上。在终端输入以下命令安装依赖并运行：

  pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt python main.py

• Docker 部署：

  docker pull joeanamier/xhs-downloader docker run --name xhs -p 6666:6666 -it joeanamier/xhs-downloader

使用流程

1. 首次使用须在软件内配置好个人账号的 Cookie（参考项目详细教程）

2. 运行工具，设置保存目录、命名规则等高级选项

3. 复制需要下载的小红书笔记链接，粘贴至工具界面，回车即可下载

4. 所有内容自动保存至指定文件夹，便于整理和查找

温馨提示：Cookie 的获取只用于个人学习研究，务必遵守平台相关规定；Cookie 失效可按照项目文档重新获取。

进阶用法与实用技巧

API 批量下载： 启动服务器模式

python main.py server # 访问 http://127.0.0.1:6666/docs 查看API文档

POST http://127.0.0.1:6666/xhs/ {   "url": "小红书笔记链接",   "download": true,   "index": [1,2,3] }

•  浏览器一键下载（油猴脚本）： 安装Tampermonkey插件，加载项目提供的JS脚本后，可在小红书网页版直接出现【下载】按钮，一键采集内容。

•  格式筛选与名称自定义： 可在settings.json中配置想要保存的格式及文件命名规范。
  

•  大批量素材整理： 数据库功能方便您全局统计，自动跳过已下载内容，减少重复劳动。

• 常见问题解答

• Q：下载时遇到 Cookie 无效怎么办？
• A：小红书对账号安全控制严格，请根据项目教程视频或文档，每次获取新 Cookie。推荐用 Chrome 浏览器获取，F12->Application->Cookies。

• Q：为什么不建议用于商用？
• A：平台素材版权归原创作者所有。请仅限学习、研究和收藏用途，合理、合法合规使用。

• Q：能下载视频号、抖音、快手等内容吗？

  A：本工具专注于小红书。如果有多平台需求，开发者同一账号下有其他类似项目，详见GitHub主页。
  

• Q：出错或打不开怎么办？

  A：及时关注项目Issues区，或加入官方交流QQ群，开发者和热心用户会帮您解答。

• 适用人群&应用场景

• 内容创作者&运营：

   快速批量收集小红书案例、灵感图片、爆款话题，生成自己的内容库。

• 平面/UI/视觉设计师：

   研究素材风格，用于设计分析、灵感捕捉。

• 互联网营销人：

   跟踪热门产品和社交趋势，助力市场分析。

• 学术/舆情研究：

   采集特定主题笔记，做数据分析基础。

• 普通用户：

   离线收藏、长期保存喜欢的内容，方便查阅和分享。

• 编程/数据分析学习：

   真实Python爬虫/数据采集案例学习与练习
  

注意事项与使用建议

工具仅供个人学习研究与内容收藏，禁止商业批量盗用、转售原始素材或侵权用途。

请尊重原创者版权，如需商用请联系内容作者或小红书官方获取授权。

因平台限制和反爬虫机制，工具并非百分百稳定，如遇异常建议重试或反馈。

善用开源精神，发现bug可向项目反馈建议，助力工具持续完善。

总结 & 获取方式

XHS-Downloader为所有小红书内容爱好者提供了极为高效的下载与管理解决方案。在使用过程中，它大大节省了我的采集人力，不仅支持批量、灵活，还是真正意义上的完全免费、开源工具。如果你和我一样热衷于内容收集与内容整理，推荐你现在就去试试！

XHS-Downloader 项目地址

https://github.com/JoeanAmier/XHS-Downloader