
XHS-Downloader小红书内容采集的3种高效方法与完整配置指南【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader作为小红书内容创作者、数据分析师或普通用户你是否经常遇到这些问题看到喜欢的笔记无法批量保存需要手动逐一下载想要备份自己的作品却找不到高效工具或者需要收集特定主题的内容进行市场分析XHS-Downloader 正是为解决这些痛点而生的开源工具它提供了图形界面、命令行和浏览器脚本三种使用方式让小红书内容采集变得简单高效。快速开始三步部署XHS-Downloader无论你是技术新手还是经验丰富的开发者XHS-Downloader 都能在几分钟内完成部署。以下是三种主流安装方式的对比部署方式适合人群复杂度功能完整性推荐场景图形界面运行普通用户、内容创作者⭐☆☆☆☆完整功能个人使用、快速下载源码运行开发者、技术爱好者⭐⭐⭐☆☆完整功能二次开发自定义功能、集成开发Docker运行运维人员、服务器部署⭐⭐☆☆☆完整功能部分限制服务器环境、持续运行图形界面运行推荐新手对于大多数用户这是最简单快捷的方式下载程序包从项目仓库下载最新版本的可执行文件包解压运行解压后直接双击运行main可执行文件开始使用打开程序界面粘贴小红书链接即可下载XHS-Downloader图形界面提供了直观的操作体验包含链接输入、一键下载、剪贴板监听等核心功能源码运行适合开发者如果你需要定制化功能或进行二次开发# 克隆项目 git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader # 进入项目目录 cd XHS-Downloader # 使用uv安装依赖推荐 uv sync --no-dev # 启动程序 uv run main.pyDocker运行适合服务器环境对于需要在服务器环境持续运行的用户# 拉取镜像 docker pull joeanamier/xhs-downloader # 运行容器TUI模式 docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader核心功能详解从基础到高级基础功能一键下载小红书作品XHS-Downloader 的核心功能是提取和下载小红书作品。支持以下链接格式https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXXhttps://www.xiaohongshu.com/discovery/item/作品ID?xsec_tokenXXXhttps://www.xiaohongshu.com/user/profile/作者ID/作品ID?xsec_tokenXXXhttps://xhslink.com/分享码智能特性支持单次输入多个作品链接链接之间使用空格分隔自动提取有效链接无需额外处理自动跳过已下载的作品文件避免重复下载支持图文作品、视频作品、LivePhoto文件下载图形界面操作详解图形界面提供了最直观的操作方式适合大多数用户链接输入在输入框中粘贴小红书作品链接支持批量处理一键下载点击下载作品文件按钮开始下载剪贴板监听开启后自动监测剪贴板中的链接程序设置自定义下载路径、文件格式等参数快捷键操作Q退出程序U检查更新S程序设置R下载记录M开启监听A关于项目命令行模式精准控制的高级用法对于需要批量处理或自动化操作的用户命令行模式提供了更精细的控制# 基本下载命令 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值命令行模式提供了完整的参数控制支持自定义下载路径、文件命名格式、代理设置等高级功能核心参数说明--url小红书作品链接必需参数--index指定下载图片序号仅对图文作品有效--work_path文件保存根路径--author_archive按作者分类保存--name_format自定义文件名格式--cookie小红书网页版Cookie获取高清视频必需高级配置与优化技巧Cookie配置解锁高清视频下载虽然不配置Cookie也能使用基本功能但配置后可以获得高清视频下载权限和更稳定的体验。Cookie获取步骤打开小红书网页版并登录账号按F12打开开发者工具切换到网络标签勾选保留日志刷新页面或点击任意作品找到包含web_session的Cookie字段并复制通过开发者工具获取Cookie这是获取高清视频下载权限的关键步骤配置文件详解XHS-Downloader的配置文件位于./Volume/settings.json支持丰富的自定义选项{ work_path: ./Volume, folder_name: Download, name_format: 发布时间 作者昵称 作品标题, cookie: , image_format: JPEG, folder_mode: false, download_record: true, author_archive: false, write_mtime: false, script_server: false }关键配置项说明image_format图片下载格式AUTO、PNG、WEBP、JPEG、HEICfolder_mode是否为每个作品创建独立文件夹author_archive是否按作者分类保存download_record是否记录已下载作品ID避免重复下载script_server是否开启用户脚本服务器性能优化建议网络优化设置合适的timeout和max_retry参数根据网络状况调整chunk大小配置代理服务器提升稳定性存储优化启用download_record避免重复下载设置author_archive按作者分类管理使用folder_mode保持文件组织清晰格式选择图文作品支持多种格式PNG、WEBP、JPEG、HEIC视频作品支持分辨率、码率、文件大小优先级选择浏览器脚本集成无缝网页操作体验结合Tampermonkey浏览器扩展XHS-Downloader可以在浏览小红书网页时直接使用安装Tampermonkey扩展后通过脚本链接安装XHS-Downloader用户脚本脚本功能亮点一键提取链接提取当前账号发布的作品链接提取账号收藏的作品链接提取账号点赞的作品链接提取账号专辑作品链接批量处理能力自动滚动页面加载更多内容支持批量提取搜索结果作品链接支持批量提取搜索结果用户链接与主程序联动一键推送下载任务到主程序实时同步配置设置支持文件打包下载浏览器脚本在小红书网页上添加功能菜单实现所见即所得的数据采集脚本安装步骤安装Tampermonkey浏览器扩展打开脚本管理页面从URL安装https://raw.githubusercontent.com/JoeanAmier/XHS-Downloader/refs/heads/master/static/XHS-Downloader.js启用脚本即可在小红书网页上使用服务器模式API与MCP集成API模式开发者友好接口XHS-Downloader提供了完整的REST API方便开发者集成到自己的应用中# 启动API服务器 python main.py api # 访问API文档 # http://127.0.0.1:5556/docs # http://127.0.0.1:5556/redocAPI核心端点POST /xhs/detail获取作品详细信息或下载作品文件支持JSON格式请求参数提供完整的Swagger/Redoc文档API调用示例import requests server http://127.0.0.1:5556/xhs/detail data { url: 小红书作品链接, download: True, index: [1, 3, 5], proxy: http://127.0.0.1:10808 } response requests.post(server, jsondata, timeout10) print(response.json())MCP模式AI助手集成对于使用AI助手的用户MCP模式提供了无缝集成体验# 启动MCP服务器 python main.py mcp # MCP配置地址 # http://127.0.0.1:5556/mcp/在MCP工具中配置XHS-Downloader服务实现AI助手直接调用下载功能MCP功能特点支持流式HTTP传输与AI助手深度集成支持自然语言指令调用实时状态反馈二次开发指南代码集成示例XHS-Downloader提供了完整的Python API方便开发者集成到自己的项目中from asyncio import run from source import XHS async def custom_download(): 自定义参数下载示例 async with XHS( work_path./downloads, # 自定义保存路径 folder_nameXHS_Content, # 文件夹名称 name_format发布时间 作者昵称 作品标题, # 文件名格式 cookieyour_cookie_here, # Cookie配置 image_formatWEBP, # 图片格式 author_archiveTrue, # 按作者分类 write_mtimeTrue, # 修改时间为发布时间 ) as xhs: # 下载作品 result await xhs.extract( https://www.xiaohongshu.com/explore/作品ID, downloadTrue, index[1, 2, 3] # 只下载前3张图片 ) print(result)核心模块结构XHS-Downloader采用模块化设计主要模块包括source/application/核心应用逻辑download.py下载功能实现request.py网络请求处理image.py图片处理逻辑video.py视频处理逻辑source/module/功能模块model.py数据模型定义settings.py配置管理tools.py工具函数source/CLI/命令行接口source/TUI/图形界面适用场景与最佳实践场景1内容创作者作品备份需求定期备份自己发布的所有作品保持原始质量解决方案使用浏览器脚本提取所有发布作品链接配置author_archivetrue按作者分类设置write_mtimetrue保持文件时间戳启用download_recordtrue避免重复下载配置示例python main.py --author_archive true --write_mtime true --name_format 发布时间 作品标题场景2市场研究数据收集需求收集特定主题的小红书内容进行分析解决方案使用搜索功能获取相关作品链接配置代理避免IP限制设置record_datatrue保存作品元数据使用API模式集成到分析脚本配置示例python main.py --proxy http://proxy.example.com:8080 --record_data true场景3个人收藏整理需求整理喜欢的作品按主题分类保存解决方案开启剪贴板监听模式浏览时直接复制链接自动下载使用folder_modetrue为每个作品创建独立文件夹配置note_formatmd保存作品信息为Markdown格式性能对比与优化建议不同模式性能对比功能特性图形界面命令行浏览器脚本API模式MCP模式易用性⭐⭐⭐⭐⭐⭐⭐⭐☆☆⭐⭐⭐⭐☆⭐⭐☆☆☆⭐⭐⭐☆☆自动化程度⭐⭐☆☆☆⭐⭐⭐⭐☆⭐⭐⭐☆☆⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐批量处理⭐⭐⭐☆☆⭐⭐⭐⭐⭐⭐⭐⭐⭐☆⭐⭐⭐⭐⭐⭐⭐⭐⭐☆集成能力⭐☆☆☆☆⭐⭐☆☆☆⭐⭐⭐☆☆⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐配置灵活性⭐⭐⭐☆☆⭐⭐⭐⭐⭐⭐⭐☆☆☆⭐⭐⭐⭐☆⭐⭐⭐☆☆优化建议网络环境优化国内用户建议配置代理服务器设置合理的timeout和max_retry参数使用Cookie获取更稳定的连接存储管理优化定期清理下载记录数据库使用author_archive按作者分类配置合适的文件名格式便于搜索性能调优根据网络状况调整chunk大小启用下载记录避免重复请求使用合适的图片格式平衡质量和大小常见问题与解决方案Q1下载速度慢怎么办A检查网络连接尝试配置代理服务器调整chunk参数大小或使用Cookie提升连接稳定性。Q2视频画质不理想A配置Cookie获取高清视频权限设置video_preferenceresolution优先选择高分辨率版本。Q3链接失效无法下载A使用最新获取的作品链接避免使用过期链接。小红书链接通常带有时间戳过期链接可能被风控。Q4批量下载时程序卡顿A适当调整max_retry和timeout参数避免同时处理过多链接分批处理大数量任务。Q5如何避免重复下载A启用download_recordtrue功能程序会自动记录已下载作品ID并跳过重复下载。进阶学习路径开发者进阶源码阅读从source/application/download.py开始了解核心下载逻辑研究source/module/model.py理解数据结构查看example.py学习API调用方式二次开发基于现有API开发自定义功能集成到自动化工作流中开发Web界面或移动端应用贡献代码遵循项目代码规范从develop分支开始开发提交清晰的Pull Request运维部署服务器部署使用Docker容器化部署配置反向代理和SSL证书设置系统服务自启动监控维护监控API服务状态定期清理日志和临时文件备份配置和下载记录安全加固配置防火墙规则使用HTTPS加密传输定期更新依赖包技术架构与设计理念XHS-Downloader采用现代化的Python技术栈核心设计理念包括模块化架构项目采用清晰的模块化设计各功能模块职责分明应用层处理用户交互和业务逻辑服务层提供API和网络服务数据层管理配置和下载记录工具层提供通用工具函数异步处理充分利用Python的异步特性实现高效并发使用asyncio处理并发请求aiohttp处理网络IOaiosqlite异步数据库操作配置驱动所有功能都可通过配置文件灵活调整JSON格式配置文件运行时动态加载支持环境变量覆盖扩展性设计预留了丰富的扩展接口插件系统支持自定义下载处理器多格式输出支持社区资源与支持官方资源项目仓库包含完整源码和文档问题反馈通过GitHub Issues报告问题Discord社区实时交流和技术支持学习资料示例代码example.py提供完整的API使用示例配置文档详细的配置参数说明视频教程B站和YouTube上的操作演示最佳实践分享定期更新关注项目更新获取最新功能和修复备份配置定期备份settings.json配置文件参与社区分享使用经验帮助其他用户总结与展望XHS-Downloader作为一个功能全面的小红书内容采集工具提供了从简单到复杂的多种使用方式满足了不同用户群体的需求。无论是个人用户想要保存喜欢的笔记还是开发者需要集成到自己的应用中都能找到合适的解决方案。核心价值易用性图形界面让非技术用户也能轻松上手灵活性命令行和API提供了强大的定制能力扩展性模块化设计支持功能扩展和二次开发稳定性完善的错误处理和重试机制未来展望 随着小红书的不断更新XHS-Downloader也将持续迭代计划中的功能包括更多文件格式支持智能分类和标签系统云端同步功能移动端应用无论你是小红书内容创作者、数据分析师还是技术开发者XHS-Downloader都能为你提供高效、稳定的小红书内容采集解决方案。开始使用吧让内容管理变得更加简单【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考