3分钟掌握XHS-Downloader小红书内容采集工具完全指南【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader还在为无法保存小红书上的精美图片和视频而烦恼吗想要批量下载喜欢的内容却找不到合适的工具XHS-Downloader是你需要的完美解决方案这款开源Python工具专为小红书内容采集而设计支持多种运行模式从简单易用的图形界面到强大的命令行操作再到与AI助手深度集成的MCP模式满足不同用户的需求。无论是内容创作者需要备份作品数据分析师收集研究资料还是普通用户保存喜欢的笔记XHS-Downloader都能成为你的得力助手快速开始一键安装与配置环境准备与安装XHS-Downloader支持多种安装方式无论你是技术新手还是资深开发者都能快速上手。方法一源码安装推荐开发者首先克隆项目到本地git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader使用uv工具安装依赖速度更快uv sync --no-dev或者使用传统的pip安装pip install -r requirements.txt方法二直接运行可执行文件对于Windows和Mac用户可以直接下载预编译的可执行文件无需安装Python环境。前往项目Release页面下载对应系统的压缩包解压后双击运行即可。获取Cookie解锁高清下载虽然不配置Cookie也能使用基本功能但为了获得最佳体验特别是高清视频下载建议配置Cookie。Cookie的获取非常简单打开浏览器推荐使用无痕模式访问小红书网页版按F12打开开发者工具切换到网络选项卡勾选保留日志在筛选器中输入cookie-name:web_session选择Fetch/XHR筛选器点击任意小红书作品在网络选项卡中选择任意数据包全选复制Cookie值实用提示Cookie配置后可以下载更高画质的视频内容无需登录账号也能使用。图形界面操作新手友好的使用方式主界面功能介绍启动程序后你将看到一个简洁直观的操作界面python main.py界面主要分为三个区域输入区粘贴小红书作品链接支持多个链接用空格分隔操作区下载作品文件、读取剪贴板、清空输入框三个主要功能按钮功能区通过快捷键快速访问各项功能Q退出、S设置、R记录等操作步骤清单复制小红书作品链接粘贴到输入框中点击下载作品文件按钮等待下载完成文件保存在./Volume/Download目录个性化设置调整点击S键或选择程序设置进入配置界面在这里你可以调整重试次数网络不稳定时增加重试次数下载格式支持PNG、WEBP、JPEG、HEIC等多种图片格式文件命名自定义文件名格式包含发布时间、作者昵称、作品标题等信息存储模式是否按作者或作品分类存储语言选择支持中文和英文界面验证方法修改设置后点击保存配置重启程序查看设置是否生效。剪贴板监听模式开启剪贴板监听模式后你只需在小红书APP或网页上复制链接工具就会自动检测并开始下载实用技巧这个功能特别适合批量下载你可以连续复制多个链接工具会按顺序处理。下载完成后还能看到详细的处理记录包括每个文件的状态和保存路径。浏览器脚本网页端无缝集成脚本安装一步到位如果你更喜欢在浏览器中操作XHS-Downloader提供了用户脚本可以在小红书网页版上直接使用安装步骤安装Tampermonkey浏览器扩展在Tampermonkey中点击添加新脚本复制脚本地址https://raw.githubusercontent.com/JoeanAmier/XHS-Downloader/refs/heads/master/static/XHS-Downloader.js点击从URL安装粘贴地址后确认脚本功能详解安装完成后访问小红书网页版你会在页面上看到新增的下载按钮脚本支持的功能包括一键提取自动获取当前页面的所有作品链接智能滚动自动加载更多内容无需手动翻页批量推送将选中的作品推送到本地服务器下载自定义筛选按需选择要下载的图片和视频操作示例打开小红书用户主页点击用户脚本菜单中的提取发布作品链接脚本会自动滚动页面收集所有链接复制链接到XHS-Downloader进行批量下载命令行模式批量处理与自动化基础命令使用对于需要批量处理或自动化需求的用户命令行模式更加高效# 下载单个作品 python main.py --url https://www.xiaohongshu.com/explore/作品ID # 批量下载多个作品 python main.py --url 链接1 链接2 链接3 --download true # 指定保存路径和格式 python main.py --url 链接 --work_path ./downloads --image_format WEBP # 使用代理下载 python main.py --url 链接 --proxy http://127.0.0.1:10808高级参数配置命令行模式支持所有图形界面中的功能而且可以轻松集成到脚本中常用参数说明--url小红书作品链接必需参数--download是否下载作品文件--index下载指定序号的图片文件仅对图文作品生效--cookie请求数据时使用的Cookie--proxy网络代理设置--skip是否跳过已下载的作品批量处理示例# 从文件读取链接批量下载 python main.py --url $(cat links.txt) --download true # 下载图文作品的部分图片 python main.py --url 链接 --index 1 3 5 --download true高级功能API与MCP集成API服务器模式XHS-Downloader提供了完整的API接口便于集成到其他系统中启动API服务器python main.py api访问http://127.0.0.1:5556/docs查看交互式API文档。API支持POST请求参数包括作品链接、下载选项、图片序号选择等。API调用示例import requests def download_via_api(note_url): api_url http://127.0.0.1:5556/xhs/detail payload { url: note_url, download: True, index: [1, 3, 5], proxy: http://127.0.0.1:10808 } response requests.post(api_url, jsonpayload) return response.json()MCP模式与AI助手集成通过MCPModel Context Protocol模式可以将XHS-Downloader集成到AI助手工作流中启动MCP服务器python main.py mcp配置MCP客户端添加新的MCP服务器类型可流式传输的HTTPURLhttp://127.0.0.1:5556/mcp/配置完成后AI助手可以直接调用XHS-Downloader功能实现智能化的内容采集和处理。实用技巧与最佳实践文件管理优化命名规范建议使用发布时间 作者昵称 作品标题格式便于搜索和整理避免使用特殊字符确保文件系统兼容性考虑添加作品ID便于去重和索引分类存储策略启用author_archive按作者分类存储启用folder_mode每个作品独立文件夹定期清理重复文件节省存储空间批量处理工作流高效收集技巧使用用户脚本提取某个作者的所有作品链接将链接保存到文本文件中使用命令行批量下载python main.py --url $(cat author_links.txt) --download true定时自动化创建批处理脚本设置定时任务每天自动下载关注的作者新作品适合内容监控和数据分析场景常见问题解决问题下载速度慢怎么办检查网络连接尝试使用代理调整同时下载的任务数量设置合理的超时时间和重试次数问题某些链接无法下载确保链接格式正确检查Cookie是否有效尝试更新工具到最新版本问题内存占用过高减少同时下载的文件数量关闭不必要的后台程序使用流式下载模式项目结构与扩展开发源码目录解析XHS-Downloader采用模块化设计核心代码位于source/目录source/application/核心应用逻辑包括作品解析、下载、请求处理source/expansion/扩展功能模块如浏览器Cookie读取、文件清理、格式转换source/module/基础模块包括数据模型、设置管理、工具函数source/TUI/终端用户界面实现source/CLI/命令行接口实现二次开发指南查看 example.py 文件获取完整的API调用示例包括异步调用、参数配置和错误处理的最佳实践。自定义功能开发了解项目架构和模块依赖参考现有模块实现新功能测试确保兼容性和稳定性提交Pull Request贡献代码Docker部署方案对于企业级部署推荐使用Docker容器化方案# 拉取镜像 docker pull joeanamier/xhs-downloader # 运行容器TUI模式 docker run -p 5556:5556 -v xhs_data:/app/Volume -it joeanamier/xhs-downloader # 运行容器API模式 docker run -p 5556:5556 -v xhs_data:/app/Volume -it joeanamier/xhs-downloader python main.py api合规使用与注意事项在使用XHS-Downloader时请务必注意以下事项合规使用原则仅下载用于个人学习、研究或备份的内容避免高频请求设置合理的采集间隔不收集、存储或传播用户隐私信息不要用于商业侵权或恶意爬取技术注意事项作品链接携带日期信息使用过期链接可能被风控建议使用最新获取的作品链接进行下载Windows系统需要管理员权限读取浏览器Cookie开启保存作品数据功能时数据默认存储在./Volume/Download/ExploreData.db总结与进阶资源XHS-Downloader作为一款功能全面的小红书内容采集工具在开源社区中获得了广泛认可。其多模式支持、灵活配置和强大的扩展性使其不仅适合普通用户快速下载内容也适合开发者进行二次开发和集成。核心功能回顾✅ 支持多种链接格式和批量处理✅ 无水印高清内容下载✅ 智能去重和文件管理✅ 多种运行模式图形界面、命令行、API、MCP✅ 浏览器脚本集成✅ Docker容器化部署最佳实践建议首次使用时先配置Cookie以获得最佳体验根据需求选择合适的运行模式合理设置文件命名规则和存储结构结合用户脚本实现浏览器内便捷操作定期更新到最新版本以获得新功能和修复进阶学习资源查看 source/application/ 了解核心实现参考 source/expansion/ 学习扩展功能阅读 source/module/ 掌握基础模块探索 source/translation/ 了解国际化支持无论是个人用户的内容收藏还是专业团队的内容分析需求XHS-Downloader都能提供稳定可靠的解决方案。其开源特性确保了透明度和可定制性活跃的社区支持也为问题解决和功能改进提供了保障。现在就开始你的小红书内容管理之旅吧【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 3分钟掌握XHS-Downloader：小红书内容采集工具完全指南
3分钟掌握XHS-Downloader小红书内容采集工具完全指南【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader还在为无法保存小红书上的精美图片和视频而烦恼吗想要批量下载喜欢的内容却找不到合适的工具XHS-Downloader是你需要的完美解决方案这款开源Python工具专为小红书内容采集而设计支持多种运行模式从简单易用的图形界面到强大的命令行操作再到与AI助手深度集成的MCP模式满足不同用户的需求。无论是内容创作者需要备份作品数据分析师收集研究资料还是普通用户保存喜欢的笔记XHS-Downloader都能成为你的得力助手快速开始一键安装与配置环境准备与安装XHS-Downloader支持多种安装方式无论你是技术新手还是资深开发者都能快速上手。方法一源码安装推荐开发者首先克隆项目到本地git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader使用uv工具安装依赖速度更快uv sync --no-dev或者使用传统的pip安装pip install -r requirements.txt方法二直接运行可执行文件对于Windows和Mac用户可以直接下载预编译的可执行文件无需安装Python环境。前往项目Release页面下载对应系统的压缩包解压后双击运行即可。获取Cookie解锁高清下载虽然不配置Cookie也能使用基本功能但为了获得最佳体验特别是高清视频下载建议配置Cookie。Cookie的获取非常简单打开浏览器推荐使用无痕模式访问小红书网页版按F12打开开发者工具切换到网络选项卡勾选保留日志在筛选器中输入cookie-name:web_session选择Fetch/XHR筛选器点击任意小红书作品在网络选项卡中选择任意数据包全选复制Cookie值实用提示Cookie配置后可以下载更高画质的视频内容无需登录账号也能使用。图形界面操作新手友好的使用方式主界面功能介绍启动程序后你将看到一个简洁直观的操作界面python main.py界面主要分为三个区域输入区粘贴小红书作品链接支持多个链接用空格分隔操作区下载作品文件、读取剪贴板、清空输入框三个主要功能按钮功能区通过快捷键快速访问各项功能Q退出、S设置、R记录等操作步骤清单复制小红书作品链接粘贴到输入框中点击下载作品文件按钮等待下载完成文件保存在./Volume/Download目录个性化设置调整点击S键或选择程序设置进入配置界面在这里你可以调整重试次数网络不稳定时增加重试次数下载格式支持PNG、WEBP、JPEG、HEIC等多种图片格式文件命名自定义文件名格式包含发布时间、作者昵称、作品标题等信息存储模式是否按作者或作品分类存储语言选择支持中文和英文界面验证方法修改设置后点击保存配置重启程序查看设置是否生效。剪贴板监听模式开启剪贴板监听模式后你只需在小红书APP或网页上复制链接工具就会自动检测并开始下载实用技巧这个功能特别适合批量下载你可以连续复制多个链接工具会按顺序处理。下载完成后还能看到详细的处理记录包括每个文件的状态和保存路径。浏览器脚本网页端无缝集成脚本安装一步到位如果你更喜欢在浏览器中操作XHS-Downloader提供了用户脚本可以在小红书网页版上直接使用安装步骤安装Tampermonkey浏览器扩展在Tampermonkey中点击添加新脚本复制脚本地址https://raw.githubusercontent.com/JoeanAmier/XHS-Downloader/refs/heads/master/static/XHS-Downloader.js点击从URL安装粘贴地址后确认脚本功能详解安装完成后访问小红书网页版你会在页面上看到新增的下载按钮脚本支持的功能包括一键提取自动获取当前页面的所有作品链接智能滚动自动加载更多内容无需手动翻页批量推送将选中的作品推送到本地服务器下载自定义筛选按需选择要下载的图片和视频操作示例打开小红书用户主页点击用户脚本菜单中的提取发布作品链接脚本会自动滚动页面收集所有链接复制链接到XHS-Downloader进行批量下载命令行模式批量处理与自动化基础命令使用对于需要批量处理或自动化需求的用户命令行模式更加高效# 下载单个作品 python main.py --url https://www.xiaohongshu.com/explore/作品ID # 批量下载多个作品 python main.py --url 链接1 链接2 链接3 --download true # 指定保存路径和格式 python main.py --url 链接 --work_path ./downloads --image_format WEBP # 使用代理下载 python main.py --url 链接 --proxy http://127.0.0.1:10808高级参数配置命令行模式支持所有图形界面中的功能而且可以轻松集成到脚本中常用参数说明--url小红书作品链接必需参数--download是否下载作品文件--index下载指定序号的图片文件仅对图文作品生效--cookie请求数据时使用的Cookie--proxy网络代理设置--skip是否跳过已下载的作品批量处理示例# 从文件读取链接批量下载 python main.py --url $(cat links.txt) --download true # 下载图文作品的部分图片 python main.py --url 链接 --index 1 3 5 --download true高级功能API与MCP集成API服务器模式XHS-Downloader提供了完整的API接口便于集成到其他系统中启动API服务器python main.py api访问http://127.0.0.1:5556/docs查看交互式API文档。API支持POST请求参数包括作品链接、下载选项、图片序号选择等。API调用示例import requests def download_via_api(note_url): api_url http://127.0.0.1:5556/xhs/detail payload { url: note_url, download: True, index: [1, 3, 5], proxy: http://127.0.0.1:10808 } response requests.post(api_url, jsonpayload) return response.json()MCP模式与AI助手集成通过MCPModel Context Protocol模式可以将XHS-Downloader集成到AI助手工作流中启动MCP服务器python main.py mcp配置MCP客户端添加新的MCP服务器类型可流式传输的HTTPURLhttp://127.0.0.1:5556/mcp/配置完成后AI助手可以直接调用XHS-Downloader功能实现智能化的内容采集和处理。实用技巧与最佳实践文件管理优化命名规范建议使用发布时间 作者昵称 作品标题格式便于搜索和整理避免使用特殊字符确保文件系统兼容性考虑添加作品ID便于去重和索引分类存储策略启用author_archive按作者分类存储启用folder_mode每个作品独立文件夹定期清理重复文件节省存储空间批量处理工作流高效收集技巧使用用户脚本提取某个作者的所有作品链接将链接保存到文本文件中使用命令行批量下载python main.py --url $(cat author_links.txt) --download true定时自动化创建批处理脚本设置定时任务每天自动下载关注的作者新作品适合内容监控和数据分析场景常见问题解决问题下载速度慢怎么办检查网络连接尝试使用代理调整同时下载的任务数量设置合理的超时时间和重试次数问题某些链接无法下载确保链接格式正确检查Cookie是否有效尝试更新工具到最新版本问题内存占用过高减少同时下载的文件数量关闭不必要的后台程序使用流式下载模式项目结构与扩展开发源码目录解析XHS-Downloader采用模块化设计核心代码位于source/目录source/application/核心应用逻辑包括作品解析、下载、请求处理source/expansion/扩展功能模块如浏览器Cookie读取、文件清理、格式转换source/module/基础模块包括数据模型、设置管理、工具函数source/TUI/终端用户界面实现source/CLI/命令行接口实现二次开发指南查看 example.py 文件获取完整的API调用示例包括异步调用、参数配置和错误处理的最佳实践。自定义功能开发了解项目架构和模块依赖参考现有模块实现新功能测试确保兼容性和稳定性提交Pull Request贡献代码Docker部署方案对于企业级部署推荐使用Docker容器化方案# 拉取镜像 docker pull joeanamier/xhs-downloader # 运行容器TUI模式 docker run -p 5556:5556 -v xhs_data:/app/Volume -it joeanamier/xhs-downloader # 运行容器API模式 docker run -p 5556:5556 -v xhs_data:/app/Volume -it joeanamier/xhs-downloader python main.py api合规使用与注意事项在使用XHS-Downloader时请务必注意以下事项合规使用原则仅下载用于个人学习、研究或备份的内容避免高频请求设置合理的采集间隔不收集、存储或传播用户隐私信息不要用于商业侵权或恶意爬取技术注意事项作品链接携带日期信息使用过期链接可能被风控建议使用最新获取的作品链接进行下载Windows系统需要管理员权限读取浏览器Cookie开启保存作品数据功能时数据默认存储在./Volume/Download/ExploreData.db总结与进阶资源XHS-Downloader作为一款功能全面的小红书内容采集工具在开源社区中获得了广泛认可。其多模式支持、灵活配置和强大的扩展性使其不仅适合普通用户快速下载内容也适合开发者进行二次开发和集成。核心功能回顾✅ 支持多种链接格式和批量处理✅ 无水印高清内容下载✅ 智能去重和文件管理✅ 多种运行模式图形界面、命令行、API、MCP✅ 浏览器脚本集成✅ Docker容器化部署最佳实践建议首次使用时先配置Cookie以获得最佳体验根据需求选择合适的运行模式合理设置文件命名规则和存储结构结合用户脚本实现浏览器内便捷操作定期更新到最新版本以获得新功能和修复进阶学习资源查看 source/application/ 了解核心实现参考 source/expansion/ 学习扩展功能阅读 source/module/ 掌握基础模块探索 source/translation/ 了解国际化支持无论是个人用户的内容收藏还是专业团队的内容分析需求XHS-Downloader都能提供稳定可靠的解决方案。其开源特性确保了透明度和可定制性活跃的社区支持也为问题解决和功能改进提供了保障。现在就开始你的小红书内容管理之旅吧【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考