Skip to main content
Glama

RedNote MCP

by MilesCool
npmGitHub
TypeScript
MIT License
137
1
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

  1. Clone the repository:
git clone <repository-url> cd rednote-mcp
  1. Install dependencies:
pnpm install
  1. Install Playwright browsers:
pnpm exec playwright install
  1. 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

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

Debug Mode

Set environment variable for verbose logging:

DEBUG=1 pnpm start

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.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Tools

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.

  1. Overview
    1. Features
      1. Technical Stack
        1. Data Structure
          1. Installation
            1. Prerequisites
            2. Setup
          2. Usage
            1. Running the MCP Server
            2. Development Mode
            3. Testing
          3. MCP Client Configuration
            1. Claude Desktop
            2. Other MCP Clients
          4. Tool Usage
            1. Important Notes
              1. Development
                1. Project Structure
                2. Available Scripts
              2. Troubleshooting
                1. Common Issues
                2. Debug Mode
              3. License
                1. Disclaimer

                  Related MCP Servers

                  • NeoDB MCP Serverofficial

                    xytangme
                    -
                    security
                    A
                    license
                    -
                    quality
                    Enables interaction with NeoDB, a social book cataloging service, by providing tools to fetch user info, search books, and retrieve detailed book information through its API.
                    Last updated -
                    2
                    Python
                    MIT License
                    • Apple

                  • Academic Paper Search MCP Server

                    afrise
                    A
                    security
                    A
                    license
                    A
                    quality
                    Enables real-time search and retrieval of academic paper information from multiple sources, providing access to paper metadata, abstracts, and full-text content when available, with structured data responses for integration with AI models that support tool/function calling.
                    Last updated -
                    3
                    11
                    Python
                    AGPL 3.0

                  • Knowledge Base MCP Server

                    jeanibarz
                    A
                    security
                    A
                    license
                    A
                    quality
                    Provides tools for listing and retrieving content from different knowledge bases using semantic search capabilities.
                    Last updated -
                    2
                    10
                    TypeScript
                    The Unlicense
                    • Linux
                    • Apple

                  • RedNote MCP

                    JonaFly
                    -
                    security
                    -
                    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 -
                    1
                    TypeScript
                    MIT License

                  View all related MCP servers

                  New MCP Servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/MilesCool/rednote-mcp'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server