XHS-Downloader

MCP数据服务

提供方 JoeanAmier · 包名 xhs-downloader

数据服务 stdio · 本地进程 未标注 社区 / 第三方 Claude DesktopCursorClineClaude Code
查看接入方式

小红书(XiaoHongShu、RedNote)链接提取/作品采集工具:提取账号发布、收藏、点赞、专辑作品链接;提取搜索结果作品、用户链接;采集小红书作品信息;提取小红书作品下载地址;下载小红书作品文件

一句话选型结论

按资料字段整理

XHS-Downloader 属于数据服务类 MCP 服务器,stdio · 本地进程,鉴权方式未标注,可直接接入 Claude Desktop、Cursor、Cline 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式stdio · 本地进程 鉴权未标注 部署方式本地部署
GitHub 星标 10,786 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

xhs-downloader api docker download fastapi

支持客户端

适用场景

xhs-downloaderapidocker

安装与配置

stdio · 本地进程 未标注
客户端在本机拉起子进程,数据不出本机
docker

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Cross-platform,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Cursor、Cline,换客户端不用重新研究配置。
  • 仓库有一定关注度(星标 10,786),遇到问题更容易搜到资料。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
XHS-Downloader当前 未标注 stdio · 本地进程 本地部署 有 2026-04-12
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方JoeanAmier上游标注的维护方 JoeanAmier
分类数据服务本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式未标注远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时xhs-downloader · Cross-platform本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-04-12上游最后核验时间

详细介绍

29.6 KB
来自项目仓库与上游目录的原文,未做删改

XHS-Downloader

简体中文 | English

🔥 小红书(XiaoHongShu、RedNote)链接提取/作品采集工具!


📑 项目功能

项目程序与用户脚本功能清单,快速了解项目能力(点击展开)

程序功能

  • ✅ 采集小红书作品信息

  • ✅ 提取小红书作品下载地址

  • ✅ 下载小红书作品文件

  • ✅ 下载视频作品封面文件

  • ✅ 下载小红书 livePhoto 文件

  • ✅ 自动跳过已下载的作品文件

  • ✅ 作品文件完整性处理机制

  • ✅ 自定义图文作品文件下载格式

  • ✅ 持久化储存作品信息至文件

  • ✅ 作品文件储存至单独文件夹

  • ✅ 后台监听剪贴板下载作品

  • ✅ 记录已下载作品 ID

  • ✅ 支持命令行下载作品文件

  • ☑️ 从浏览器读取 Cookie

  • ✅ 自定义文件名称格式

  • ✅ 支持 API 调用功能

  • ✅ 支持 MCP 调用功能

  • ✅ 支持 API、MCP 和用户脚本鉴权

  • ✅ 支持文件断点续传下载

  • ✅ 智能识别作品文件类型

  • ✅ 支持设置作者备注

  • ✅ 自动更新作者昵称

脚本功能

  • ✅ 下载小红书作品文件

  • ✅ 提取推荐页面作品链接

  • ✅ 提取账号发布作品链接

  • ✅ 提取账号收藏作品链接

  • ✅ 提取账号点赞作品链接

  • ✅ 提取账号专辑作品链接

  • ✅ 提取搜索结果作品链接

  • ✅ 提取搜索结果用户链接

📸 程序截图

前往 bilibili 观看演示;前往 YouTube 观看演示

GUI 界面截图


TUI 界面截图(模式命令:python .\main.py TUI)

🔗 支持链接

  • 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/分享码

支持单次输入多个作品链接,链接之间使用空格分隔;程序会自动提取有效链接,无需额外处理!

🥣 使用方法

如果仅需下载作品文件,建议选择 程序运行 或 Docker 运行;如果有其他需求,建议选择 源码运行!

⚠️ Cookie 配置为非强制项;如遇功能异常,建议配置或更新 Cookie 后再次尝试!

⚠️ 未设置 Cookie 时,视频作品只能下载低分辨率文件;建议配置 Cookie 以获取更高画质(无需登录账号)!

🖱 程序运行

⭐ Mac OS、Windows 10 及以上用户可前往 Releases 或者 Actions 下载程序压缩包,解压后打开程序文件夹,双击运行 main 即可使用。

⭐ 本项目包含自动构建可执行文件的 GitHub Actions,使用者可以随时使用 GitHub Actions 将最新源码构建为可执行文件!

⭐ 自动构建可执行文件教程请查阅本文档的 构建可执行文件指南 部分;如果需要更加详细的图文教程,请 查阅文章!

注意:由于 Mac OS 平台的可执行文件 main 未经过代码签名,首次运行时会受到系统安全限制。请先在终端执行 xattr -cr 项目文件夹路径 命令移除安全标记,执行一次后即可正常运行。

若通过此方式使用程序,文件默认下载路径为:.\Volume\Download;配置文件路径为:.\Volume\settings.json

程序更新

方案一:下载并解压文件,将旧版本的 Volume 文件夹复制到新版本的程序根目录。

方案二:下载并解压文件(不要运行程序),复制全部文件,直接覆盖旧版本文件。

⌨️ 源码运行

  • 安装不低于 3.12 版本的 Python 解释器

  • 下载最新的源码或 Releases 发布的源码至本地

使用 pip 安装项目依赖

  • 运行 python -m venv venv 命令创建虚拟环境(可选)

  • 运行 .\venv\Scripts\activate.ps1 或者 venv\Scripts\activate 命令激活虚拟环境(可选)

  • 运行 pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt 命令安装程序所需模块

  • 运行 python .\main.py 或者 python main.py 命令启动 XHS-Downloader

使用 uv 安装项目依赖(推荐)

  • 运行 uv sync --no-dev 命令同步环境依赖

  • 运行 uv run main.py 命令启动 XHS-Downloader

⌨️ Docker 运行

  • 获取镜像

  • 方式一:使用 Dockerfile 文件构建镜像

  • 方式二:使用 docker pull joeanamier/xhs-downloader 命令拉取镜像

  • 方式三:使用 docker pull ghcr.io/joeanamier/xhs-downloader 命令拉取镜像

  • 创建容器

  • TUI 模式:docker run --name 容器名称(可选) -p 主机端口号:5556 -v xhs_downloader_volume:/app/Volume -it <镜像名称>

  • API 模式:docker run --name 容器名称(可选) -p 主机端口号:5556 -v xhs_downloader_volume:/app/Volume -it <镜像名称> python main.py api

  • MCP 模式:docker run --name 容器名称(可选) -p 主机端口号:5556 -v xhs_downloader_volume:/app/Volume -it <镜像名称> python main.py mcp

注意:此处的 <镜像名称> 需与您在第一步中使用的镜像名称保持一致(joeanamier/xhs-downloader 或 ghcr.io/joeanamier/xhs-downloader)

  • 运行容器

  • 启动容器:docker start -i 容器名称/容器 ID

  • 重启容器:docker restart -i 容器名称/容器 ID

Docker 运行项目时不支持 命令行调用模式,无法使用 读取剪贴板 与 监听剪贴板 功能,可以正常粘贴内容,其他功能如有异常请反馈!

🛠 命令行模式

命令行模式说明,适合习惯命令行操作或需要脚本化调用的用户(点击展开)

项目支持命令行运行模式,可通过命令行参数直接下载作品文件,也可以设置需要下载的图片序号!

注意:未设置 --index 参数时,支持传入多个作品链接,全部链接需要使用引号包围,链接之间使用空格分隔;已设置 --index 参数时,不支持传入多个作品链接,即使传入多个作品链接,程序仅处理首个作品链接!

bool 类型参数支持使用 true、false、1、0、yes、no、on 或 off(不区分大小写)来设置。

生成鉴权令牌

python .\main.py token

使用 uv 时可以运行 uv run main.py token 获取鉴权令牌。

从浏览器读取 Cookie

该功能已失效,请参考 获取 Cookie 教程!

可以使用命令行实现 从浏览器读取 Cookie 并写入配置文件!

命令示例:python .\main.py --browser_cookie Chrome --update_settings

兼容性提醒:此功能依赖的第三方模块已长期未更新,可能无法正常支持最新浏览器版本。若功能出现异常,请尝试手动获取 Cookie!



🖥 服务器模式

服务器模式包含 API 模式和 MCP 模式!

鉴权令牌

API 和 MCP 模式启动时会在终端输出鉴权令牌。

令牌默认永久有效,请勿公开。令牌与当前项目的 Volume/auth_secret.key 文件绑定;如需更换令牌,可以删除该文件,程序下次启动或生成令牌时会自动创建新的密钥,旧令牌随即失效。

API 模式

API 模式说明,适合需要调用接口获取作品数据或下载文件的开发者(点击展开)

启动:运行命令:python .\main.py api

关闭:按下 Ctrl + C 关闭服务器

调用业务接口时必须在请求头中携带 Authorization: Bearer <令牌>,未携带或令牌无效时返回 403。在 /docs 页面中点击右上角 Authorize,输入令牌即可调试接口。

访问 http://127.0.0.1:5556/docs 或者 http://127.0.0.1:5556/redoc;你会看到自动生成的交互式 API 文档!

请求接口:/xhs/detail

请求方法:POST

请求格式:JSON

请求参数:

参数
类型
含义
默认值

url
str
小红书作品链接,自动提取,不支持多链接;必需参数
无

bool
是否下载作品文件;设置为 true 将会耗费更多时间;可选参数
false

index
list[int]
下载指定序号的图片文件,仅对图文作品生效;download 参数设置为 false 时不生效;可选参数
null

cookie
str
请求数据时使用的 Cookie;可选参数
配置文件 cookie 参数

proxy
str
请求数据时使用的代理;可选参数
配置文件 proxy 参数

check_record
bool
是否跳过已有下载记录的作品;可选参数
true

代码示例:

async def example_api():
"""通过 API 设置参数,适合二次开发"""
server = "http://127.0.0.1:5556/xhs/detail"
data = {
"url": "", # 必需参数
"download": True,
"index": [
3,
6,
9,
],
"proxy": "http://127.0.0.1:10808",
}
token = "API 模式启动时输出的鉴权令牌"
headers = {"Authorization": f"Bearer {token}"}
response = post(server, json=data, headers=headers, timeout=10)
print(response.json())

MCP 模式

MCP 模式说明,适合需要启动 MCP 服务接入 AI 助手等工具的开发者(点击展开)

MCP 模式为可选功能,源码运行时需额外安装 fastmcp 库,参考命令:pip install "fastmcp>=4.1.0" 或 uv sync --no-dev --extra mcp

启动:运行命令:python .\main.py mcp

关闭:按下 Ctrl + C 关闭服务器

调用 MCP 的 HTTP 接口时,客户端必须在请求头中携带 Authorization: Bearer <令牌>;未携带或令牌无效时请求会被拒绝。

MCP 配置示例

STDIO
)

Streamable HTTP

MCP URL:http://127.0.0.1:5556/mcp

{
"mcpServers": {
"XHS-Downloader": {
"url": "http://127.0.0.1:5556/mcp",
"headers": {
"Authorization": "Bearer <鉴权令牌>"
}
}
}
}

MCP 调用示例

获取小红书作品信息


下载小红书作品文件

下载图文作品时可以指定需要下载的图片序号;默认不返回作品信息,如需返回作品信息,请在对话时明确表述。


📜 其他说明

  • 由于作品链接携带日期信息,使用先前日期获取的作品链接可能会被风控,建议下载作品文件时使用最新获取的作品链接

  • 如果需要程序使用代理请求数据,请在配置文件 settings.json 设置 proxy 参数

  • Windows 系统需要以管理员身份运行程序才能读取 Chromium、Chrome、Edge 浏览器 Cookie

  • 如果开启保存作品数据至文件功能,作品数据默认储存至 ./Volume/Download/ExploreData.db 文件

  • 程序下载记录数据储存至 ./Volume/ExploreID.db 文件

  • 为了避免请求频率过高对平台服务器造成影响,本项目内置请求延时机制

🕹 用户脚本

如果您的浏览器安装了 Tampermonkey 浏览器扩展程序,可以使用用户脚本体验项目功能!

用户脚本链接(右键单击复制链接):master 分支、develop 分支


查看 Tampermonkey 用户脚本截图(点击展开)




提示:使用 XHS-Downloader 用户脚本批量提取作品链接,搭配 XHS-Downloader 程序可以实现批量下载作品文件!

修改用户脚本语言

🌏 连接服务器

⭐ 本项目支持通过浏览器用户脚本与主程序联动,实现一键推送下载任务。

功能说明:

  • 在项目程序的配置文件中,需要将 script_server 参数设置为 true

  • 保持项目程序在后台运行,它将作为服务器,接收用户脚本的指令(TUI、MCP 和 API 模式均支持)

  • 首次配置或令牌更换时,在用户脚本设置中填写鉴权令牌;参考 CLI 章节的生成鉴权令牌说明

  • 当您在浏览器中访问作品页面时,点击用户脚本菜单中的 推送下载任务 选项

  • 用户脚本会将下载任务发送给项目程序,由项目程序负责处理和下载文件

📜 脚本说明

  • 下载小红书作品文件时,脚本需要花费时间处理文件,请等待片刻,请勿多次点击下载按钮

  • 提取账号发布、收藏、点赞、专辑作品链接时,脚本可以自动滚动页面直至加载全部作品

  • 提取推荐作品链接、搜索作品、用户链接时,脚本可以自动滚动指定次数加载更多内容,默认滚动次数:50 次

  • 自动滚动页面功能默认关闭;用户可以自由开启,并修改滚动页面次数,修改后立即生效

  • 如果未开启自动滚动页面功能,用户需要手动滚动页面以便加载更多内容后再进行其他操作

  • 支持作品文件打包下载;该功能默认开启,多个文件的作品将会以压缩包格式下载

  • 向服务器推送下载任务时,文件格式、名称规则等设置以服务器配置文件中的设置为准

  • 使用全局代理工具可能会导致脚本下载文件失败,如有异常,请尝试关闭代理工具,必要时向作者反馈

  • XHS-Downloader 用户脚本仅实现可见即可得的数据采集功能,无任何收费功能和破解功能

自动滚动页面功能代码已重构,该功能默认关闭!启用该功能可能会被小红书检测为自动化操作,从而导致账号受到风控或封禁风险!

💻 二次开发

二次开发代码示例,适合基于项目进行二次开发的开发者(点击展开)

如果有其他需求,可以根据 example.py 的注释提示进行代码调用或修改!

async def example():
"""通过代码设置参数,适合二次开发"""
# 示例链接
demo_link = "https://www.xiaohongshu.com/explore/XXX?xsec_token=XXX"
# 实例对象
work_path = "D:\" # 作品数据/文件保存根路径,默认值:项目根路径
folder_name = "Download" # 作品文件储存文件夹名称(自动创建),默认值:Download
name_format = "作品标题 作品描述"
impersonate = "chrome146" # 浏览器模拟目标
cookie = "" # 小红书网页版 Cookie
proxy = None # 网络代理
proxy_download = False # 下载文件时,是否使用 proxy 参数的网络代理
timeout = 5 # 请求数据超时限制,单位:秒
chunk = 1024 * 1024 * 10 # 下载文件时,每次从服务器获取的数据块大小,单位:字节
max_retry = 2 # 请求数据失败时,重试的最大次数,单位:次
avg_delay = 6.0 # 请求数据的间隔时间均值,单位:秒
record_data = False # 是否保存作品数据至文件
image_format = "WEBP" # 图文作品文件下载格式,支持:AUTO、PNG、WEBP、JPEG、HEIC
folder_mode = False # 是否将每个作品的文件储存至单独的文件夹
image_download = True # 图文、图集作品文件下载开关
video_download = True # 视频作品文件下载开关
video_cover_download = False # 视频作品封面文件下载开关
live_download = False # 图文动图文件下载开关
download_record = True # 是否记录下载成功的作品 ID
language = "zh_CN" # 设置程序提示语言
author_archive = True # 是否将每个作者的作品存至单独的文件夹
write_mtime = True # 是否将作品文件的 修改时间 修改为作品的发布时间
note_format = "" # 作品信息保存格式,支持:txt、md、all,为空则不保存
# read_cookie = None # 读取浏览器 Cookie,支持设置浏览器名称(字符串)或者浏览器序号(整数),设置为 None 代表不读取
# async with XHS() as xhs:
# pass # 使用默认参数
async with XHS(
work_path=work_path,
folder_name=folder_name,
name_format=name_format,
impersonate=impersonate,
cookie=cookie,
proxy=proxy,
proxy_download=proxy_download,
timeout=timeout,
chunk=chunk,
max_retry=max_retry,
avg_delay=avg_delay,
record_data=record_data,
image_format=image_format,
folder_mode=folder_mode,
image_download=image_download,
video_download=video_download,
video_cover_download=video_cover_download,
live_download=live_download,
download_record=download_record,
language=language,
# read_cookie=read_cookie,
author_archive=author_archive,
write_mtime=write_mtime,
note_format=note_format,
) as xhs: # 使用自定义参数
download = True # 是否下载作品文件,默认值:False
# 返回作品详细信息,包括下载地址
# 获取数据失败时返回空字典
print(
await xhs.extract(
demo_link,
index=[
1,
2,
5,
],
)
)

📋 读取剪贴板

读取剪贴板平台说明,适合 Windows 以外的用户(Mac / Linux)(点击展开)

项目使用 pyperclip 实现读取剪贴板功能,该模块在不同的系统上会有差异。

在 Windows 上,不需要额外的模块。

在 Mac 上,该模块使用 pbcopy 和 pbpaste 命令,这些命令应该随操作系统一起提供。

在 Linux 上,该模块使用 xclip 或 xsel 命令,这些命令应该随操作系统一起提供。否则,请运行 "sudo apt-get install xclip" 或 "sudo apt-get install xsel"(注意:xsel 似乎并不总是有效)

在其他 Linux 系统上,你需要安装 qtpy 或 PyQT5 模块。

⚙️ 配置文件

配置文件参数说明,适合需要直接修改程序配置参数的用户(点击展开)

项目根目录下的 ./Volume/settings.json 文件,首次运行自动生成,可以自定义程序运行参数;如果设置了无效的参数值,程序将会使用参数默认值!

如果您在程序界面修改配置时无法正常交互,可以直接编辑配置文件;如果您的计算机没有合适的程序编辑 JSON 文件,建议使用 在线工具 编辑配置文件内容,修改后需要重启软件才能生效。

参数
类型
含义
默认值

mapping_data
str: str

作者别名映射表,格式:作者ID: 作者别名

无

work_path
str
作品数据 / 文件保存根路径
项目根路径/Volume

folder_name
str
作品文件储存文件夹名称

name_format
str
作品文件名称格式,字段之间使用空格分隔,支持字段:收藏数量、评论数量、分享数量、点赞数量、作品标签、作品ID、作品标题、作品描述、作品类型、发布时间、最后更新时间、作者昵称、作者ID
发布时间 作者昵称 作品标题

impersonate
str
浏览器模拟目标;参考 curl_cffi 文档
chrome146

cookie
str
小红书网页版 Cookie,无需登录,非必需参数!
无

proxy
str
设置程序代理
null

proxy_download
bool
下载文件时,是否使用 proxy 参数的网络代理
false

timeout
int
请求数据超时限制,单位:秒
10

avg_delay
float
请求数据的间隔时间均值,单位:秒;最小值 0.1
6.0

chunk
int
下载文件时,每次从服务器获取的数据块大小,单位:字节
2097152(2 MB)

max_retry
int
请求数据失败时,重试的最大次数,单位:秒
5

record_data
bool
是否保存作品数据至 SQLite 数据库(所有作品统一保存)
false

image_format
str
图文作品文件下载格式,支持:AUTO、PNG、WEBP、JPEG、HEIC
部分作品没有 HEIC 格式的文件,此时下载的文件可能为 WEBP 格式!
设置为 AUTO 时表示动态格式,实际格式取决于服务器响应数据!
JPEG

image_download
bool
图文、图集作品文件下载开关
true

video_download
bool
视频作品文件下载开关
true

video_cover_download
bool
视频作品封面下载开关;封面格式与图文作品文件格式一致
false

live_download
bool
图文动图文件下载开关
false

video_preference
str
视频作品文件下载偏好;含义:resolution:分辨率优先;bitrate:码率优先;size:文件大小优先
resolution

folder_mode
bool
是否将每个作品的文件储存至单独的文件夹;文件夹名称与文件名称保持一致
false

download_record
bool
是否记录下载成功的作品 ID,如果开启,程序将会自动跳过下载存在记录的作品
true

author_archive
bool

是否将每个作者的作品储存至单独的文件夹;文件夹名称为 作者ID_作者昵称

false

write_mtime
bool
是否将作品文件的 修改时间 属性修改为作品的发布时间
false

language
str
设置程序语言,目前支持:zh_CN、en_US
zh_CN

script_server
bool
是否开启用户脚本服务器,用于接收浏览器用户脚本的下载任务(TUI、MCP 和 API 模式生效)
false

note_format
str
作品信息保存格式(每个作品单独保存);含义:txt:纯文本;md:Markdown;all:全部格式;为空则不保存
空字符串


如果 author_archive 参数设置为 true,程序会把每个作者的作品储存至单独的文件夹;当作者的昵称发生变化时,程序会自动更新已下载作品文件名称中的作者昵称部分!

除此之外,你还可以通过设置 mapping_data 参数为某个作者设置别名;如果对某个作者设置了别名,程序会使用你设置的作者别名去替代作者昵称!

🌐 Cookie

  • 打开浏览器(可选无痕模式启动),访问 https://www.xiaohongshu.com/explore

  • 登录小红书账号(可跳过)

  • 按下 F12 打开开发人员工具

  • 选择 网络 选项卡

  • 勾选 保留日志

  • 在 过滤 输入框输入 cookie-name:web_session

  • 选择 Fetch/XHR 筛选器

  • 点击小红书页面任意作品

  • 在 网络 选项卡选择任意数据包(如果无数据包,重复步骤7)

  • 全选复制 Cookie 写入程序或配置文件

🗳 下载记录

XHS-Downloader 会将下载过的作品 ID 储存至数据库,当重复下载相同的作品时,XHS-Downloader 会自动跳过该作品的文件下载(即使作品文件不存在),如果想要重新下载作品文件,请先删除数据库中对应的作品 ID,再使用 XHS-Downloader 下载作品文件!

该功能默认开启,如果关闭该功能,XHS-Downloader 会检查文件是否存在,若文件存在则跳过下载!

构建可执行文件指南

构建可执行文件指南,适合希望自行构建可执行文件的用户(点击展开)

本指南将引导您通过 Fork 本仓库并执行 GitHub Actions 自动完成基于最新源码的程序构建和打包!


使用步骤

1. Fork 本仓库

  1. 点击项目仓库右上角的 Fork 按钮,将本仓库 Fork 到您的个人 GitHub 账户中
  2. 您的 Fork 仓库地址将类似于:https://github.com/your-username/this-repo

2. 启用 GitHub Actions

  1. 前往您 Fork 的仓库页面
  2. 点击顶部的 Settings 选项卡
  3. 点击右侧的 Actions 选项卡
  4. 点击 General 选项
  5. 在 Actions permissions 下,选择 Allow all actions and reusable workflows 选项,点击 Save 按钮

3. 手动触发打包流程

  1. 在您 Fork 的仓库中,点击顶部的 Actions 选项卡
  2. 找到名为 构建可执行文件 的工作流
  3. 点击右侧的 Run workflow 按钮:
    • 选择 master 或者 develop 分支
    • 点击 Run workflow

4. 查看打包进度

  1. 在 Actions 页面中,您可以看到触发的工作流运行记录
  2. 点击运行记录,查看详细的日志以了解打包进度和状态

5. 下载打包结果

  1. 打包完成后,进入对应的运行记录页面
  2. 在页面底部的 Artifacts 部分,您将看到打包的结果文件
  3. 点击下载并保存到本地,即可获得打包好的程序

注意事项

  1. 资源使用:

    • Actions 的运行环境由 GitHub 免费提供,普通用户每月有一定的免费使用额度(2000 分钟)
  2. 代码修改:

    • 您可以自由修改 Fork 仓库中的代码以定制程序打包流程
    • 修改后重新触发打包流程,您将得到自定义的构建版本
  3. 与主仓库保持同步:

    • 如果主仓库更新了代码或工作流,建议您定期同步 Fork 仓库以获取最新功能和修复

Actions 常见问题

Q1: 为什么我无法触发工作流?

A: 请确认您已按照步骤 启用 Actions,否则 GitHub 会禁止运行工作流

Q2: 打包流程失败怎么办?

A:

  • 检查运行日志,了解失败原因
  • 确保代码没有语法错误或依赖问题
  • 如果问题仍未解决,可以在本仓库的 Issues 页面 提出问题

Q3: 我可以直接使用主仓库的 Actions 吗?

A: 由于权限限制,您无法直接触发主仓库的 Actions。请通过 Fork 仓库的方式执行打包流程

💝 项目赞助

DartNode

♥️ 支持项目

如果 XHS-Downloader 对您有帮助,请考虑为它点个 Star ⭐,感谢您的支持!

微信(WeChat)
支付宝(Alipay)

如果您愿意,可以考虑提供资助为 XHS-Downloader 提供额外的支持!

🌟 贡献指南

贡献指南,适合希望为本项目贡献代码的开发者(点击展开)

欢迎对本项目做出贡献!为了保持代码库的整洁、高效和易于维护,请仔细阅读以下指南,以确保您的贡献能够顺利被接受和整合。

  • 在开始开发前,请从 develop 分支拉取最新的代码,以此为基础进行修改;这有助于避免合并冲突并保证您的改动基于最新的项目状态。

  • 如果您的更改涉及多个不相关的功能或问题,请将它们分成多个独立的提交或拉取请求。

  • 每个拉取请求应尽可能专注于单一功能或修复,以便于代码审查和测试。

  • 遵循现有的代码风格;请确保您的代码与项目中已有的代码风格保持一致;建议使用 Ruff 工具保持代码格式规范。

  • 编写可读性强的代码;添加适当的注释帮助他人理解您的意图。

  • 每个提交都应该包含一个清晰、简洁的提交信息,以描述所做的更改。提交信息应遵循以下格式:<类型>: <简短描述>

  • 当您准备提交拉取请求时,请优先将它们提交到 develop 分支;这是为了给维护者一个缓冲区,在最终合并到 master
    分支之前进行额外的测试和审查。

  • 建议在开发前或遇到疑问时与作者沟通,确保开发方向一致,避免重复劳动或无效提交。

参考资料:

  • 贡献者公约

  • 如何为开源做贡献

✉️ 联系作者

  • 作者邮箱:yonglelolu@foxmail.com

  • 作者微信: Downloader_Tools

  • 微信公众号: Downloader Tools

  • Discord 社区: 点击加入社区

  • QQ 群聊: 扫码加入群聊

说明:QQ 群聊仅限于讨论项目使用问题,严禁发布任何广告,严禁讨论任何账号交易、账号流量、流量变现、灰色产业等相关的内容!

✨ 作者的其他开源项目:

  • DouK-Downloader(抖音、TikTok):https://github.com/JoeanAmier/TikTokDownloader

  • KS-Downloader(快手、KuaiShou):https://github.com/JoeanAmier/KS-Downloader

⭐ Star 趋势

⚠️ 免责声明

  • 使用者对本项目的使用由使用者自行决定,并自行承担风险。作者对使用者使用本项目所产生的任何损失、责任、或风险概不负责。

  • 本项目的作者提供的代码和功能是基于现有知识和技术的开发成果。作者按现有技术水平努力确保代码的正确性和安全性,但不保证代码完全没有错误或缺陷。

  • 本项目依赖的所有第三方库、插件或服务各自遵循其原始开源或商业许可,使用者需自行查阅并遵守相应协议,作者不对第三方组件的稳定性、安全性及合规性承担任何责任。

  • 使用者在使用本项目时必须严格遵守 GNU
    General Public License v3.0 的要求,并在适当的地方注明使用了 GNU General Public License
    v3.0 的代码。

  • 使用者在使用本项目的代码和功能时,必须自行研究相关法律法规,并确保其使用行为合法合规。任何因违反法律法规而导致的法律责任和风险,均由使用者自行承担。

  • 使用者不得使用本工具从事任何侵犯知识产权的行为,包括但不限于未经授权下载、传播受版权保护的内容,开发者不参与、不支持、不认可任何非法内容的获取或分发。

  • 本项目不对使用者涉及的数据收集、存储、传输等处理活动的合规性承担责任。使用者应自行遵守相关法律法规,确保处理行为合法正当;因违规操作导致的法律责任由使用者自行承担。

  • 使用者在任何情况下均不得将本项目的作者、贡献者或其他相关方与使用者的使用行为联系起来,或要求其对使用者使用本项目所产生的任何损失或损害负责。

  • 本项目的作者不会提供 XHS-Downloader 项目的付费版本,也不会提供与 XHS-Downloader 项目相关的任何商业服务。

  • 基于本项目进行的任何二次开发、修改或编译的程序与原创作者无关,原创作者不承担与二次开发行为或其结果相关的任何责任,使用者应自行对因二次开发可能带来的各种情况负全部责任。

  • 本项目不授予使用者任何专利许可;若使用本项目导致专利纠纷或侵权,使用者自行承担全部风险和责任。未经作者或权利人书面授权,不得使用本项目进行任何商业宣传、推广或再授权。

  • 作者保留随时终止向任何违反本声明的使用者提供服务的权利,并可能要求其销毁已获取的代码及衍生作品。

  • 作者保留在不另行通知的情况下更新本声明的权利,使用者持续使用即视为接受修订后的条款。

在使用本项目的代码和功能之前,请您认真考虑并接受以上免责声明。如果您对上述声明有任何疑问或不同意,请不要使用本项目的代码和功能。如果您使用了本项目的代码和功能,则视为您已完全理解并接受上述免责声明,并自愿承担使用本项目的一切风险和后果。

💡 项目参考

  • https://github.com/lexiforest/curl_cffi
  • https://github.com/tiangolo/fastapi
  • https://github.com/textualize/textual/
  • https://github.com/marcelotduarte/cx_Freeze/
  • https://github.com/jlowin/fastmcp
  • https://github.com/omnilib/aiosqlite
  • https://github.com/carpedm20/emoji/
  • https://github.com/asweigart/pyperclip
  • https://github.com/lxml/lxml
  • https://github.com/pallets/click/
  • https://github.com/encode/uvicorn
  • https://github.com/Tinche/aiofiles

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
XHS-Downloader 怎么安装?

在客户端按下面的安装命令接入:docker。对应的包名是 xhs-downloader。装完在客户端配置里引用同一个包或端点。

XHS-Downloader 怎么在 Claude Desktop、Cursor、Cline 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

XHS-Downloader 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

XHS-Downloader 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

XHS-Downloader 支持哪些客户端?

资料标注支持 Claude Desktop、Cursor、Cline、Claude Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

XHS-Downloader 能提供哪些能力?

资料显示能力标签包括 xhs-downloader、api、docker、download、fastapi。具体工具清单以官方文档为准。

XHS-Downloader 需要什么运行环境?

运行时为 Cross-platform;属于本地进程,需要在本机装好运行环境。

XHS-Downloader 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-04-12。