XHS-Downloader

<div align="center"> <img src="static/XHS-Downloader.png" alt="XHS-Downloader" height="256" width="256"><br> <h1>XHS-Downloader</h1> <p>简体中文 | <a href="README_EN.md">English</a></p> <a href="https://trendshift.io/repositories/5435" target="_blank"><img src="https://trendshift.io/api/badge/repositories/5435" alt="JoeanAmier%2FXHS-Downloader | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a> <br> <img alt="GitHub" src="https://img.shields.io/github/license/JoeanAmier/XHS-Downloader?style=flat-square"> <img alt="GitHub forks" src="https://img.shields.io/github/forks/JoeanAmier/XHS-Downloader?style=flat-square&color=55efc4"> <img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/JoeanAmier/XHS-Downloader?style=flat-square&color=fda7df"> <img alt="GitHub code size in bytes" src="https://img.shields.io/github/languages/code-size/JoeanAmier/XHS-Downloader?style=flat-square&color=a29bfe"> <img alt="GitHub release (with filter)" src="https://img.shields.io/github/v/release/JoeanAmier/XHS-Downloader?style=flat-square&color=48dbfb"> <br> <img alt="Static Badge" src="https://img.shields.io/badge/Python-3.12-b8e994?style=flat-square&logo=python&labelColor=3dc1d3"> <img alt="Static Badge" src="https://img.shields.io/badge/UserScript-ffec3d?style=flat-square&logo=tampermonkey&logoColor=%2300485B"> <img src="https://img.shields.io/badge/Sourcery-enabled-884898?style=flat-square&color=1890ff" alt=""> <img alt="Static Badge" src="https://img.shields.io/badge/Docker-badc58?style=flat-square&logo=docker"> <img alt="GitHub all releases" src="https://img.shields.io/github/downloads/JoeanAmier/XHS-Downloader/total?style=flat-square&color=ffdd59"> </div> <br> <p>🔥 <b>小红书链接提取/作品采集工具</b>：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品链接、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书无水印作品文件！</p> <p>🔥 “小红书”、“XiaoHongShu”、“RedNote” 含义相同，本项目统称为 “小红书”</p> <h1>📑 项目功能</h1> <details> <summary>项目程序与用户脚本功能清单（点击展开）</summary> <ul><b>程序功能</b> <li>✅ 采集小红书作品信息</li> <li>✅ 提取小红书作品下载地址</li> <li>✅ 下载小红书无水印作品文件</li> <li>✅ 下载小红书 livePhoto 文件(含水印)</li> <li>✅ 自动跳过已下载的作品文件</li> <li>✅ 作品文件完整性处理机制</li> <li>✅ 自定义图文作品文件下载格式</li> <li>✅ 持久化储存作品信息至文件</li> <li>✅ 作品文件储存至单独文件夹</li> <li>✅ 后台监听剪贴板下载作品</li> <li>✅ 记录已下载作品 ID</li> <li>✅ 支持命令行下载作品文件</li> <li>✅ 从浏览器读取 Cookie</li> <li>✅ 自定义文件名称格式</li> <li>✅ 支持 API 调用功能</li> <li>✅ 支持 MCP 调用功能</li> <li>✅ 支持文件断点续传下载</li> <li>✅ 智能识别作品文件类型</li> <li>✅ 支持设置作者备注</li> <li>✅ 自动更新作者昵称</li> </ul> <ul><a href="#user-scripts"><b>脚本功能</b></a> <li>✅ 下载小红书无水印作品文件</li> <li>✅ 提取推荐页面作品链接</li> <li>✅ 提取账号发布作品链接</li> <li>✅ 提取账号收藏作品链接</li> <li>✅ 提取账号点赞作品链接</li> <li>✅ 提取账号专辑作品链接</li> <li>✅ 提取搜索结果作品链接</li> <li>✅ 提取搜索结果用户链接</li> </ul> </details> <h1>📸 程序截图</h1> <p><a href="https://www.bilibili.com/video/BV1Fcb3zWEjt/">前往 bilibili 观看演示</a>；<a href="https://youtu.be/VIjDytHaopg">前往 YouTube 观看演示</a></p> <img src="static/screenshot/程序运行截图CN1.png" alt=""> <hr> <img src="static/screenshot/程序运行截图CN2.png" alt=""> <hr> <img src="static/screenshot/程序运行截图CN3.png" alt=""> <h1>🔗 支持链接</h1> <ul> <li><code>https://www.xiaohongshu.com/explore/作品ID?xsec_token=XXX</code></li> <li><code>https://www.xiaohongshu.com/discovery/item/作品ID?xsec_token=XXX</code></li> <li><code>https://www.xiaohongshu.com/user/profile/作者ID/作品ID?xsec_token=XXX</code></li> <li><code>https://xhslink.com/分享码</code></li> <br/> <p><b>支持单次输入多个作品链接，链接之间使用空格分隔；程序会自动提取有效链接，无需额外处理！</b></p> </ul> <h1>🪟 关于终端</h1> <p>⭐ 推荐使用 <a href="https://learn.microsoft.com/zh-cn/windows/terminal/install">Windows 终端</a> （Windows 11 默认终端）运行程序以便获得最佳显示效果！</p> <h1>🥣 使用方法</h1> <p>如果仅需下载无水印作品文件，建议选择 <b>程序运行</b> 或 <b>Docker 运行</b>；如果有其他需求，建议选择 <b>源码运行</b>！</p> <p><code>2.2</code> 版本开始，项目功能无异常的情况下，无需额外处理 Cookie！</p> <h2>🖱 程序运行</h2> <p>⭐ Mac OS、Windows 10 及以上用户可前往 <a href="https://github.com/JoeanAmier/XHS-Downloader/releases/latest">Releases</a> 或者 <a href="https://github.com/JoeanAmier/XHS-Downloader/actions">Actions</a> 下载程序压缩包，解压后打开程序文件夹，双击运行 <code>main</code> 即可使用。</p> <p>⭐ 本项目包含自动构建可执行文件的 GitHub Actions，使用者可以随时使用 GitHub Actions 将最新源码构建为可执行文件！</p> <p>⭐ 自动构建可执行文件教程请查阅本文档的 <code>构建可执行文件指南</code> 部分；如果需要更加详细的图文教程，请 <a href="https://mp.weixin.qq.com/s/TorfoZKkf4-x8IBNLImNuw">查阅文章</a>！</p> <p><strong>注意：由于 Mac OS 平台的可执行文件 <code>main</code> 未经过代码签名，首次运行时会受到系统安全限制。请先在终端执行 <code>xattr -cr main.app</code> 命令移除安全标记，执行一次后即可正常运行。</strong></p> <p>若通过此方式使用程序，文件默认下载路径为：<code>.\_internal\Volume\Download</code>；配置文件路径为：<code>.\_internal\Volume\settings.json</code></p> <h3>程序更新</h3> <p><strong>方案一：</strong>下载并解压文件，将旧版本的 <code>_internal\Volume</code> 文件夹复制到新版本的 <code>_internal</code> 文件夹。</p> <p><strong>方案二：</strong>下载并解压文件（不要运行程序），复制全部文件，直接覆盖旧版本文件。</p> <h2>⌨️ Docker 运行</h2> <ol> <li>获取镜像</li> <ul> <li>方式一：使用 <code>Dockerfile</code> 文件构建镜像</li> <li>方式二：使用 <code>docker pull joeanamier/xhs-downloader</code> 命令拉取镜像</li> <li>方式三：使用 <code>docker pull ghcr.io/joeanamier/xhs-downloader</code> 命令拉取镜像</li> </ul> <li>创建容器</li> <ul> <li>TUI 模式：<code>docker run --name 容器名称(可选) -p 主机端口号:5556 -v xhs_downloader_volume:/app/Volume -it &lt;