RedNote MCP - Xiaohongshu Content Search Tool

Overview

RedNote MCP is a Model Context Protocol (MCP) server for searching and retrieving content from Xiaohongshu (Red Book) platform. It provides intelligent content extraction with automatic login management and parallel processing capabilities.

Features

Smart Search: Keyword-based content search on Xiaohongshu
Auto Login: Automatic cookie management and login handling
Parallel Processing: Efficient concurrent content retrieval
Rich Data Extraction:
- Note titles and content
- Author information and descriptions
- Interaction metrics (likes, favorites, comments)
- Images and hashtags
- Direct note links

Technical Stack

Runtime: Node.js with TypeScript
Browser Automation: Playwright
Protocol: Model Context Protocol (MCP) SDK
Validation: Zod schema validation
Package Manager: pnpm

Data Structure

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) }

Installation

Prerequisites

Node.js 18+
pnpm package manager

Setup

Clone the repository:

git clone <repository-url> cd rednote-mcp

Install dependencies:

pnpm install

Install Playwright browsers:

pnpm exec playwright install

Build the project:

pnpm build

Usage

Running the MCP Server

pnpm start

Development Mode

pnpm dev

Testing

pnpm test

MCP Client Configuration

Claude Desktop

Add the following configuration to your Claude Desktop config file:

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" ] } } }

For macOS/Linux users:

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

Replace the path with your actual project directory.

Other MCP Clients

For other MCP-compatible clients, use the built server file:

node build/index.js

Tool Usage

Once configured, you can use the search tool in your MCP client:

Search for "food recommendation" on Xiaohongshu

The tool will return structured data including titles, content, author information, and images.

Important Notes

First Run: Manual login to Xiaohongshu is required on first use
Performance: Initial searches may take 30-60 seconds due to browser startup and content loading
Rate Limiting: Concurrent requests are limited to 3 to avoid platform restrictions
Image Format: Images are provided in WebP format
Cookie Management: Login state is automatically saved and reused

Development

Project Structure

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

Available Scripts

pnpm build - Build TypeScript to JavaScript
pnpm start - Run the built MCP server
pnpm dev - Development mode with auto-reload
pnpm test - Run tests (if available)
pnpm clean - Clean build directory

Troubleshooting

Common Issues

Login Required: If you see login prompts, delete the cookies/ directory and restart
Timeout Errors: Increase the MCP client timeout settings
Browser Not Found: Run pnpm exec playwright install to install browsers
Permission Errors: Ensure the project directory has proper read/write permissions

License

This project is licensed under the MIT License - see the LICENSE file for details.

Disclaimer

This tool is for educational and research purposes. Please respect Xiaohongshu's terms of service and rate limits when using this tool.

Deploy Server

HTTP connection URL

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

search_xiaohongshu

Enables users to search and retrieve content from Xiaohongshu (Red Book) platform with smart search capabilities and rich data extraction including note content, author information, and images.

Related Resources

Reddit Discussion about this server

Related MCP Servers

RedNote MCP
JonaFly
-
security
A
license
-
quality
A server that enables access to Xiaohongshu (Little Red Book) content, allowing users to search for notes and retrieve content via URLs with authentication management and cookie persistence.
Last updated -
48
5
MIT License
Xiaohongshu Search & Comment MCP Server
chenningling
-
security
F
license
-
quality
A Playwright-based tool that automates Xiaohongshu (Little Red Book) interactions, enabling users to login, search for notes, view content, and post intelligent comments through natural language commands.
Last updated -
28
Xiaohongshu API MCP Server
proerror77
-
security
F
license
-
quality
A microservice that wraps Xiaohongshu (Little Red Book) API into a RESTful API server, enabling users to perform various operations on the platform such as retrieving notes, searching users and content, and accessing user information.
Last updated -
14
Xiaohongshu (Little Red Book) MCP Server
fancyboi999
-
security
F
license
-
quality
A server that allows interfacing with the Chinese social media platform Xiaohongshu through HTTP requests, enabling searching notes, retrieving note content and comments, and posting comments.
Last updated -
1

View all related MCP servers

RedNote MCP