RedNote MCP
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.
What is RedNote MCP?
RedNote MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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.
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.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables users to search and retrieve content from Xiaohongsh
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx rednote-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use RedNote MCP
RedNote MCP connects Claude and other MCP-compatible AI clients to Xiaohongshu (小红书 / Red Book), the Chinese social media and lifestyle platform. It enables keyword-based content search that returns note titles, content, URLs, author information, engagement metrics (likes, favorites, comments), hashtags, and images. Developers and researchers use it to gather trend data, product reviews, and user-generated content from one of China's most influential consumer platforms without manually browsing the site.
Prerequisites
- Node.js 18 or later installed
- pnpm package manager installed (`npm install -g pnpm`)
- Playwright Chromium browser (installed via `pnpm exec playwright install`)
- A Xiaohongshu (RedNote) account for the initial login flow
- An MCP-compatible client such as Claude Desktop
Clone the repository
Clone the rednote-mcp repository from GitHub and enter the project directory.
git clone https://github.com/MilesCool/rednote-mcp.git
cd rednote-mcpInstall dependencies and Playwright browser
Install Node.js dependencies using pnpm, then install the Chromium browser that Playwright uses to automate the Xiaohongshu web interface.
pnpm install
pnpm exec playwright install chromiumBuild the server
Compile the TypeScript source to JavaScript. The output lands in the `build/` directory.
pnpm buildConfigure Claude Desktop
Add the server to your Claude Desktop MCP configuration file. Replace `/absolute/path/to/rednote-mcp` with the real path on your machine. On macOS the config lives at `~/Library/Application Support/Claude/claude_desktop_config.json`.
Complete the first-run login
The first time a search is triggered, a browser window opens for you to log in to Xiaohongshu manually. After login the session cookie is saved automatically so subsequent searches run headlessly.
Restart Claude Desktop and test
Restart Claude Desktop so it picks up the new server, then ask Claude to search Xiaohongshu. Initial searches may take 30–60 seconds while the browser starts.
RedNote MCP Examples
Client configuration
Add this block to `claude_desktop_config.json`. Update the path to point to your local build output.
{
"mcpServers": {
"rednote-mcp": {
"command": "node",
"args": ["/absolute/path/to/rednote-mcp/build/index.js"]
}
}
}Prompts to try
Sample prompts to use once the server is connected in Claude Desktop.
- "Search for 'matcha latte recipe' on Xiaohongshu and summarize the top results."
- "Find posts about '护肤步骤' (skincare routine) on RedNote and list the most recommended products."
- "Search Xiaohongshu for 'Tokyo travel tips' and compile the engagement metrics for each note."
- "Look up recent posts about 'vintage clothing' on RedNote including hashtags and author info."Troubleshooting RedNote MCP
Login browser window does not open or closes immediately
Ensure Playwright's Chromium is installed by running `pnpm exec playwright install chromium` again. If running on a headless server, Playwright requires a display; use a local machine for the first login, then copy the saved cookie state.
Search returns no results or times out
Xiaohongshu may rate-limit automated requests. The server limits to 3 concurrent queries by design. Wait a few minutes and retry. If the session expired, delete the saved cookies file and log in again.
Claude Desktop does not show the rednote-mcp server
Verify the absolute path in `args` points to the compiled `build/index.js` file. Run `node /path/to/rednote-mcp/build/index.js` in a terminal to check for startup errors, then restart Claude Desktop.
Frequently Asked Questions about RedNote MCP
What is RedNote MCP?
RedNote MCP is a Model Context Protocol (MCP) server that 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. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install RedNote MCP?
Follow the installation instructions on the RedNote MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with RedNote MCP?
RedNote MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is RedNote MCP free to use?
Yes, RedNote MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
RedNote MCP Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to RedNote MCP? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up RedNote MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use RedNote MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.