企业官网建设流程全解析

5分钟快速上手：小红书内容采集工具XHS-Downloader完整使用指南

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

还在为保存小红书上的精彩内容而烦恼吗？XHS-Downloader是一款完全开源的小红书内容采集工具，能够轻松帮你下载小红书上的图文和视频作品。无论你是想收藏喜欢的笔记，还是需要备份自己的创作内容，这个工具都能提供简单高效的解决方案。作为一款专业的小红书内容采集工具，XHS-Downloader支持多种使用方式，满足不同用户的需求。

🚀 3步快速安装配置

开始使用小红书内容采集工具XHS-Downloader前，你需要先完成简单的安装配置。这里提供最简单快捷的安装方法：

方法一：下载预编译程序（推荐新手）

1. 下载程序包：访问项目仓库的Releases页面，下载对应你操作系统的程序压缩包
2. 解压文件：将下载的压缩包解压到任意文件夹
3. 运行程序：双击运行解压后的main可执行文件即可

💡提示：Mac用户首次运行时需要在终端执行xattr -cr 项目文件夹路径命令移除安全标记，执行一次后即可正常运行。

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

如果你需要自定义功能或进行二次开发，可以选择源码运行：

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

✅验证安装成功：程序启动后会显示"XHS-Downloader V2.7 Stable"界面，说明安装配置成功。

界面说明：这是XHS-Downloader的主界面，包含链接输入区、功能按钮和底部快捷键。你可以直接在这里粘贴小红书链接开始下载。

🎯 核心功能快速上手

基础下载操作

使用XHS-Downloader下载小红书内容非常简单：

1. 复制链接：在小红书APP或网页版中找到你想要下载的作品，复制分享链接
2. 粘贴链接：将链接粘贴到程序输入框中（支持多个链接，用空格分隔）
3. 开始下载：点击"下载作品文件"按钮，程序会自动处理

💡技巧：开启"读取剪贴板"功能后，程序会自动读取剪贴板中的链接，省去粘贴步骤。

支持的小红书链接格式

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/分享码

⚠️注意：链接中可能包含xsec_token参数，这是正常的，程序会自动处理。

💻 命令行模式：高效批量处理

对于需要批量处理或自动化操作的用户，命令行模式提供了更强大的控制能力。通过命令行参数，你可以精确控制下载的每一个细节。

常用命令示例

# 基本下载命令 python main.py --url "小红书链接" # 下载指定图片序号（仅图文作品有效） python main.py --url "链接" --index "1 3 5" # 设置自定义保存路径 python main.py --url "链接" --work_path "./我的收藏" --author_archive true # 配置高清视频下载 python main.py --url "链接" --cookie "你的Cookie值"

命令行参数说明：这张图展示了XHS-Downloader命令行模式的所有可用参数，包括--url（作品链接）、--index（图片序号）、--work_path（保存路径）等核心参数。

核心参数详解

✅技巧：使用--author_archive true参数可以让程序按作者分类保存作品，方便整理。

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

结合Tampermonkey浏览器扩展，XHS-Downloader可以在浏览小红书网页时直接使用，实现真正的"所见即所得"体验。

脚本安装步骤

1. 安装Tampermonkey：在Chrome、Edge等浏览器中安装Tampermonkey扩展
2. 获取脚本：打开脚本管理页面，选择"从URL安装"
3. 安装脚本：输入脚本地址：https://raw.githubusercontent.com/JoeanAmier/XHS-Downloader/refs/heads/master/static/XHS-Downloader.js
4. 启用脚本：安装完成后启用脚本，刷新小红书页面即可使用

脚本安装界面：这张图展示了如何在Tampermonkey中从URL安装XHS-Downloader用户脚本，只需在红色框标注的输入框中粘贴脚本地址即可。

脚本核心功能

安装成功后，在小红书网页上会出现紫色"提取"图标菜单：

• 提取发布作品链接：获取账号所有发布作品链接
• 提取点赞作品链接：获取账号所有点赞作品链接
• 提取收藏作品链接：获取账号所有收藏作品链接
• 推送下载任务：将当前页面作品推送到主程序下载

浏览器脚本功能：这张图展示了XHS-Downloader用户脚本在小红书网页上的界面，包含提取发布、点赞、收藏作品链接等功能按钮。

💡提示：脚本支持自动滚动加载功能，可以一次性提取账号所有作品链接，但请注意频繁使用可能触发平台风控。

🔧 高级配置技巧

Cookie配置获取方法

虽然不配置Cookie也能使用基本功能，但配置后可以获得高清视频下载权限和更稳定的体验。

获取Cookie步骤：

1. 打开浏览器无痕模式，访问https://www.xiaohongshu.com/explore
2. 按F12打开开发者工具，切换到"网络"标签
3. 勾选"保留日志"选项
4. 刷新页面或点击任意作品
5. 找到包含web_session的Cookie字段并复制

Cookie获取方法：这张图详细展示了如何在浏览器开发者工具中获取小红书Cookie，红框标注了需要复制的Cookie字段位置。

配置文件自定义

XHS-Downloader的配置文件位于./Volume/settings.json，支持丰富的自定义选项：

关键配置项说明：

{ "image_format": "JPEG", // 图片格式：AUTO、PNG、WEBP、JPEG、HEIC "folder_mode": false, // 是否为每个作品创建独立文件夹 "author_archive": false, // 是否按作者分类保存 "download_record": true, // 是否记录已下载作品ID（避免重复下载） "name_format": "发布时间 作者昵称 作品标题", // 自定义文件名格式 "chunk": 2097152, // 下载分块大小（2MB） "max_retry": 5 // 失败重试次数 }

📊 不同使用场景对比

🛠️ 常见问题解决

下载速度慢怎么办？

1. 调整分块大小：在配置文件中修改chunk参数，适当减小值
2. 检查网络连接：确保网络稳定，可尝试使用代理
3. 减少并发请求：避免同时下载过多作品

视频画质低如何解决？

1. 配置Cookie：按照上述方法获取并配置Cookie
2. 检查链接有效性：使用最新获取的作品链接
3. 更新程序版本：确保使用最新版本的程序

重复下载问题

XHS-Downloader默认会记录已下载的作品ID，避免重复下载。如果需要重新下载：

1. 关闭记录功能：设置download_record为false
2. 清除下载记录：删除./Volume/ExploreID.db文件
3. 手动跳过检查：使用--skip false参数强制下载

🚀 高效批量处理技巧

批量下载用户所有作品

结合浏览器脚本和主程序，可以快速下载某个作者的全部作品：

1. 访问作者小红书主页
2. 运行用户脚本的"提取发布作品链接"功能
3. 脚本会自动滚动页面加载所有作品
4. 将所有链接复制到主程序批量下载
5. 启用--author_archive true参数按作者分类保存

智能文件管理

XHS-Downloader提供多种文件管理功能：

自动去重机制：程序会记录已下载的作品ID，避免重复下载相同内容，节省存储空间和下载时间。

智能命名系统：支持自定义文件名格式，如{发布时间}_{作者昵称}_{作品标题}，让文件管理更加有序。

分类存储策略：可按作者、作品类型自动分类保存，配合folder_mode和author_archive参数实现精细化文件管理。

🔌 开发者集成方案

API模式调用

对于开发者，XHS-Downloader提供了API接口，可以集成到其他系统中：

# 启动API服务 python main.py api # 访问API文档 # http://127.0.0.1:5556/docs

MCP模式集成

MCP模式提供了更灵活的集成方式：

# 启动MCP服务 python main.py mcp # 配置地址 # http://127.0.0.1:5556/mcp/

💡二次开发参考：查看source/application/download.py文件了解核心下载逻辑，example.py文件提供了完整的API调用示例。

📝 最佳实践建议

使用建议

1. 遵守平台规则：合理使用工具，避免频繁请求影响平台正常服务
2. 尊重原创内容：仅用于个人收藏和学习，不用于商业用途
3. 定期更新程序：关注项目更新以获得最新功能和修复
4. 备份重要数据：定期备份下载记录和配置文件

性能优化技巧

• 根据网络状况调整chunk参数大小
• 设置合适的timeout和max_retry参数
• 启用下载记录避免重复工作
• 使用代理服务器提高访问稳定性

文件整理策略

1. 按作者分类：启用author_archive参数，每个作者单独文件夹
2. 按时间整理：在文件名中加入发布时间，方便按时间排序
3. 添加作品信息：启用note_format参数保存作品详细信息
4. 定期清理：删除不需要的临时文件和记录

🎉 开始使用吧！

现在你已经掌握了XHS-Downloader小红书内容采集工具的所有核心功能和使用技巧。无论你是普通用户想要收藏喜欢的内容，还是内容创作者需要备份自己的作品，或是开发者需要进行数据采集，这个工具都能满足你的需求。

记住，工具只是手段，合理使用、尊重原创才是最重要的。现在就开始建立你自己的小红书内容库，享受高效便捷的下载体验吧！

💡最后提示：如果在使用过程中遇到任何问题，可以查看项目文档中的详细说明，或加入社区讨论获取帮助。祝你使用愉快！

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