개요

RedNote MCP는 Xiaohongshu (Red Book) 플랫폼에서 콘텐츠를 검색하고 검색하고 검색하기위한 모델 Context Protocol (MCP) 서버입니다. 자동 로그인 관리 및 병렬 처리 기능을 갖춘 지능형 콘텐츠 추출을 제공합니다.

특징

• Smart Search: Xiaohongshu의 키워드 기반 콘텐츠 검색
• Auto Login: 자동 쿠키 관리 및 로그인 처리 -Parallel Processing: 효율적인 동시 콘텐츠 검색
• **Rich 데이터 추출 **:
• 제목 및 내용
• 저자 정보 및 설명
• 상호 작용 메트릭 (likes, favorites, 코멘트)
• 이미지 및 해시 태그
• 직접 참고 링크

기술 스택

• Runtime: TypeScript를 가진 Node.js
• **Browser 자동화 **: Playwright
• Protocol: 모델 컨텍스트 프로토콜(MCP) SDK -Validation: Zod 스키마 검증
• 패키지 관리자: pnpm

데이터 구조

설치

# 필수품

• 노드.js 18+
• pnpm 패키지 관리자

설정

1. 저장소를 복제:

2. 의존성 설치:

3. Playwright 브라우저 설치:

4. 프로젝트 구축:

사용법

MCP 서버 실행

개발 모드

테스트

MCP 클라이언트 구성

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 
cd rednote-mcp

2. Install dependencies:

pnpm install

3. Install Playwright browsers:

pnpm exec playwright install

4. 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