★ FEATURED ARTICLE 3 步跑起 XHS-Downloader批量下载无水印小红书作品教程【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-DownloaderXHS-Downloader 是一个开源的小红书XiaoHongShu、RedNote作品采集工具。你把作品链接贴进去它就帮你解析出无水印的图片或视频原始文件保存到本地。想收藏内容的普通用户、需要批量采集的运营人员、要做接口集成的开发者都能用它。为什么需要它平时看到一组好看的图文想存下来只能一张张截图视频则带着水印和平台标识。想要无水印原文件 批量处理 自动去重手动操作几乎不可能。XHS-Downloader 把这些事一次做完粘贴链接、解析下载地址、下载文件、记录已下载的作品全程自动化。 3 步跑起来前提条件电脑上装有不低于 3.12 的 Python 解释器以及 uv 包管理器没有的话先装 uv。第 1 步拿到源码git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader第 2 步同步依赖运行uv sync --no-dev。第 3 步启动程序运行uv run main.py。不带参数启动时默认打开图形界面。嫌源码麻烦Windows 和 macOS 用户可以直接从项目 Release 页下载预编译压缩包解压后双击main即可服务器环境则用docker pull joeanamier/xhs-downloader拉取镜像运行。从单条链接到批量采集图形界面粘贴链接就能下打开界面后把链接粘进输入框点击下载按钮。程序支持 4 种链接格式xiaohongshu.com/explore/作品IDxiaohongshu.com/discovery/item/作品IDxiaohongshu.com/user/profile/作者ID/作品IDxhslink.com/分享码多条链接之间用空格分隔即可一次提交。程序会自动识别有效链接跳过已下载过的作品下载记录保存在./Volume/ExploreID.db里。命令行批量下载配置习惯终端的话直接用参数控制行为。指定 4 种格式的图文作品python main.py --url https://www.xiaohongshu.com/explore/xxxx --image_format WEBP --folder_mode true常用参数--index 1 3 5只下载第 1、3、5 张图--name_format自定义文件名默认是发布时间 作者昵称 作品标题--author_archive true按作者分文件夹归档--video_preference视频偏好支持resolution、bitrate、size三档--proxy请求走代理bool 型参数可用true/false填写API 与 MCP接入你自己的系统把 XHS-Downloader 变成一台下载服务器只需要再跑一条命令。API 模式运行python main.py api服务监听 5556 端口先在终端拿到鉴权令牌再调用接口response requests.post( http://127.0.0.1:5556/xhs/detail, json{url: 作品链接, download: True}, headers{Authorization: Bearer 令牌}, timeout10, )访问http://127.0.0.1:5556/docs可以在线调试所有接口。MCP 模式则运行python main.py mcp需先uv sync --no-dev --extra mcp安装 fastmcp把http://127.0.0.1:5556/mcp填进 AI 助手的 MCP 配置之后用自然语言就能指挥它下载作品。⚠️ 常见报错与异常处理现象明明链接没过期下载却失败或被风控。原因小红书作品链接携带日期信息几天前复制的旧链接很容易触发风控。 处理回小红书重新打开作品页面复制最新链接再提交顺手在settings.json里配置有效的 Cookie能明显改善成功率。现象视频下载下来很糊只有低分辨率。原因没有配置 Cookie 时程序只能拿到低清视频流。 处理浏览器登录小红书网页版按下面示意在开发者工具里复制web_session、webId等值写入settings.json的cookie字段。现象用--index批量传了多个链接只有第一个被处理。原因设置了--index时程序只处理首个作品链接这是命令行的既有规则。 处理带序号需求就单条执行纯批量下载则去掉--index多个链接用空格分隔一次传入。合规使用与延伸阅读工具虽好请守住边界尊重创作者版权仅用于个人收藏等合规用途控制请求频率程序内置约 6 秒的平均请求延时建议保留遵守小红书平台的服务条款。想深入看参数细节读 README.md 就够了核心解析与下载逻辑集中在 source/application/ 目录浏览器端联动可以试试仓库里的 static/XHS-Downloader.js 用户脚本装好 Tampermonkey 后能直接在页面上提取链接、推送到本地程序。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
