AI导哈

小红书内容搜索工具

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

  • by MilesCool
  • TypeScript
  • 本地部署
  • 30 星标
  • 更新于
在 GitHub 查看 MilesCool/rednote-mcp

使用说明

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

概述

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

特性

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

技术栈

  • 运行时：使用TypeScript的Node.js
  • 浏览器自动化：剧作家
  • 协议：模型上下文协议（MCP）SDK
  • 验证：Zod模式验证
  • 程序包管理器：pnpm

数据结构

interface RedBookNote {
  title: string;        // Note title
  content: string;      // Note content
  author: string;       // Author name
  authorDesc?: string;  // Author description
  link: string;         // Note URL
  likes?: number;       // Like count
  collects?: number;    // Favorite count
  comments?: number;    // Comment count
  tags?: string[];      // Hashtag list
  images?: string[];    // Image URLs (WebP format)
}

安装

先决条件

  • Node.js 18+
  • pnpm包管理器

设置

  1. 克隆存储库：
git clone <repository-url>
cd rednote-mcp
  1. 安装依赖项：
pnpm install
  1. 安装Playwright浏览器：
pnpm exec playwright install
  1. 构建项目：
pnpm build

用法

运行MCP服务器

pnpm start

发展模式

pnpm dev

测试

pnpm test

MCP客户端配置

克劳德桌面

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

视窗: %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

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

重要提示

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

发展

项目结构

rednote-mcp/
├── src/
│   ├── index.ts          # MCP server entry point
│   └── xiaohongshu.ts    # Core scraping logic
├── cookies/              # Auto-generated cookie storage
├── results/              # Optional: saved search results
├── build/                # Compiled JavaScript output
├── 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许可证获得许可-请参阅 许可证 文件以获取详细信息。

免责声明

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

相关 MCP