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>

# 📑 Project Features

This project provides tools for extracting information and downloading content from Xiaohongshu (小红书).

**Program Features:**

*   ✅ Collect Xiaohongshu post information.
*   ✅ Extract Xiaohongshu post download URLs.
*   ✅ Download Xiaohongshu watermark-free post files.
*   ✅ Download Xiaohongshu livePhoto files (with watermark).
*   ✅ Automatically skip already downloaded post files.
*   ✅ Post file integrity handling mechanism.
*   ✅ Customizable download format for image and text posts.
*   ✅ Persistently store post information to a file.
*   ✅ Store post files in separate folders.
*   ✅ Background monitoring of the clipboard for downloading posts.
*   ✅ Record downloaded post IDs.
*   ✅ Support command-line downloading of post files.
*   ✅ Read Cookie from browser.
*   ✅ Customizable file naming format.
*   ✅ Support API call functionality.
*   ✅ Support MCP call functionality.
*   ✅ Support breakpoint resume download.
*   ✅ Intelligent identification of post file types.
*   ✅ Support setting author notes.
*   ✅ Automatically update author nicknames.

**User Script Features:**

*   ✅ Download Xiaohongshu watermark-free post files.
*   ✅ Extract post links from the recommendation page.
*   ✅ Extract post links from an account's published posts.
*   ✅ Extract post links from an account's collected posts.
*   ✅ Extract post links from an account's liked posts.
*   ✅ Extract post links from an account's album posts.
*   ✅ Extract post links from search results.
*   ✅ Extract user links from search results.

<p>⭐ XHS-Downloader development plan and progress can be found at <a href="https://github.com/users/JoeanAmier/projects/5">Projects</a></p>

# 📸 Screenshots

<p><b>🎥 Click the images to watch the demo video</b></p>

<a href="https://www.bilibili.com/video/BV1v1LwzsEi9/"><img src="static/screenshot/程序运行截图CN1.png" alt=""></a>
<hr>
<a href="https://www.bilibili.com/video/BV1v1LwzsEi9/"><img src="static/screenshot/程序运行截图CN2.png" alt=""></a>
<hr>
<a href="https://www.bilibili.com/video/BV1v1LwzsEi9/"><img src="static/screenshot/程序运行截图CN3.png" alt=""></a>

# 🔗 Supported Links

*   `https://www.xiaohongshu.com/explore/作品ID?xsec_token=XXX`
*   `https://www.xiaohongshu.com/discovery/item/作品ID?xsec_token=XXX`
*   `https://www.xiaohongshu.com/user/profile/作者ID/作品ID?xsec_token=XXX`
*   `https://xhslink.com/分享码`

<br/>

<p><b>Supports entering multiple post links at once, separated by spaces; the program will automatically extract valid links, no extra processing required!</b></p>

# 🪟 About Terminal

<p>⭐ It is recommended to use <a href="https://learn.microsoft.com/zh-cn/windows/terminal/install">Windows Terminal</a> (the default terminal for Windows 11) to run the program for the best display effect!</p>

# 🥣 Usage

If you only need to download watermark-free post files, it is recommended to choose **Program Execution** or **Docker Execution**; if you have other needs, it is recommended to choose **Source Code Execution**!

<p><code>2.2</code> version onwards, no extra Cookie handling is required if the project functions normally!</p>

## 🖱 Program Execution

<p>⭐ Mac OS, Windows 10 and above users can go to <a href="https://github.com/JoeanAmier/XHS-Downloader/releases/latest">Releases</a> or <a href="https://github.com/JoeanAmier/XHS-Downloader/actions">Actions</a> to download the program package, unzip it, open the program folder, and double-click <code>main</code> to use it.</p>

<p>⭐ This project includes GitHub Actions that automatically build executable files, and users can use GitHub Actions to build the latest source code into executable files at any time!</p>

<p>⭐ Please refer to the <code>Building Executable Files Guide</code> section of this document for a tutorial on automatically building executable files; for a more detailed picture tutorial, please <a href="https://mp.weixin.qq.com/s/TorfoZKkf4-x8IBNLImNuw">read the article</a>!</p>

<p><strong>Note: The executable file <code>main</code> on the Mac OS platform may need to be started from the terminal command line; due to device limitations, the executable file on the Mac OS platform has not been tested and its availability cannot be guaranteed!</strong></p>

If you use the program in this way, the default file download path is: <code>.\_internal\Volume\Download</code>; the configuration file path is: <code>.\_internal\Volume\settings.json</code>

### Program Update

<p><strong>Option 1:</strong> Download and unzip the file, and copy the old version of the <code>_internal\Volume</code> folder to the new version of the <code>_internal</code> folder.</p>

<p><strong>Option 2:</strong> Download and unzip the file (do not run the program), copy all the files, and directly overwrite the old version of the files.</p>

## ⌨️ Docker Execution

<ol>
<li>Get the image</li>