🚀 红书笔记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
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文件。
⚠️ 重要提示
本工具仅用于教育和研究目的。使用本工具时，请遵守小红书的服务条款和速率限制。