Rednote MCP

🚀 RedNote MCP

RedNote MCP 是一個用於小紅書內容訪問的 MCP 服務，能夠幫助用戶便捷地訪問小紅書的筆記和相關內容，提供認證管理、搜索等功能。

🚀 快速開始

使用前請確保已安裝 playwright 環境：

npx playwright install

📦 NPM 全局安裝

# 全局安裝
npm install -g rednote-mcp

# 初始化登錄，會自動保存cookie到 ~/.mcp/rednote/cookies.json 文件中
rednote-mcp init

📦 從源碼安裝

# 克隆項目
git clone https://github.com/ifuryst/rednote-mcp.git
cd rednote-mcp

# 安裝依賴
npm install

# 全局安裝（可選，方便命令行調用）
npm install -g .

# 或者直接運行初始化登錄
npm run dev -- init

✨ 主要特性

• 認證管理（支持 Cookie 持久化）
• 關鍵詞搜索筆記
• 命令行初始化工具
• 通過 URL 訪問筆記內容
• [待完成] 通過 URL 訪問評論內容

💻 使用示例

基礎用法

1. 初始化登錄

首次使用需先進行登錄初始化：

rednote-mcp init
# 或者直接從源碼運行
npm run dev -- init
# 或者在 mcp-client 中選擇 login

執行此命令後：

1. 自動打開瀏覽器窗口
2. 跳轉至小紅書登錄頁面
3. 請手動完成登錄操作
4. 成功登錄後會自動保存 Cookie 到 ~/.mcp/rednote/cookies.json 文件

2. 在 Cursor 中配置 MCP 服務器

在 Cursor 的 settings.json 文件中添加以下配置：

{
  "mcpServers": {
    "RedNote MCP": {
      "command": "rednote-mcp",
      "args": [
        "--stdio"
      ]
    }
  }
}

或者使用 npx 方式：

{
  "mcpServers": {
    "RedNote MCP": {
      "command": "npx",
      "args": [
        "rednote-mcp"
      ]
    }
  }
}

📚 詳細文檔

開發指南

環境要求

• Node.js 和 npm 已安裝
• 安裝 playwright：npx playwright install

開發流程

# 克隆項目並進入目錄
git clone https://github.com/ifuryst/rednote-mcp.git
cd rednote-mcp

# 安裝依賴
npm install

# 運行開發版本
npm run dev

調試工具

使用 playwright 提供的調試工具進行調試：

npx playwright

注意事項

⚠️ 重要提示

• 首次使用：請先運行初始化命令 rednote-mcp init
• Cookie 安全：請妥善保管 ~/.mcp/rednote/cookies.json 文件，防止洩露

貢獻指南

• 代碼倉庫地址：https://github.com/ifuryst/rednote-mcp
• 歡迎 Fork 和 Pull Request
• 如有任何問題，請在 Issues 中提交

📄 許可證

[此處應放置具體的許可證內容，如 MIT 或 Apache 等]