RedNote MCP

What is RedNote-MCP?

RedNote-MCP is a Micro-Content Protocol (MCP) server specifically developed to interact with RedNote (XiaoHongShu), a prominent Chinese social media and e-commerce platform. It acts as an intermediary, allowing users and applications to programmatically access and retrieve content from RedNote.

How to use RedNote-MCP?

RedNote-MCP can be used by installing it globally via npm or by cloning the source code. Before starting, ensure you have playwright installed. Initial login is required to save cookies for persistent sessions. The server can then be configured within applications like Cursor as an MCP server.

Quick Start:

1. Install Playwright: npx playwright install
2. Global Installation (NPM):

   npm install -g rednote-mcp
   rednote-mcp init
   

3. From Source:

   git clone https://github.com/ifuryst/rednote-mcp.git
   cd rednote-mcp
   npm install
   npm install -g .
   npm run dev -- init
   

Initialization and Login:

Run rednote-mcp init (or npm run dev -- init from source). This will open a browser for manual login to XiaoHongShu. Upon successful login, cookies will be saved to ~/.mcp/rednote/cookies.json for future use.

Configuring in Cursor:

Add the following to your Cursor settings.json:

{
  "mcpServers": {
    "RedNote MCP": {
      "command": "rednote-mcp",
      "args": [
        "--stdio"
      ]
    }
  }
}

Key Features of RedNote-MCP

• Authentication Management: Supports persistent cookie-based authentication.
• Keyword Search: Ability to search for notes using keywords.
• URL-based Content Access: Retrieve note content directly via URL.
• Command-line Initialization Tool: Easy setup and login process.
• Extensible: Planned feature for accessing comment content via URL.

Use Cases of RedNote-MCP

• Data Collection: Developers and researchers can use RedNote-MCP to collect public data from XiaoHongShu for analysis.
• Content Monitoring: Monitor specific keywords or user content on XiaoHongShu.
• Integration with Applications: Integrate XiaoHongShu content access into other applications or services that require social media data.
• Automation: Automate tasks related to accessing and processing XiaoHongShu content.

FAQ about RedNote-MCP

• Q: Is login required every time?
  • A: No, after the initial init command and successful login, cookies are saved for persistent sessions.
• Q: Where are the cookies stored?
  • A: Cookies are stored in ~/.mcp/rednote/cookies.json.
• Q: What are the system requirements?
  • A: Node.js >= 16 and npm >= 7 are required.
• Q: How can I debug RedNote-MCP?
  • A: You can use MCP Inspector by running npx @modelcontextprotocol/inspector npx rednote-mcp --stdio to inspect requests and responses.
• Q: Is it safe to share the cookie file?
  • A: No, the cookie file contains sensitive information and should be kept secure.
• Q: How often should I update the cookies?
  • A: It is recommended to update cookies periodically to prevent them from expiring and becoming invalid.

RedNote MCP

小红书内容访问的MCP服务

https://github.com/user-attachments/assets/06b2c67f-d9ed-4a30-8f1d-9743f3edaa3a

快速开始

开始前确保安装了 playwright 环境：

npx playwright install

NPM 全局安装

# 全局安装
npm install -g rednote-mcp

# 初始化登录，会自动记录cookie到 ~/.mcp/rednote/cookies.json
rednote-mcp init

从源码安装

# 克隆项目
git clone https://github.com/ifuryst/rednote-mcp.git
cd rednote-mcp

# 安装依赖
npm install

# 全局安装（可选，方便命令行调用）
npm install -g .

# 或者直接运行，如初始化登录
npm run dev -- init

功能特性

• 认证管理（支持 Cookie 持久化）
• 关键词搜索笔记
• 命令行初始化工具
• 通过 URL 访问笔记内容
• 通过 URL 访问评论内容

使用说明

1. 初始化登录

首次使用需要先进行登录初始化：

rednote-mcp init
# 或者直接从源码run
npm run dev -- init
# 或者mcp-client里选择login

执行此命令后：

1. 会自动打开浏览器窗口
2. 跳转到小红书登录页面
3. 请手动完成登录操作
4. 登录成功后会自动保存 Cookie 到 ~/.mcp/rednote/cookies.json 文件

2. 在 Cursor 中配置 MCP Server

在 Cursor 的 settings.json 中添加以下配置：

{
  "mcpServers": {
    "RedNote MCP": {
      "command": "rednote-mcp",
      "args": [
        "--stdio"
      ]
    }
  }
}

或者使用 npx 方式：

{
  "mcpServers": {
    "RedNote MCP": {
      "command": "npx",
      "args": [
        "rednote-mcp",
        "--stdio"
      ]
    }
  }
}

配置说明：

• command: 可以是全局安装后的 rednote-mcp 命令，或使用 npx 直接运行
• args: 必须包含 --stdio 参数以支持 Cursor 的通信方式

开发指南

环境要求

• Node.js >= 16
• npm >= 7

开发流程

# 安装依赖
npm install

# 构建项目
npm run build

# 开发模式运行
npm run dev

# 运行测试
npm test

使用 MCP Inspector 进行调试

MCP Inspector 是一个用于调试 MCP 服务器的工具，可以帮助开发者检查和验证 MCP 服务器的行为。使用以下命令启动：

npx @modelcontextprotocol/inspector npx rednote-mcp --stdio

这个命令会：

1. 启动 MCP Inspector 工具
2. 通过 Inspector 运行 rednote-mcp 服务
3. 提供一个交互式界面来检查请求和响应
4. 帮助调试和验证 MCP 协议的实现

注意事项

1. 首次使用必须执行 init 命令进行登录
2. Cookie 文件包含敏感信息，避免泄露
3. 建议定期更新 Cookie，避免失效
4. 确保已正确安装 Node.js 环境

贡献指南

1. Fork 本仓库
2. 创建你的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交你的改动 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启一个 Pull Request

许可证

MIT License - 详见 LICENSE 文件