news 2026/8/2 9:13:05

XHS-Downloader：终极小红书作品批量下载工具完整指南

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
XHS-Downloader：终极小红书作品批量下载工具完整指南

XHS-Downloader：终极小红书作品批量下载工具完整指南

【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader

在内容创作和数据分析的时代，小红书（XiaoHongShu）作为国内领先的社交内容平台，汇聚了海量的优质图文和视频内容。无论你是内容创作者、市场分析师，还是普通用户，经常需要保存喜欢的小红书作品。今天，我将为你详细介绍一个强大的开源工具——XHS-Downloader，这是一个专门为小红书设计的作品批量下载器，让你轻松获取平台上的精彩内容。

🎯 项目核心优势：为什么选择XHS-Downloader？

XHS-Downloader不仅仅是一个简单的下载工具，它是一个功能全面的小红书内容管理解决方案。相比其他工具，它拥有以下独特优势：

多模式支持，满足不同需求

  • TUI图形界面：适合新手用户，直观操作界面
  • 命令行模式：适合技术用户，支持批量处理和自动化
  • API服务器模式：适合开发者集成到其他系统
  • MCP模式：支持与AI助手深度集成

智能内容提取能力

  • 自动链接识别：支持多种小红书链接格式，智能提取作品ID
  • 批量处理：一次可处理多个作品链接，提高工作效率
  • 智能去重：自动跳过已下载作品，避免重复劳动

图：XHS-Downloader的图形化操作界面，简洁直观

🚀 快速上手：三种安装方式任你选

方式一：直接运行程序（最适合新手）

如果你是Windows或macOS用户，最简单的使用方式是下载预编译的可执行文件：

  1. 访问项目仓库的Releases页面
  2. 下载对应系统的压缩包
  3. 解压后直接运行main程序文件
  4. 首次运行会自动生成配置文件

方式二：源码运行（适合开发者）

如果你需要定制化功能或二次开发，推荐使用源码运行：

# 克隆项目到本地 git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader # 进入项目目录 cd XHS-Downloader # 使用uv安装依赖（推荐） uv sync --no-dev # 启动程序 uv run main.py

方式三：Docker容器部署

对于需要在服务器环境或需要隔离运行的用户，Docker是最佳选择：

# 拉取镜像 docker pull joeanamier/xhs-downloader # 运行容器 docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader

⚙️ 核心功能详解

1. 链接格式全面支持

XHS-Downloader支持几乎所有小红书链接格式：

  • 标准作品链接：https://www.xiaohongshu.com/explore/作品ID
  • 发现页链接：https://www.xiaohongshu.com/discovery/item/作品ID
  • 用户主页链接：https://www.xiaohongshu.com/user/profile/作者ID/作品ID
  • 短链接：https://xhslink.com/分享码

2. 批量下载功能

  • 账号作品批量下载：一键下载用户发布的所有作品
  • 收藏作品批量下载：保存你收藏的优质内容
  • 点赞作品批量下载：整理你点赞过的所有作品
  • 专辑作品批量下载：按专辑分类下载内容

3. 智能文件管理

  • 自动命名：支持自定义文件名格式，包含作品标题、作者昵称、发布时间等
  • 格式转换：支持PNG、WEBP、JPEG、HEIC等多种图片格式
  • 文件夹模式：可选将每个作品保存到独立文件夹
  • 作者归档：按作者分类存储作品文件

图：XHS-Downloader的命令行模式支持丰富的参数配置

🔧 配置详解：打造个性化下载体验

关键配置参数

项目的主要配置文件位于./Volume/settings.json，首次运行自动生成。以下是一些重要的配置选项：

{ "user_agent": "Mozilla/5.0...", // 浏览器标识 "cookie": "web_session=xxx", // 小红书Cookie（非必需） "proxy": "http://127.0.0.1:10808", // 代理设置 "image_format": "JPEG", // 图片下载格式 "folder_mode": false, // 是否使用文件夹模式 "download_record": true, // 是否记录下载历史 "author_archive": false // 是否按作者归档 }

Cookie配置技巧

虽然Cookie不是必需参数，但配置Cookie可以获得更好的体验：

  1. 访问小红书网页版：https://www.xiaohongshu.com/explore
  2. 按F12打开开发者工具
  3. 选择"网络"选项卡
  4. 在过滤框中输入cookie-name:web_session
  5. 复制完整的Cookie字符串到配置文件中

图：获取小红书Cookie的详细步骤

🎮 浏览器脚本：网页端无缝集成

Tampermonkey脚本安装

XHS-Downloader提供了强大的浏览器用户脚本，让你在小红书网页端直接操作：

  1. 安装Tampermonkey浏览器扩展
  2. 添加用户脚本：https://raw.githubusercontent.com/JoeanAmier/XHS-Downloader/master/static/XHS-Downloader.js
  3. 启用脚本并配置服务器连接

图：Tampermonkey脚本安装步骤

脚本核心功能

  • 一键提取：在作品页面直接提取下载链接
  • 批量采集：自动滚动页面采集多个作品
  • 智能推送：将任务推送到本地运行的XHS-Downloader
  • 多语言支持：支持中文和英文界面

图：用户脚本在小红书网页端的操作界面

📊 实战技巧：高效使用指南

1. 批量下载用户所有作品

使用用户脚本可以高效采集账号的所有作品：

  1. 访问目标用户主页
  2. 点击用户脚本菜单中的"提取账号发布作品链接"
  3. 脚本自动滚动页面加载所有作品
  4. 复制生成的链接列表
  5. 在XHS-Downloader中批量下载

2. 搜索结果批量采集

对于特定关键词的内容采集：

  1. 在小红书搜索页面输入关键词
  2. 使用脚本"提取搜索结果作品链接"
  3. 设置滚动次数（默认50次）
  4. 获取搜索结果中的所有作品链接

3. 自定义文件命名规则

XHS-Downloader支持灵活的文件命名规则，你可以根据需要组合以下字段：

  • 作品ID、作品标题、作品描述
  • 作者昵称、作者ID
  • 发布时间、最后更新时间
  • 点赞数量、评论数量、收藏数量

🔍 高级功能：API和MCP模式

API服务器模式

对于开发者来说，API模式提供了RESTful接口，可以轻松集成到其他系统中：

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, json=data, timeout=10) print(response.json())

MCP模式集成

MCP（Model Context Protocol）模式允许AI助手直接控制XHS-Downloader：

  1. 启动MCP模式：python main.py mcp
  2. 在支持MCP的应用中配置服务器地址
  3. 通过自然语言指令控制作品下载

🛠️ 常见问题解答

Q1：下载失败或返回403错误怎么办？

解决方案：

  1. 检查Cookie是否有效，建议重新获取
  2. 更新User-Agent为最新浏览器版本
  3. 尝试更换代理服务器
  4. 适当增加请求延迟时间

Q2：用户脚本无法连接服务器怎么办？

解决方案：

  1. 确保XHS-Downloader程序正在运行
  2. 检查配置文件中的script_server是否设置为true
  3. 确认防火墙未阻止5556端口
  4. 检查浏览器代理设置

Q3：下载的文件格式不正确怎么办？

解决方案：

  1. 检查image_format设置是否正确
  2. 部分作品可能不支持HEIC格式，会自动回退到WEBP
  3. 确保有足够的存储空间

🚀 性能优化建议

网络优化技巧

  • 使用稳定的代理服务器，避免IP被封
  • 合理设置请求超时时间（建议10-30秒）
  • 启用断点续传功能，避免重复下载

存储管理优化

  • 启用folder_mode将每个作品存储在独立文件夹
  • 使用author_archive按作者归档作品
  • 定期清理临时文件和重复内容

内存使用优化

  • 调整chunk参数控制下载块大小
  • 启用下载记录避免重复下载相同内容
  • 合理设置并发数量，避免资源耗尽

💡 二次开发指南

项目结构概览

XHS-Downloader采用模块化设计，便于二次开发：

  • source/application/：主要应用逻辑
  • source/module/：核心功能模块
  • source/expansion/：扩展功能
  • source/CLI/：命令行接口
  • source/TUI/：图形界面

自定义扩展示例

如果你需要定制化功能，可以参考以下示例：

from source.module import XHS async def custom_download(): """自定义下载逻辑示例""" async with XHS( work_path="./downloads", folder_name="小红书作品", name_format="作者昵称 作品标题", image_format="WEBP", folder_mode=True, author_archive=True ) as xhs: # 批量下载多个作品 links = [ "https://www.xiaohongshu.com/explore/作品ID1", "https://www.xiaohongshu.com/explore/作品ID2", ] for link in links: result = await xhs.extract(link, download=True) print(f"下载完成: {result.get('title', '未知作品')}")

📈 项目特色与未来展望

技术特色

  • 智能反爬应对：内置多重反爬策略，稳定可靠
  • 多线程下载：支持并发下载，提高效率
  • 断点续传：网络中断后可以继续下载
  • 格式自动识别：智能识别作品类型和最佳格式

社区支持

XHS-Downloader拥有活跃的开源社区，你可以在以下渠道获取帮助：

  • GitHub Issues：提交问题和建议
  • Discord社区：与其他用户交流经验
  • QQ群聊：获取实时技术支持

未来发展方向

项目将持续更新，计划增加以下功能：

  • 更多平台支持扩展
  • 云存储集成
  • 智能内容分类
  • 高级搜索过滤

🎉 总结

XHS-Downloader作为一个成熟的开源小红书作品下载器，为内容创作者、数据分析师和普通用户提供了强大而灵活的工具。无论你是需要批量保存喜欢的内容，还是进行内容分析研究，这个工具都能满足你的需求。

使用建议：在使用任何数据采集工具时，请务必遵守平台的服务条款，合理控制请求频率，尊重内容创作者的版权，将工具用于合法合规的用途。

通过本文的详细介绍，相信你已经掌握了XHS-Downloader的核心功能和使用技巧。现在就开始使用这个强大的工具，高效管理你的小红书内容收藏吧！

温馨提示：项目持续更新中，建议关注GitHub仓库获取最新版本和功能更新。

【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/8/2 9:11:16

C#进阶实战：异步编程、LINQ表达式树与依赖注入深度解析

很多C#开发者都有这样的困惑&#xff1a;基础语法学完了&#xff0c;项目也做了几个&#xff0c;但总感觉自己停留在“会用”的层面&#xff0c;遇到复杂业务逻辑时还是无从下手。你可能会写 List<T> &#xff0c;但面对 IEnumerable<T> 、 IQueryable<T&g…

作者头像 李华
网站建设 2026/8/2 9:10:07

最小公倍数算法：从数学原理到健壮代码实现

1. 从一道经典面试题说起&#xff1a;为什么最小公倍数算法是编程的“第一关”&#xff1f; 如果你刚开始学习编程&#xff0c;或者正准备刷题&#xff0c;那么“最小公倍数”这个题目大概率是你绕不开的一道坎。它不像“Hello World”那样只是打个招呼&#xff0c;也不像排序算…

作者头像 李华
网站建设 2026/8/2 9:09:44

聊了6位毕业3年的学长，普通人怎么选EMBA

对处于职业上升关键期的企业中层、高层管理者而言&#xff0c;选择适配的EMBA项目&#xff0c;核心是算清时间、资金投入与长期职业回报的账&#xff0c;香港科技大学EMBA中英双语课程是不少把跨境发展、科技赛道布局作为目标的高管会优先纳入考量的选项。近期和6位毕业满3年、…

作者头像 李华
网站建设 2026/8/2 9:06:26

PCM5122音频板开发指南：从I2S DAC原理到Linux驱动集成实战

1. 项目概述&#xff1a;解码PCM5122音频板 如果你玩过树莓派或者ESP32这类开发板&#xff0c;想给自己的DIY项目加上高品质的音频输出&#xff0c;那你大概率听说过或者正在寻找一块合适的I2S DAC&#xff08;数字模拟转换器&#xff09;扩展板。今天要聊的“PCM5122-Audio-Bo…

作者头像 李华
网站建设 2026/8/2 9:03:34

一人公司生存指南：从MVP到规模化，独立开发者的实战策略

1. 一人公司的生存现状与核心挑战 “一人公司”这个概念&#xff0c;听起来既自由又充满挑战。它通常指的是由单一创始人或核心成员主导&#xff0c;在早期阶段几乎以一己之力承担产品、技术、运营、市场等所有职能的微型创业实体。它可能是一个注册的有限责任公司&#xff0c;…

作者头像 李华
网站建设 2026/8/2 9:00:51

为什么传感器需要标定

传感器之所以需要标定&#xff0c;核心是为了保障测量结果的准确性、一致性与可靠性。在生产环节中&#xff0c;传感器受材料本身特性、加工工艺误差的影响&#xff0c;实际的输入输出关系往往会偏离理论设计的理想值&#xff0c;标定的过程正是为了确定它真实的工作特性参数。…

作者头像 李华