RedNote MCP - 小红书内容搜索工具

概述

RedNote MCP 是一个用于从小红书（红书）平台搜索和检索内容的模型上下文协议（MCP）服务器。它提供了智能内容提取功能，包括自动登录管理和并行处理能力。

特性

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

技术栈

• 运行时：Node.js 和 TypeScript
• 浏览器自动化：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 包管理器

设置

1. 克隆仓库：

git clone <repository-url>
cd rednote-mcp

2. 安装依赖：

pnpm install

3. 安装 Playwright 浏览器：

pnpm exec playwright install

4. 构建项目：

pnpm build

使用

运行 MCP 服务器

pnpm start

开发模式

pnpm dev

测试

pnpm test

MCP 客户端配置

Claude Desktop

在您的 Claude Desktop 配置文件中添加以下配置：

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 客户端中使用搜索工具：

在小红书上搜索“美食推荐”

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

重要说明

• 首次运行：首次使用时需要手动登录小红书
• 性能：初始搜索可能需要 30-60 秒，因为浏览器启动和内容加载
• 速率限制：并发请求限制为 3，以避免平台限制
• 图片格式：图片提供为 WebP 格式
• Cookie 管理：登录状态会自动保存和复用

开发

项目结构

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 - 清理构建目录

故障排除

常见问题

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

许可证

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

免责声明

此工具仅供教育和研究用途。请在使用此工具时遵守小红书的服务条款和速率限制。