XHS-Downloader 小红书作品下载与管理全攻略【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-DownloaderXHS-Downloader 是一款功能强大的小红书XiaoHongShu/RedNote作品下载工具支持提取账号发布、收藏、点赞、专辑作品链接采集作品信息并下载图片、视频等多种格式文件。无论你是普通用户想要保存喜欢的内容还是开发者需要集成小红书数据采集功能这个工具都能满足你的需求。快速上手三种运行方式任你选️ 直接运行程序最简单如果你是 Windows 10 或 Mac OS 用户可以直接下载打包好的程序运行前往项目仓库的 Releases 页面下载对应系统的压缩包并解压双击运行main可执行文件注意Mac 用户首次运行时需要在终端执行xattr -cr 项目文件夹路径命令移除安全标记。 源码运行最灵活如果你想使用最新功能或进行二次开发推荐使用源码运行# 方法一使用 pip 安装依赖 python -m venv venv # 创建虚拟环境可选 source venv/bin/activate # 激活虚拟环境Linux/Mac # Windows: .\venv\Scripts\activate pip install -r requirements.txt python main.py # 方法二使用 uv推荐 uv sync --no-dev uv run main.py Docker 运行最便捷对于服务器环境或喜欢容器化的用户# 拉取镜像 docker pull joeanamier/xhs-downloader # 运行容器TUI 界面模式 docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader # 运行容器API 模式 docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader python main.py api核心功能详解支持的小红书链接格式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/分享码小技巧支持一次输入多个链接用空格分隔即可程序会自动识别有效链接。图形界面操作启动程序后你会看到一个简洁的图形界面界面主要分为三个区域输入区粘贴小红书链接支持多个链接同时处理功能按钮下载作品、读取剪贴板、清空输入快捷操作底部提供了退出、更新、设置、记录、监听等快捷功能配置文件个性化设置程序首次运行会自动生成配置文件./Volume/settings.json你可以根据自己的需求调整参数类型说明默认值name_formatstr文件命名格式支持发布时间 作者昵称 作品标题等字段发布时间 作者昵称 作品标题image_formatstr图片格式支持 AUTO、PNG、WEBP、JPEG、HEICJPEGdownload_recordbool是否记录已下载作品ID避免重复下载truefolder_modebool是否为每个作品创建独立文件夹falseauthor_archivebool是否为每个作者创建独立文件夹false实用技巧设置author_archivetrue可以让每个作者的作品都保存在单独的文件夹中方便整理。进阶使用技巧命令行模式批量处理利器对于需要批量处理或自动化任务的用户命令行模式是你的最佳选择# 基本用法下载单个作品 python main.py -u https://www.xiaohongshu.com/explore/123456 # 高级用法下载指定图片 python main.py -u 链接 -i 1 3 5 # 自定义保存路径 python main.py -u 链接 -wp /path/to/save命令行支持丰富的参数配置包括-i/--index指定下载图文作品的第几张图片-f/--folder设置保存文件夹名称-nf/--name_format自定义文件命名格式-if/--image_format设置图片下载格式API 模式开发者集成方案XHS-Downloader 提供了 RESTful API方便开发者集成到自己的项目中# 启动 API 服务器 python main.py api # 访问 API 文档 # http://127.0.0.1:5556/docs # http://127.0.0.1:5556/redocAPI 接口示例import requests # 获取作品信息 response requests.post( http://127.0.0.1:5556/xhs/detail, json{ url: https://www.xiaohongshu.com/explore/123456, download: True, index: [1, 2, 3], proxy: http://127.0.0.1:10808 } ) print(response.json())MCP 模式AI 助手集成XHS-Downloader 支持 Model Context ProtocolMCP可以与 AI 助手无缝集成启动 MCP 服务python main.py mcp配置完成后AI 助手可以直接调用 XHS-Downloader 的功能获取作品信息分析链接并提取元数据下载指定文件按需下载图片或视频批量处理自动化处理多个作品实用功能深度解析剪贴板监听自动化下载开启剪贴板监听模式后程序会自动监测剪贴板内容发现小红书链接时自动下载使用场景浏览小红书时复制喜欢的作品链接程序自动检测并开始下载输入 close 关闭监听模式用户脚本浏览器集成如果你安装了 Tampermonkey 浏览器扩展可以使用 XHS-Downloader 用户脚本安装 Tampermonkey 扩展添加用户脚本XHS-Downloader.js在小红书页面点击脚本菜单进行操作用户脚本支持的功能一键下载当前作品批量提取账号发布、收藏、点赞作品链接提取搜索结果中的作品和用户链接自动滚动加载更多内容智能文件管理XHS-Downloader 提供了多种文件管理选项# 示例配置 { folder_mode: true, # 每个作品单独文件夹 author_archive: true, # 按作者归档 name_format: 发布时间 作者昵称 作品标题, write_mtime: true # 修改时间为发布时间 }文件命名字段说明字段说明示例作品标题作品的主标题周末出游攻略作者昵称发布者的昵称旅行达人小明发布时间作品发布时间2024-01-15 14:30作品ID作品的唯一标识67b3a1d2000000001a01a2b3作品类型内容类型图文 或 视频配置优化与最佳实践Cookie 配置提升下载质量虽然 Cookie 不是必需的但配置后可以获得更好的体验访问小红书网页版https://www.xiaohongshu.com/explore按 F12 打开开发者工具切换到 Network 标签页勾选 Preserve log在 Filter 输入框中输入cookie-name:web_session点击任意作品找到请求中的 Cookie 字段复制完整的 Cookie 值到配置文件中为什么需要 Cookie视频作品可以下载更高分辨率减少请求限制和风控获取更完整的作品信息代理设置解决网络问题如果你遇到网络访问问题可以配置代理{ proxy: http://127.0.0.1:10808, timeout: 10, max_retry: 5 }下载记录管理XHS-Downloader 会自动记录已下载的作品 ID避免重复下载。记录文件位于./Volume/ExploreID.db已下载作品ID数据库./Volume/Download/ExploreData.db作品详细信息数据库如果开启记录清理下载记录删除数据库文件重新开始或通过程序界面管理下载记录常见问题解决下载失败怎么办检查链接格式确保链接是有效的分享链接更新 CookieCookie 可能过期重新获取配置代理如果网络受限尝试使用代理检查存储空间确保磁盘有足够空间文件命名乱码确保系统编码支持中文尝试使用英文命名格式检查文件系统是否支持特殊字符程序启动失败确保 Python 版本 ≥ 3.12检查依赖是否完整安装查看错误日志获取详细信息高级用法二次开发指南XHS-Downloader 提供了完善的 API 接口方便开发者进行二次开发from source import XHS async def custom_download(): async with XHS( work_path/my/download/path, folder_nameMyDownloads, name_format作品标题, cookieyour_cookie_here, proxyhttp://proxy:port, download_recordTrue, author_archiveTrue ) as xhs: # 下载单个作品 result await xhs.extract( https://www.xiaohongshu.com/explore/123456, downloadTrue, index[1, 3, 5] # 只下载第1、3、5张图片 ) print(result)批量处理示例import asyncio from source import XHS async def batch_download(urls): async with XHS() as xhs: tasks [] for url in urls: task xhs.extract(url, downloadTrue) tasks.append(task) results await asyncio.gather(*tasks) for result in results: if result: print(f下载成功: {result.get(title, 未知标题)})性能优化建议内存与存储优化定期清理删除不需要的下载记录和临时文件使用外置存储将work_path设置为外部硬盘或 NAS选择性下载使用index参数只下载需要的图片网络优化合理设置超时根据网络状况调整timeout参数启用断点续传大文件下载时自动支持批量处理间隔避免请求过于频繁文件管理优化按作者归档设置author_archivetrue便于整理自定义命名使用name_format优化文件命名格式转换根据需要设置image_format安全与合规使用使用规范尊重版权仅下载个人收藏或授权内容合理使用避免对平台服务器造成过大压力遵守协议遵循项目 GNU GPL v3.0 开源协议隐私保护本地存储所有数据都保存在本地Cookie 安全妥善保管你的 Cookie 信息数据加密敏感信息本地加密存储社区与支持获取帮助查看文档仔细阅读 README 和配置文件说明搜索 Issues在项目仓库中搜索类似问题提交反馈遇到问题时提供详细的错误信息贡献代码如果你发现 Bug 或有改进建议Fork 项目仓库创建功能分支提交 Pull Request遵循项目的代码规范保持更新关注项目 Releases 页面获取更新定期同步代码库备份配置文件后再升级总结XHS-Downloader 作为一个功能全面的小红书作品下载工具无论是普通用户的简单下载需求还是开发者的集成需求都能提供良好的支持。通过本文的介绍你应该已经掌握了✅基础使用三种运行方式的选择✅核心功能图形界面、命令行、API、MCP 等多种操作模式✅高级技巧Cookie 配置、批量处理、二次开发✅最佳实践性能优化、问题排查、安全使用现在就开始使用 XHS-Downloader高效管理你的小红书收藏吧温馨提示使用过程中请遵守相关法律法规和平台规则合理使用工具功能。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
XHS-Downloader 小红书作品下载与管理全攻略
XHS-Downloader 小红书作品下载与管理全攻略【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-DownloaderXHS-Downloader 是一款功能强大的小红书XiaoHongShu/RedNote作品下载工具支持提取账号发布、收藏、点赞、专辑作品链接采集作品信息并下载图片、视频等多种格式文件。无论你是普通用户想要保存喜欢的内容还是开发者需要集成小红书数据采集功能这个工具都能满足你的需求。快速上手三种运行方式任你选️ 直接运行程序最简单如果你是 Windows 10 或 Mac OS 用户可以直接下载打包好的程序运行前往项目仓库的 Releases 页面下载对应系统的压缩包并解压双击运行main可执行文件注意Mac 用户首次运行时需要在终端执行xattr -cr 项目文件夹路径命令移除安全标记。 源码运行最灵活如果你想使用最新功能或进行二次开发推荐使用源码运行# 方法一使用 pip 安装依赖 python -m venv venv # 创建虚拟环境可选 source venv/bin/activate # 激活虚拟环境Linux/Mac # Windows: .\venv\Scripts\activate pip install -r requirements.txt python main.py # 方法二使用 uv推荐 uv sync --no-dev uv run main.py Docker 运行最便捷对于服务器环境或喜欢容器化的用户# 拉取镜像 docker pull joeanamier/xhs-downloader # 运行容器TUI 界面模式 docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader # 运行容器API 模式 docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader python main.py api核心功能详解支持的小红书链接格式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/分享码小技巧支持一次输入多个链接用空格分隔即可程序会自动识别有效链接。图形界面操作启动程序后你会看到一个简洁的图形界面界面主要分为三个区域输入区粘贴小红书链接支持多个链接同时处理功能按钮下载作品、读取剪贴板、清空输入快捷操作底部提供了退出、更新、设置、记录、监听等快捷功能配置文件个性化设置程序首次运行会自动生成配置文件./Volume/settings.json你可以根据自己的需求调整参数类型说明默认值name_formatstr文件命名格式支持发布时间 作者昵称 作品标题等字段发布时间 作者昵称 作品标题image_formatstr图片格式支持 AUTO、PNG、WEBP、JPEG、HEICJPEGdownload_recordbool是否记录已下载作品ID避免重复下载truefolder_modebool是否为每个作品创建独立文件夹falseauthor_archivebool是否为每个作者创建独立文件夹false实用技巧设置author_archivetrue可以让每个作者的作品都保存在单独的文件夹中方便整理。进阶使用技巧命令行模式批量处理利器对于需要批量处理或自动化任务的用户命令行模式是你的最佳选择# 基本用法下载单个作品 python main.py -u https://www.xiaohongshu.com/explore/123456 # 高级用法下载指定图片 python main.py -u 链接 -i 1 3 5 # 自定义保存路径 python main.py -u 链接 -wp /path/to/save命令行支持丰富的参数配置包括-i/--index指定下载图文作品的第几张图片-f/--folder设置保存文件夹名称-nf/--name_format自定义文件命名格式-if/--image_format设置图片下载格式API 模式开发者集成方案XHS-Downloader 提供了 RESTful API方便开发者集成到自己的项目中# 启动 API 服务器 python main.py api # 访问 API 文档 # http://127.0.0.1:5556/docs # http://127.0.0.1:5556/redocAPI 接口示例import requests # 获取作品信息 response requests.post( http://127.0.0.1:5556/xhs/detail, json{ url: https://www.xiaohongshu.com/explore/123456, download: True, index: [1, 2, 3], proxy: http://127.0.0.1:10808 } ) print(response.json())MCP 模式AI 助手集成XHS-Downloader 支持 Model Context ProtocolMCP可以与 AI 助手无缝集成启动 MCP 服务python main.py mcp配置完成后AI 助手可以直接调用 XHS-Downloader 的功能获取作品信息分析链接并提取元数据下载指定文件按需下载图片或视频批量处理自动化处理多个作品实用功能深度解析剪贴板监听自动化下载开启剪贴板监听模式后程序会自动监测剪贴板内容发现小红书链接时自动下载使用场景浏览小红书时复制喜欢的作品链接程序自动检测并开始下载输入 close 关闭监听模式用户脚本浏览器集成如果你安装了 Tampermonkey 浏览器扩展可以使用 XHS-Downloader 用户脚本安装 Tampermonkey 扩展添加用户脚本XHS-Downloader.js在小红书页面点击脚本菜单进行操作用户脚本支持的功能一键下载当前作品批量提取账号发布、收藏、点赞作品链接提取搜索结果中的作品和用户链接自动滚动加载更多内容智能文件管理XHS-Downloader 提供了多种文件管理选项# 示例配置 { folder_mode: true, # 每个作品单独文件夹 author_archive: true, # 按作者归档 name_format: 发布时间 作者昵称 作品标题, write_mtime: true # 修改时间为发布时间 }文件命名字段说明字段说明示例作品标题作品的主标题周末出游攻略作者昵称发布者的昵称旅行达人小明发布时间作品发布时间2024-01-15 14:30作品ID作品的唯一标识67b3a1d2000000001a01a2b3作品类型内容类型图文 或 视频配置优化与最佳实践Cookie 配置提升下载质量虽然 Cookie 不是必需的但配置后可以获得更好的体验访问小红书网页版https://www.xiaohongshu.com/explore按 F12 打开开发者工具切换到 Network 标签页勾选 Preserve log在 Filter 输入框中输入cookie-name:web_session点击任意作品找到请求中的 Cookie 字段复制完整的 Cookie 值到配置文件中为什么需要 Cookie视频作品可以下载更高分辨率减少请求限制和风控获取更完整的作品信息代理设置解决网络问题如果你遇到网络访问问题可以配置代理{ proxy: http://127.0.0.1:10808, timeout: 10, max_retry: 5 }下载记录管理XHS-Downloader 会自动记录已下载的作品 ID避免重复下载。记录文件位于./Volume/ExploreID.db已下载作品ID数据库./Volume/Download/ExploreData.db作品详细信息数据库如果开启记录清理下载记录删除数据库文件重新开始或通过程序界面管理下载记录常见问题解决下载失败怎么办检查链接格式确保链接是有效的分享链接更新 CookieCookie 可能过期重新获取配置代理如果网络受限尝试使用代理检查存储空间确保磁盘有足够空间文件命名乱码确保系统编码支持中文尝试使用英文命名格式检查文件系统是否支持特殊字符程序启动失败确保 Python 版本 ≥ 3.12检查依赖是否完整安装查看错误日志获取详细信息高级用法二次开发指南XHS-Downloader 提供了完善的 API 接口方便开发者进行二次开发from source import XHS async def custom_download(): async with XHS( work_path/my/download/path, folder_nameMyDownloads, name_format作品标题, cookieyour_cookie_here, proxyhttp://proxy:port, download_recordTrue, author_archiveTrue ) as xhs: # 下载单个作品 result await xhs.extract( https://www.xiaohongshu.com/explore/123456, downloadTrue, index[1, 3, 5] # 只下载第1、3、5张图片 ) print(result)批量处理示例import asyncio from source import XHS async def batch_download(urls): async with XHS() as xhs: tasks [] for url in urls: task xhs.extract(url, downloadTrue) tasks.append(task) results await asyncio.gather(*tasks) for result in results: if result: print(f下载成功: {result.get(title, 未知标题)})性能优化建议内存与存储优化定期清理删除不需要的下载记录和临时文件使用外置存储将work_path设置为外部硬盘或 NAS选择性下载使用index参数只下载需要的图片网络优化合理设置超时根据网络状况调整timeout参数启用断点续传大文件下载时自动支持批量处理间隔避免请求过于频繁文件管理优化按作者归档设置author_archivetrue便于整理自定义命名使用name_format优化文件命名格式转换根据需要设置image_format安全与合规使用使用规范尊重版权仅下载个人收藏或授权内容合理使用避免对平台服务器造成过大压力遵守协议遵循项目 GNU GPL v3.0 开源协议隐私保护本地存储所有数据都保存在本地Cookie 安全妥善保管你的 Cookie 信息数据加密敏感信息本地加密存储社区与支持获取帮助查看文档仔细阅读 README 和配置文件说明搜索 Issues在项目仓库中搜索类似问题提交反馈遇到问题时提供详细的错误信息贡献代码如果你发现 Bug 或有改进建议Fork 项目仓库创建功能分支提交 Pull Request遵循项目的代码规范保持更新关注项目 Releases 页面获取更新定期同步代码库备份配置文件后再升级总结XHS-Downloader 作为一个功能全面的小红书作品下载工具无论是普通用户的简单下载需求还是开发者的集成需求都能提供良好的支持。通过本文的介绍你应该已经掌握了✅基础使用三种运行方式的选择✅核心功能图形界面、命令行、API、MCP 等多种操作模式✅高级技巧Cookie 配置、批量处理、二次开发✅最佳实践性能优化、问题排查、安全使用现在就开始使用 XHS-Downloader高效管理你的小红书收藏吧温馨提示使用过程中请遵守相关法律法规和平台规则合理使用工具功能。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
