JinDaGe - rednote-mcp MCP Details

article

README

🚀 红书笔记MCP - 小红书内容搜索工具

红书笔记MCP是一个用于从小红书平台搜索和检索内容的模型上下文协议（MCP）服务器。它具备智能内容提取功能，支持自动登录管理和并行处理能力，能高效地为用户提供小红书上的各类信息。

✨ 主要特性

智能搜索：基于关键词在小红书上进行内容搜索。
自动登录：自动管理Cookie并处理登录流程。
并行处理：高效地并发检索内容。
丰富的数据提取：
- 笔记标题和内容。
- 作者信息和简介。
- 互动指标（点赞、收藏、评论）。
- 图片和话题标签。
- 笔记直接链接。

🔧 技术细节

技术栈

运行环境：使用TypeScript的Node.js。
浏览器自动化：Playwright。
协议：模型上下文协议（MCP）SDK。
验证：Zod模式验证。
包管理器：pnpm。

数据结构

interface RedBookNote {
  title: string;        // 笔记标题
  content: string;      // 笔记内容
  author: string;       // 作者姓名
  authorDesc?: string;  // 作者简介
  link: string;         // 笔记URL
  likes?: number;       // 点赞数
  collects?: number;    // 收藏数
  comments?: number;    // 评论数
  tags?: string[];      // 话题标签列表
  images?: string[];    // 图片URL（WebP格式）
}

📦 安装指南

前提条件

Node.js 18+
pnpm包管理器

安装步骤

克隆仓库：

git clone <repository-url>
cd rednote-mcp

安装依赖：

pnpm install

安装Playwright浏览器：

pnpm exec playwright install

构建项目：

pnpm build

💻 使用示例

运行MCP服务器

pnpm start

开发模式

pnpm dev

测试

pnpm test

MCP客户端配置

Claude桌面端

将以下配置添加到Claude桌面端配置文件中：

Windows：%APPDATA%\Claude\claude_desktop_config.json
macOS：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "rednote-mcp": {
      "command": "node",
      "args": [
        "C:\\ABSOLUTE\\PATH\\TO\\rednote-mcp\\build\\index.js"
      ]
    }
  }
}

对于macOS/Linux用户：

{
  "mcpServers": {
    "rednote-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/rednote-mcp/build/index.js"
      ]
    }
  }
}

请将路径替换为你实际的项目目录。

其他MCP客户端

对于其他支持MCP的客户端，使用构建后的服务器文件：

node build/index.js

工具使用

配置完成后，你可以在MCP客户端中使用搜索工具：

Search for "food recommendation" on Xiaohongshu

该工具将返回结构化数据，包括标题、内容、作者信息和图片。

📚 详细文档

项目结构

rednote-mcp/
├── src/
│   ├── index.ts          # MCP服务器入口文件
│   └── xiaohongshu.ts    # 核心抓取逻辑
├── cookies/              # 自动生成的Cookie存储目录
├── results/              # 可选：保存的搜索结果
├── build/                # 编译后的JavaScript输出目录
├── package.json
├── tsconfig.json
└── README.md

可用脚本

pnpm build - 将TypeScript编译为JavaScript。
pnpm start - 运行构建后的MCP服务器。
pnpm dev - 开发模式，支持自动重新加载。
pnpm test - 运行测试（如果有）。
pnpm clean - 清理构建目录。

故障排除

常见问题

需要登录：如果你看到登录提示，请删除cookies/目录并重新启动。
超时错误：增加MCP客户端的超时设置。
未找到浏览器：运行pnpm exec playwright install来安装浏览器。
权限错误：确保项目目录具有正确的读写权限。

📄 许可证

本项目采用MIT许可证 - 详情请参阅LICENSE文件。

⚠️ 重要提示

本工具仅用于教育和研究目的。使用本工具时，请遵守小红书的服务条款和速率限制。

rednote-mcp