$git clone https://github.com/JoeanAmier/XHS-Downloader小红书(XiaoHongShu、RedNote)链接提取/作品采集工具:提取账号发布、收藏、点赞、专辑作品链接;提取搜索结果作品、用户链接;采集小红书作品信息;提取小红书作品下载地址;下载小红书作品文件
| 1 | <div align="center"> |
| 2 | <img src="static/XHS-Downloader.png" alt="XHS-Downloader" height="256" width="256"><br> |
| 3 | <h1>XHS-Downloader</h1> |
| 4 | <p>简体中文 | <a href="README_EN.md">English</a></p> |
| 5 | <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> |
| 6 | <br> |
| 7 | <img alt="GitHub" src="https://img.shields.io/github/license/JoeanAmier/XHS-Downloader?style=flat-square"> |
| 8 | <img alt="GitHub forks" src="https://img.shields.io/github/forks/JoeanAmier/XHS-Downloader?style=flat-square&color=55efc4"> |
| 9 | <img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/JoeanAmier/XHS-Downloader?style=flat-square&color=fda7df"> |
| 10 | <img alt="GitHub code size in bytes" src="https://img.shields.io/github/languages/code-size/JoeanAmier/XHS-Downloader?style=flat-square&color=a29bfe"> |
| 11 | <img alt="GitHub release (with filter)" src="https://img.shields.io/github/v/release/JoeanAmier/XHS-Downloader?style=flat-square&color=48dbfb"> |
| 12 | <br> |
| 13 | <img alt="Static Badge" src="https://img.shields.io/badge/Python-3.12-b8e994?style=flat-square&logo=python&labelColor=3dc1d3"> |
| 14 | <img alt="Static Badge" src="https://img.shields.io/badge/UserScript-ffec3d?style=flat-square&logo=tampermonkey&logoColor=%2300485B"> |
| 15 | <img src="https://img.shields.io/badge/Sourcery-enabled-884898?style=flat-square&color=1890ff" alt=""> |
| 16 | <img alt="Static Badge" src="https://img.shields.io/badge/Docker-badc58?style=flat-square&logo=docker"> |
| 17 | <img alt="GitHub all releases" src="https://img.shields.io/github/downloads/JoeanAmier/XHS-Downloader/total?style=flat-square&color=ffdd59"> |
| 18 | </div> |
| 19 | <br> |
| 20 | <p>🔥 <b>小红书链接提取/作品采集工具</b>:提取账号发布、收藏、点赞、专辑作品链接;提取搜索结果作品链接、用户链接;采集小红书作品信息;提取小红书作品下载地址;下载小红书作品文件!</p> |
| 21 | <p>🔥 “小红书”、“XiaoHongShu”、“RedNote” 含义相同,本项目统称为 “小红书”</p> |
| 22 | <h1>📑 项目功能</h1> |
| 23 | <details> |
| 24 | <summary>项目程序与用户脚本功能清单(点击展开)</summary> |
| 25 | <ul><b>程序功能</b> |
| 26 | <li>✅ 采集小红书作品信息</li> |
| 27 | <li>✅ 提取小红书作品下载地址</li> |
| 28 | <li>✅ 下载小红书作品文件</li> |
| 29 | <li>✅ 下载小红书 livePhoto 文件</li> |
| 30 | <li>✅ 自动跳过已下载的作品文件</li> |
| 31 | <li>✅ 作品文件完整性处理机制</li> |
| 32 | <li>✅ 自定义图文作品文件下载格式</li> |
| 33 | <li>✅ 持久化储存作品信息至文件</li> |
| 34 | <li>✅ 作品文件储存至单独文件夹</li> |
| 35 | <li>✅ 后台监听剪贴板下载作品</li> |
| 36 | <li>✅ 记录已下载作品 ID</li> |
| 37 | <li>✅ 支持命令行下载作品文件</li> |
| 38 | <li>☑️ 从浏览器读取 Cookie</li> |
| 39 | <li>✅ 自定义文件名称格式</li> |
| 40 | <li>✅ 支持 API 调用功能</li> |
| 41 | <li>✅ 支持 MCP 调用功能</li> |
| 42 | <li>✅ 支持文件断点续传下载</li> |
| 43 | <li>✅ 智能识别作品文件类型</li> |
| 44 | <li>✅ 支持设置作者备注</li> |
| 45 | <li>✅ 自动更新作者昵称</li> |
| 46 | </ul> |
| 47 | <ul><a href="#user-scripts"><b>脚本功能</b></a> |
| 48 | <li>✅ 下载小红书作品文件</li> |
| 49 | <li>✅ 提取推荐页面作品链接</li> |
| 50 | <li>✅ 提取账号发布作品链接</li> |
| 51 | <li>✅ 提取账号收藏作品链接</li> |
| 52 | <li>✅ 提取账号点赞作品链接</li> |
| 53 | <li>✅ 提取账号专辑作品链接</li> |
| 54 | <li>✅ 提取搜索结果作品链接</li> |
| 55 | <li>✅ 提取搜索结果用户链接</li> |
| 56 | </ul> |
| 57 | </details> |
| 58 | <h1>📸 程序截图</h1> |
| 59 | <p><a href="https://www.bilibili.com/video/BV1Fcb3zWEjt/">前往 bilibili 观看演示</a>;<a href="https://youtu.be/VIjDytHaopg">前往 YouTube 观看演示</a></p> |
| 60 | <img src="static/screenshot/程序运行截图CN1.png" alt=""> |
| 61 | <hr> |
| 62 | <img src="static/screenshot/程序运行截图CN2.png" alt=""> |
| 63 | <hr> |
| 64 | <img src="static/screenshot/程序运行截图CN3.png" alt=""> |
| 65 | <h1>🔗 支持链接</h1> |
| 66 | <ul> |
| 67 | <li><code>https://www.xiaohongshu.com/explore/作品ID?xsec_token=XXX</code></li> |
| 68 | <li><code>https://www.xiaohongshu.com/discovery/item/作品ID?xsec_token=XXX</code></li> |
| 69 | <li><code>https://www.xiaohongshu.com/user/profile/作者ID/作品ID?xsec_token=XXX</code></li> |
| 70 | <li><code>https://xhslink.com/分享码</code></li> |
| 71 | <br/> |
| 72 | <p><b>支持单次输入多个作品链接,链接之间使用空格分隔;程序会自动提取有效链接,无需额外处理!</b></p> |
| 73 | </ul> |
| 74 | <h1>🪟 关于终端</h1> |
| 75 | <p>⭐ 推荐使用 <a href="https://learn.microsoft.com/zh-cn/windows/terminal/install">Windows 终端</a> (Windows 11 默认终端)运行程序以便获得最佳显示效果!</p> |
| 76 | <h1>🥣 使用方法</h1> |
| 77 | <p>如果仅需下载作品文件,建议选择 <b>程序运行</b> 或 <b>Docker 运行</b>;如果有其他需求,建议选择 <b>源码运行</b>!</p> |
| 78 | <p>⚠️ Cookie 配置为非强制项;如遇功能异常,建议配置或更新 Cookie 后再次尝试!</p> |
| 79 | <p>⚠️ 未设置 Cookie 时,视频作品只能下载低分辨率文件;建议配置 Cookie 以获取更高画质(无需登录账号)!</p> |
| 80 | <h2>🖱 程序运行</h2> |
| 81 | <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> |
| 82 | <p>⭐ 本项 |