资讯动态

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

发布时间:2026/8/7 15:19:01 来源:尧图企业网站定制
5分钟快速上手小红书内容采集工具XHS-Downloader完整使用指南【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader还在为保存小红书上的精彩内容而烦恼吗XHS-Downloader是一款完全开源的小红书内容采集工具能够轻松帮你下载小红书上的图文和视频作品。无论你是想收藏喜欢的笔记还是需要备份自己的创作内容这个工具都能提供简单高效的解决方案。作为一款专业的小红书内容采集工具XHS-Downloader支持多种使用方式满足不同用户的需求。 3步快速安装配置开始使用小红书内容采集工具XHS-Downloader前你需要先完成简单的安装配置。这里提供最简单快捷的安装方法方法一下载预编译程序推荐新手下载程序包访问项目仓库的Releases页面下载对应你操作系统的程序压缩包解压文件将下载的压缩包解压到任意文件夹运行程序双击运行解压后的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下载小红书内容非常简单复制链接在小红书APP或网页版中找到你想要下载的作品复制分享链接粘贴链接将链接粘贴到程序输入框中支持多个链接用空格分隔开始下载点击下载作品文件按钮程序会自动处理技巧开启读取剪贴板功能后程序会自动读取剪贴板中的链接省去粘贴步骤。支持的小红书链接格式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保存路径等核心参数。核心参数详解参数缩写类型说明默认值--url-ustr小红书作品链接必需无--index-istr指定下载图片序号无--work_path-wpstr作品保存根路径项目根路径--cookie-ckstr小红书网页版Cookie无--folder_mode-fmbool为每个作品创建单独文件夹false✅技巧使用--author_archive true参数可以让程序按作者分类保存作品方便整理。 浏览器脚本无缝网页集成结合Tampermonkey浏览器扩展XHS-Downloader可以在浏览小红书网页时直接使用实现真正的所见即所得体验。脚本安装步骤安装Tampermonkey在Chrome、Edge等浏览器中安装Tampermonkey扩展获取脚本打开脚本管理页面选择从URL安装安装脚本输入脚本地址https://raw.githubusercontent.com/JoeanAmier/XHS-Downloader/refs/heads/master/static/XHS-Downloader.js启用脚本安装完成后启用脚本刷新小红书页面即可使用脚本安装界面这张图展示了如何在Tampermonkey中从URL安装XHS-Downloader用户脚本只需在红色框标注的输入框中粘贴脚本地址即可。脚本核心功能安装成功后在小红书网页上会出现紫色提取图标菜单提取发布作品链接获取账号所有发布作品链接提取点赞作品链接获取账号所有点赞作品链接提取收藏作品链接获取账号所有收藏作品链接推送下载任务将当前页面作品推送到主程序下载浏览器脚本功能这张图展示了XHS-Downloader用户脚本在小红书网页上的界面包含提取发布、点赞、收藏作品链接等功能按钮。提示脚本支持自动滚动加载功能可以一次性提取账号所有作品链接但请注意频繁使用可能触发平台风控。 高级配置技巧Cookie配置获取方法虽然不配置Cookie也能使用基本功能但配置后可以获得高清视频下载权限和更稳定的体验。获取Cookie步骤打开浏览器无痕模式访问https://www.xiaohongshu.com/explore按F12打开开发者工具切换到网络标签勾选保留日志选项刷新页面或点击任意作品找到包含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 // 失败重试次数 } 不同使用场景对比使用场景推荐方式优势注意事项个人收藏少量作品图形界面模式操作简单无需技术背景适合单次少量下载批量下载作者作品浏览器脚本主程序自动化程度高效率高需要配置Cookie获取高清视频内容创作备份命令行模式参数灵活可脚本化需要学习基本命令数据采集分析API/MCP模式可集成到其他系统需要编程基础团队协作使用Docker运行环境统一部署方便需要Docker基础️ 常见问题解决下载速度慢怎么办调整分块大小在配置文件中修改chunk参数适当减小值检查网络连接确保网络稳定可尝试使用代理减少并发请求避免同时下载过多作品视频画质低如何解决配置Cookie按照上述方法获取并配置Cookie检查链接有效性使用最新获取的作品链接更新程序版本确保使用最新版本的程序重复下载问题XHS-Downloader默认会记录已下载的作品ID避免重复下载。如果需要重新下载关闭记录功能设置download_record为false清除下载记录删除./Volume/ExploreID.db文件手动跳过检查使用--skip false参数强制下载 高效批量处理技巧批量下载用户所有作品结合浏览器脚本和主程序可以快速下载某个作者的全部作品访问作者小红书主页运行用户脚本的提取发布作品链接功能脚本会自动滚动页面加载所有作品将所有链接复制到主程序批量下载启用--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/docsMCP模式集成MCP模式提供了更灵活的集成方式# 启动MCP服务 python main.py mcp # 配置地址 # http://127.0.0.1:5556/mcp/二次开发参考查看source/application/download.py文件了解核心下载逻辑example.py文件提供了完整的API调用示例。 最佳实践建议使用建议遵守平台规则合理使用工具避免频繁请求影响平台正常服务尊重原创内容仅用于个人收藏和学习不用于商业用途定期更新程序关注项目更新以获得最新功能和修复备份重要数据定期备份下载记录和配置文件性能优化技巧根据网络状况调整chunk参数大小设置合适的timeout和max_retry参数启用下载记录避免重复工作使用代理服务器提高访问稳定性文件整理策略按作者分类启用author_archive参数每个作者单独文件夹按时间整理在文件名中加入发布时间方便按时间排序添加作品信息启用note_format参数保存作品详细信息定期清理删除不需要的临时文件和记录 开始使用吧现在你已经掌握了XHS-Downloader小红书内容采集工具的所有核心功能和使用技巧。无论你是普通用户想要收藏喜欢的内容还是内容创作者需要备份自己的作品或是开发者需要进行数据采集这个工具都能满足你的需求。记住工具只是手段合理使用、尊重原创才是最重要的。现在就开始建立你自己的小红书内容库享受高效便捷的下载体验吧最后提示如果在使用过程中遇到任何问题可以查看项目文档中的详细说明或加入社区讨论获取帮助。祝你使用愉快【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价