Rednote MCP

🚀 紅書筆記MCP - 小紅書內容搜索工具

紅書筆記MCP是一個用於從小紅書平臺搜索和檢索內容的模型上下文協議（MCP）服務器。它具備智能內容提取功能，支持自動登錄管理和並行處理能力，能高效地為用戶提供小紅書上的各類信息。

✨ 主要特性

• 智能搜索：基於關鍵詞在小紅書上進行內容搜索。
• 自動登錄：自動管理Cookie並處理登錄流程。
• 並行處理：高效地併發檢索內容。
• 豐富的數據提取：
  • 筆記標題和內容。
  • 作者信息和簡介。
  • 互動指標（點贊、收藏、評論）。
  • 圖片和話題標籤。
  • 筆記直接鏈接。

🔧 技術細節

技術棧

• 運行環境：使用TypeScript的Node.js。
• 瀏覽器自動化：Playwright。
• 協議：模型上下文協議（MCP）SDK。
• 驗證：Zod模式驗證。
• 包管理器：pnpm。

數據結構

interface RedBookNote {
  title: string;        // 筆記標題
  content: string;      // 筆記內容
  author: string;       // 作者姓名
  authorDesc?: string;  // 作者簡介
  link: string;         // 筆記URL
  likes?: number;       // 點贊數
  collects?: number;    // 收藏數
  comments?: number;    // 評論數
  tags?: string[];      // 話題標籤列表
  images?: string[];    // 圖片URL（WebP格式）
}

📦 安裝指南

前提條件

• Node.js 18+
• pnpm包管理器

安裝步驟

1. 克隆倉庫：

git clone <repository-url>
cd rednote-mcp

2. 安裝依賴：

pnpm install

3. 安裝Playwright瀏覽器：

pnpm exec playwright install

4. 構建項目：

pnpm build

💻 使用示例

運行MCP服務器

pnpm start

開發模式

pnpm dev

測試

pnpm test

MCP客戶端配置

Claude桌面端

將以下配置添加到Claude桌面端配置文件中：

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

對於macOS/Linux用戶：

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

請將路徑替換為你實際的項目目錄。

其他MCP客戶端

對於其他支持MCP的客戶端，使用構建後的服務器文件：

node build/index.js

工具使用

配置完成後，你可以在MCP客戶端中使用搜索工具：

Search for "food recommendation" on Xiaohongshu

該工具將返回結構化數據，包括標題、內容、作者信息和圖片。

📚 詳細文檔

項目結構

rednote-mcp/
├── src/
│   ├── index.ts          # MCP服務器入口文件
│   └── xiaohongshu.ts    # 核心抓取邏輯
├── cookies/              # 自動生成的Cookie存儲目錄
├── results/              # 可選：保存的搜索結果
├── build/                # 編譯後的JavaScript輸出目錄
├── package.json
├── tsconfig.json
└── README.md

可用腳本

• pnpm build - 將TypeScript編譯為JavaScript。
• pnpm start - 運行構建後的MCP服務器。
• pnpm dev - 開發模式，支持自動重新加載。
• pnpm test - 運行測試（如果有）。
• pnpm clean - 清理構建目錄。

故障排除

常見問題

1. 需要登錄：如果你看到登錄提示，請刪除cookies/目錄並重新啟動。
2. 超時錯誤：增加MCP客戶端的超時設置。
3. 未找到瀏覽器：運行pnpm exec playwright install來安裝瀏覽器。
4. 權限錯誤：確保項目目錄具有正確的讀寫權限。

📄 許可證

本項目採用MIT許可證 - 詳情請參閱LICENSE文件。

⚠️ 重要提示

本工具僅用於教育和研究目的。使用本工具時，請遵守小紅書的服務條款和速率限制。