小红书图片提取服务

XHS提取图像MCP服务器

英语| 简体中文

用于从小红书帖子中提取原始质量图像的模型上下文协议（MCP）服务器。

特性

• 多种输入格式：接受共享按钮文本、短链接（xhslink.com）或完整URL
• 原始品质：将压缩的CDN URL转换为原始的高分辨率图像
• 结构化笔记元数据：以JSON格式提取标题、描述、作者、时间戳、标签、计数、封面和图像资产
• 视频元数据：当笔记是视频时，提取视频URL、备份URL、编解码器、质量、尺寸、大小和封面
• 配置文件元数据：从用户配置文件页面中提取配置文件基本信息、计数、公共选项卡和主页明信片
• 共享文本解析：自动从复制的共享文本中提取短链接

安装

npm install
npm run build

MCP服务器配置

将此服务器添加到您的客户端配置中：

配置JSON

{
  "mcpServers": {
    "xhs-fetch-image": {
      "command": "node",
      "args": ["YOUR_PATH_TO_DIRECTORY\\xhs-fetch-image-mcp\\dist\\index.js"]
    }
  }
}

备注：替换中的路径 args 与你的绝对路径 dist/index.js 文件。

可用工具

fetchxhs_image

从小红书帖子中提取原始质量的图像。

输入架构：

{
  content: string; // Xiaohongshu share text, short link (xhslink.com), or full post URL
}

输出：

• 对于图像帖子：标题和原始质量图像URL列表
• 对于视频帖子：“这篇帖子是视频，没有可用的图像。”
• 对于错误：包含详细信息的错误消息

fetchxhs_note

Extract structured metadata from a Xiaohongshu (小红书) note.

输入架构：

{
  content: string; // Xiaohongshu share text, short link (xhslink.com), or full note URL
}

输出：

JSON文本，包含注释id、规范URL、标题、描述、作者、发布/更新时间戳、标签，如/收集/评论计数、封面URL、图像URL和视频元数据（如果可用）。

fetchxhs_profile

从小红书用户页面中提取结构化的个人资料信息。

输入架构：

{
  content: string; // Xiaohongshu user profile URL, such as https://www.xiaohongshu.com/user/profile/<uid>
}

输出：

JSON文本，包含用户id、昵称、Rednote id、描述、IP位置、性别、验证类型、关注者/追随者/交互计数、公共标签状态和加载的主页明信片。

发展

# Watch mode
npm run dev

# Build
npm run build

# Run
npm start

需求

• Node.js 18+（用于本机获取支持）
• TypeScript 5.3+

依赖项

• @modelcontextprotocol/sdk -MCP服务器框架
• zod -输入验证

错误处理

许可证

麻省理工学院