1. Conduid
  2. Data
  3. Xhs Downloader
MCP server · Data

Xhs Downloader

小红书(XiaoHongShu / RedNote)作品信息解析与媒体下载工具,提供 CLI、HTTP API、MCP 和 Python 客户端。

Unclaimed GPL-3.0 data
94Excellent

Scored 6 days ago · breakdown

About Xhs Downloader

Xhs Downloader is an MCP server published by JoeanAmier in the Data category: 小红书(XiaoHongShu / RedNote)作品信息解析与媒体下载工具,提供 CLI、HTTP API、MCP 和 Python 客户端。.

The repository has 13K stars and 2.0K forks, with the last commit 3 days ago. Recent commit activity is the strongest signal that reported issues will get attention.

Install

From source
git clone https://github.com/JoeanAmier/XHS-Downloader

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Xhs Downloader

Powered by Claude · Grounded in docs

I know everything about Xhs Downloader. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

3 checks have not been run yet.

Releases

2.8XHS-Downloader V2.8 · 12 Sep 2026项目更新内容:** 1. 修复 ParserError 导致应用崩溃的问题 2. 参数 `headers` 重构为 `impersonate` 3. 使用 `curl_cffi` 替代 `httpx` 4. 修复模式切换后状态显示异常的问题 5. 修复 CLI 模式 KeyError 异常 6. 修复控制字符导致程序报错的问题 7. 修复部分分享链接提取失败的问题 8. 图文/图集作品支持下载指定文件 9. 修复动态图片无法下载的问题 10. 下载文件默认不使用网络代理…
2.7XHS-Downloader V2.7 · 9 Feb 2026项目更新内容:** 1. 修复 MCP 模式无法下载文件的问题 2. 新增 `script_server` 配置参数 3. 移除 `从浏览器读取 Cookie` 功能 4. 新增连接用户脚本下载作品功能 5. 优化 Cookie 处理逻辑 6. 修复视频作品下载功能 7. 新增视频下载偏好设置 8. 新增作品处理统计功能 9. 重构数据处理逻辑 10. 调整内置延时机制 用户脚本更新内容:** 版本号:2.3.1** 1. 新增链接提取/图片下载选择模式开关 2.…
2.6XHS-Downloader V2.6 · 11 Aug 2025项目更新内容:** 1. 修复作品类型判断失败时异常退出的问题 2. 修改服务器模式请求路径为 `/xhs/detail` 3. 修改服务器模式默认端口为 `5556` 4. 命令行模式支持传递多个作品链接 5. 新增 `folder_name` 参数检查 6. 服务器模式新增 MCP 模式 7. 配置与文件归集到单文件夹 8. 优化配置文件参数容错机制 9. 优化提取链接的正则表达式 10. 修改服务器模式启动命令 11. 支持更多作品链接格式 12.…
2.5XHS-Downloader V2.5 · 20 Apr 2025项目更新内容:** 1. 增加对 `JPEG` 和 `HEIC` 图片格式的支持 2. 新增启动 `监听剪贴板` 模式时清空剪贴板内容 3. 修复 `监听剪贴板` 模式可能丢失链接的问题 4. 支持以发布时间作为文件修改时间 5. 支持按作者归档保存作品文件 6. 支持 API 模式设置临时代理 7. 新增自动更新作者昵称功能 8. 优化 `headers` 处理逻辑 9. 优化语言代码获取逻辑 10. 支持 `SOCKS` 代理 11. 支持设置作者别名 注意:**…
2.4XHS-Downloader V2.4 · 5 Jan 2025项目更新内容:** 1. 修复命令行模式语言不生效的问题 2. 修复删除下载记录无效的问题 3. 优化文件名称非法字符处理 4. 支持 API 模式传入 Cookie 5. 优化删除下载记录功能 6. 适配新版本 HTTPX 库 7. 适配新版本 Textual 库 8. 更新程序交互界面 9. 重构项目翻译模块 10. 更正英语语言代码 11. 优化文件下载功能 12. 降低内置延时机制 13. 其他细节优化 用户脚本更新内容:** 版本号:1.8.6** 1.…

README

本指南将引导您通过 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

Powered by DartNode


ZMTO


IPWO

💡 项目参考

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Xhs Downloader

How do I install Xhs Downloader?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Xhs Downloader safe to use with an AI agent?

Its trust score is 94 out of 100 (excellent). It passes 2 of the 3 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Xhs Downloader still maintained?

Yes — the latest release is 2.8 (12 Sep 2026), and the last commit was 3 days ago. The repository has 13K stars and 25 open issues.