XHS-Downloader小红书无水印下载快速方案【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader当你在浏览器里看到一条想原样保存的小红书笔记截图却带着水印、录屏又糊时这正是 XHS-Downloader 的目标场景。它是一个基于 Python 3.12 的小红书无水印下载工具从作品链接提取原始图片、视频与 LivePhoto 并保存支持批量链接、剪贴板监听与 API 调用。功能总览它能做什么XHS-Downloader 的核心围绕小红书无水印下载展开覆盖从链接提取到文件归档的完整链路能力项一句话说明典型场景作品文件下载提取无水印直链保存原始图片、视频与 LivePhoto收藏图文笔记与视频多链接解析一次输入多个作品链接空格分隔自动识别批量保存一整页笔记剪贴板监听后台监控剪贴板检测到作品链接自动下载边浏览边收集素材下载去重记录已下载作品 ID重复链接自动跳过长期素材库维护文件管理按作者或作品分文件夹自定义命名字段素材归档整理服务器模式提供 API 与 MCP 接口供外部程序调用接入自动化工作流同类工具大多只做单链接下载而这个项目把链接提取、数据采集与文件下载放在同一套核心里浏览器用户脚本负责从账号发布、收藏、点赞、搜索结果页面提取链接主程序负责批量下载两者可以通过服务器模式联动。同一份核心还提供 TUI、命令行、API、MCP 四种入口普通用户和脚本开发者不需要维护两套代码。从 0 到 1 跑起来程序运行于 macOS / Linux / Windows行为一致Linux 的剪贴板功能依赖系统自带的 xclip 或 xsel。克隆仓库到本地并进入目录git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader推荐路径uv同步依赖并启动终端界面uv sync --no-dev # 仅安装运行时依赖 uv run main.py # 启动 TUI 界面备选路径pip适合已有虚拟环境的机器pip install -r requirements.txt python main.py首次运行会在Volume/下生成settings.json配置文件作品文件默认保存到Volume/Download目录。提示macOS 下载的可执行文件未做代码签名首次运行被系统拦截时在终端执行xattr -cr 项目文件夹路径移除安全标记即可正常运行。按操作流使用以下按实际操作粒度递进先跑通单链接再处理批量与参数最后接入自动化。下载单个作品一条命令保存一条作品的全部内容。uv run main.py -u https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXX在 TUI 中操作是等价的把链接粘贴到顶部输入框点击下载作品文件按钮即可。关键参数--cookie网页版 Cookie无需登录未设置时视频只有低分辨率文件--image_format图片格式AUTO / PNG / WEBP / JPEG / HEIC默认 JPEG--folder_mode每个作品存入独立文件夹默认 false--name_format文件名格式默认发布时间 作者昵称 作品标题--work_path保存根路径默认为项目下的 Volume 目录预期效果终端依次显示解析与下载进度完成后到Volume/Download查看按命名规则生成的作品文件。批量下载多链接并自定义参数多个作品链接一次传入参数统一控制。uv run main.py -u 链接1 链接2 链接3 \ --image_format webp \ --folder_mode true注意设置--index参数时只处理首个链接多链接批量下载与指定图片序号互斥。命令行参数速查参数作用默认值--url / -u作品链接多个用空格分隔并整体加引号必填--index / -i指定图片序号如1 3 5仅对图文作品生效无--image_format / -if图片下载格式JPEG--folder_mode / -fm作品文件存入单独文件夹false--max_retry / -mr请求失败重试次数5预期效果三个作品依次解析下载已记录的作品 ID 自动跳过重复运行不会产生重复文件。监听剪贴板与浏览器脚本推送让下载跟着浏览行为自动发生。TUI 剪贴板监听启动程序后按M键开启监听此后每次复制小红书作品链接程序自动识别并开始下载在剪贴板输入close可停止监听。浏览器用户脚本在 Tampermonkey 中安装仓库内static/XHS-Downloader.js脚本可从账号发布、收藏、点赞、专辑、搜索结果页面批量提取作品链接将settings.json中的script_server设为true并保持主程序后台运行脚本菜单中的推送下载任务会把下载任务交给主程序处理文件格式与命名规则以服务器端配置为准。预期效果浏览小红书网页时随手复制链接或点击脚本菜单文件在后台自动进入下载目录不打断浏览节奏。调优与排障配置 Cookie 获取高清视频源Cookie 为非强制项但未设置时视频作品只能下载低分辨率文件。浏览器访问小红书网页版按F12打开开发者工具切换到网络选项卡并勾选保留日志过滤框输入cookie-name:web_session选择 Fetch/XHR 筛选器后点击任意作品全选复制请求中的 Cookie写入 TUI 设置界面或settings.json的cookie参数重新下载即可获取高画质源。处理性能、网络与解析异常性能类场景推荐值原因弱网环境--timeout 30默认 10 秒易误判超时网络不稳定--max_retry 10默认 5 次提高成功率节省存储空间--image_format webp同画质体积更小长视频下载--video_preference bitrate码率优先高码率源更完整网络类现象链接解析失败确认链接是刚复制的链接携带日期信息旧链接易被风控→ 检查 Cookie 是否过期并更新 → 仍失败时拉取最新源码重试。权限类现象Linux 读取剪贴板报错执行apt-get install xclip或apt-get install xsel安装剪贴板工具 → 重启程序再试。配置类现象重复作品被跳过已下载作品 ID 记录在Volume/ExploreID.db去重默认开启 → 确认需要重新下载时先删除数据库中对应作品 ID 再执行。现象Docker 中命令行参数不生效容器模式不支持命令行调用与剪贴板功能 → 改用粘贴链接或 API 模式。开发者扩展uv run main.py api # API 模式 uv run main.py mcp # MCP 模式启动后访问http://127.0.0.1:5556/docs查看交互式文档MCP 端点为http://127.0.0.1:5556/mcp/Streamable HTTP。接口方法说明/xhs/detailPOST传入作品链接返回作品信息可选同时下载文件/mcp/Streamable HTTPMCP 协议端点供 AI 客户端获取作品信息与下载文件/docsGET自动生成的交互式 API 文档最小调用示例from httpx import post url http://127.0.0.1:5556/xhs/detail data { url: https://www.xiaohongshu.com/explore/XXX?xsec_tokenXXX, # 必需参数 download: True, # 同时下载作品文件 index: [3, 6], # 仅图文作品下载指定序号图片 } print(post(url, jsondata, timeout30).json())仓库example.py提供了通过XHS类直接调用核心的完整参数示例适合二次开发。需要容器化部署时docker pull joeanamier/xhs-downloader docker run -p 5556:5556 -v xhs_volume:/app/Volume -it joeanamier/xhs-downloaderXHS-Downloader 把链接提取、无水印文件下载、去重与归档放在一个程序里完成TUI、命令行、API、MCP 四种入口共用同一套核心日常收藏与自动化接入不需要换工具。环境装好后可以先运行uv run main.py --version确认版本。问题反馈提交到仓库 Issue 区即可作者通过 Discord 与 QQ 群维护社区交流。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
XHS-Downloader小红书无水印下载快速方案【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader当你在浏览器里看到一条想原样保存的小红书笔记截图却带着水印、录屏又糊时这正是 XHS-Downloader 的目标场景。它是一个基于 Python 3.12 的小红书无水印下载工具从作品链接提取原始图片、视频与 LivePhoto 并保存支持批量链接、剪贴板监听与 API 调用。功能总览它能做什么XHS-Downloader 的核心围绕小红书无水印下载展开覆盖从链接提取到文件归档的完整链路能力项一句话说明典型场景作品文件下载提取无水印直链保存原始图片、视频与 LivePhoto收藏图文笔记与视频多链接解析一次输入多个作品链接空格分隔自动识别批量保存一整页笔记剪贴板监听后台监控剪贴板检测到作品链接自动下载边浏览边收集素材下载去重记录已下载作品 ID重复链接自动跳过长期素材库维护文件管理按作者或作品分文件夹自定义命名字段素材归档整理服务器模式提供 API 与 MCP 接口供外部程序调用接入自动化工作流同类工具大多只做单链接下载而这个项目把链接提取、数据采集与文件下载放在同一套核心里浏览器用户脚本负责从账号发布、收藏、点赞、搜索结果页面提取链接主程序负责批量下载两者可以通过服务器模式联动。同一份核心还提供 TUI、命令行、API、MCP 四种入口普通用户和脚本开发者不需要维护两套代码。从 0 到 1 跑起来程序运行于 macOS / Linux / Windows行为一致Linux 的剪贴板功能依赖系统自带的 xclip 或 xsel。克隆仓库到本地并进入目录git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader推荐路径uv同步依赖并启动终端界面uv sync --no-dev # 仅安装运行时依赖 uv run main.py # 启动 TUI 界面备选路径pip适合已有虚拟环境的机器pip install -r requirements.txt python main.py首次运行会在Volume/下生成settings.json配置文件作品文件默认保存到Volume/Download目录。提示macOS 下载的可执行文件未做代码签名首次运行被系统拦截时在终端执行xattr -cr 项目文件夹路径移除安全标记即可正常运行。按操作流使用以下按实际操作粒度递进先跑通单链接再处理批量与参数最后接入自动化。下载单个作品一条命令保存一条作品的全部内容。uv run main.py -u https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXX在 TUI 中操作是等价的把链接粘贴到顶部输入框点击下载作品文件按钮即可。关键参数--cookie网页版 Cookie无需登录未设置时视频只有低分辨率文件--image_format图片格式AUTO / PNG / WEBP / JPEG / HEIC默认 JPEG--folder_mode每个作品存入独立文件夹默认 false--name_format文件名格式默认发布时间 作者昵称 作品标题--work_path保存根路径默认为项目下的 Volume 目录预期效果终端依次显示解析与下载进度完成后到Volume/Download查看按命名规则生成的作品文件。批量下载多链接并自定义参数多个作品链接一次传入参数统一控制。uv run main.py -u 链接1 链接2 链接3 \ --image_format webp \ --folder_mode true注意设置--index参数时只处理首个链接多链接批量下载与指定图片序号互斥。命令行参数速查参数作用默认值--url / -u作品链接多个用空格分隔并整体加引号必填--index / -i指定图片序号如1 3 5仅对图文作品生效无--image_format / -if图片下载格式JPEG--folder_mode / -fm作品文件存入单独文件夹false--max_retry / -mr请求失败重试次数5预期效果三个作品依次解析下载已记录的作品 ID 自动跳过重复运行不会产生重复文件。监听剪贴板与浏览器脚本推送让下载跟着浏览行为自动发生。TUI 剪贴板监听启动程序后按M键开启监听此后每次复制小红书作品链接程序自动识别并开始下载在剪贴板输入close可停止监听。浏览器用户脚本在 Tampermonkey 中安装仓库内static/XHS-Downloader.js脚本可从账号发布、收藏、点赞、专辑、搜索结果页面批量提取作品链接将settings.json中的script_server设为true并保持主程序后台运行脚本菜单中的推送下载任务会把下载任务交给主程序处理文件格式与命名规则以服务器端配置为准。预期效果浏览小红书网页时随手复制链接或点击脚本菜单文件在后台自动进入下载目录不打断浏览节奏。调优与排障配置 Cookie 获取高清视频源Cookie 为非强制项但未设置时视频作品只能下载低分辨率文件。浏览器访问小红书网页版按F12打开开发者工具切换到网络选项卡并勾选保留日志过滤框输入cookie-name:web_session选择 Fetch/XHR 筛选器后点击任意作品全选复制请求中的 Cookie写入 TUI 设置界面或settings.json的cookie参数重新下载即可获取高画质源。处理性能、网络与解析异常性能类场景推荐值原因弱网环境--timeout 30默认 10 秒易误判超时网络不稳定--max_retry 10默认 5 次提高成功率节省存储空间--image_format webp同画质体积更小长视频下载--video_preference bitrate码率优先高码率源更完整网络类现象链接解析失败确认链接是刚复制的链接携带日期信息旧链接易被风控→ 检查 Cookie 是否过期并更新 → 仍失败时拉取最新源码重试。权限类现象Linux 读取剪贴板报错执行apt-get install xclip或apt-get install xsel安装剪贴板工具 → 重启程序再试。配置类现象重复作品被跳过已下载作品 ID 记录在Volume/ExploreID.db去重默认开启 → 确认需要重新下载时先删除数据库中对应作品 ID 再执行。现象Docker 中命令行参数不生效容器模式不支持命令行调用与剪贴板功能 → 改用粘贴链接或 API 模式。开发者扩展uv run main.py api # API 模式 uv run main.py mcp # MCP 模式启动后访问http://127.0.0.1:5556/docs查看交互式文档MCP 端点为http://127.0.0.1:5556/mcp/Streamable HTTP。接口方法说明/xhs/detailPOST传入作品链接返回作品信息可选同时下载文件/mcp/Streamable HTTPMCP 协议端点供 AI 客户端获取作品信息与下载文件/docsGET自动生成的交互式 API 文档最小调用示例from httpx import post url http://127.0.0.1:5556/xhs/detail data { url: https://www.xiaohongshu.com/explore/XXX?xsec_tokenXXX, # 必需参数 download: True, # 同时下载作品文件 index: [3, 6], # 仅图文作品下载指定序号图片 } print(post(url, jsondata, timeout30).json())仓库example.py提供了通过XHS类直接调用核心的完整参数示例适合二次开发。需要容器化部署时docker pull joeanamier/xhs-downloader docker run -p 5556:5556 -v xhs_volume:/app/Volume -it joeanamier/xhs-downloaderXHS-Downloader 把链接提取、无水印文件下载、去重与归档放在一个程序里完成TUI、命令行、API、MCP 四种入口共用同一套核心日常收藏与自动化接入不需要换工具。环境装好后可以先运行uv run main.py --version确认版本。问题反馈提交到仓库 Issue 区即可作者通过 Discord 与 QQ 群维护社区交流。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
![[光学原理与应用-521]：对光的错误理解与纠偏](http://pic.xiahunao.cn/yaotu/[光学原理与应用-521]：对光的错误理解与纠偏)
