XHS-Downloader

XHS-Downloader 简体中文 | English

🔥 小红书（XiaoHongShu、RedNote）链接提取/作品采集工具！

项目程序与用户脚本功能清单，快速了解项目能力（点击展开）

📸 程序截图 前往 bilibili 观看演示；前往 YouTube 观看演示 GUI 界面截图

🔗 支持链接

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

命令行模式说明，适合习惯命令行操作或需要脚本化调用的用户（点击展开） 项目支持命令行运行模式，可通过命令行参数直接下载作品文件，也可以设置需要下载的图片序号！ 注意：未设置 --index 参数时，支持传入多个作品链接，全部链接需要使用引号包围，链接之间使用空格分隔；已设置 --index 参数时，不支持传入多个作品链接，即使传入多个作品链接，程序仅处理首个作品链接！ bool 类型参数支持使用 true、false、1、0、yes、no、on 或 off（不区分大小写）来设置。 从浏览器读取 Cookie 该功能已失效，请参考 获取 Cookie 教程！ 可以使用命令行实现 从浏览器读取 Cookie 并写入配置文件！ 命令示例：python .\main.py --browser_cookie Chrome --update_settings 兼容性提醒：此功能依赖的第三方模块已长期未更新，可能无法正常支持最新浏览器版本。若功能出现异常，请尝试手动获取 Cookie！

🖥 服务器模式 服务器模式包含 API 模式和 MCP 模式！ API 模式

API 模式说明，适合需要调用接口获取作品数据或下载文件的开发者（点击展开） 启动：运行命令：python .\main.py api 关闭：按下 Ctrl + C 关闭服务器 访问 http://127.0.0.1:5556/docs 或者 http://127.0.0.1:5556/redoc；你会看到自动生成的交互式 API 文档！ 请求接口：/xhs/detail 请求方法：POST 请求格式：JSON 请求参数：

参数 类型 含义 默认值

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

download 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", } response = post(server, json=data, timeout=10) print(response.json())

MCP 模式

MCP 模式说明，适合需要启动 MCP 服务接入 AI 助手等工具的开发者（点击展开） 启动：运行命令：python .\main.py mcp 关闭：按下 Ctrl + C 关闭服务器 MCP 配置示例

Streamable HTTP MCP URL：http://127.0.0.1:5556/mcp/

MCP 调用示例 获取小红书作品信息