Rednote MCP

🚀 RedNote MCP

MCP service for accessing Xiaohongshu content

https://github.com/user-attachments/assets/06b2c67f-d9ed-4a30-8f1d-9743f3edaa3a

🚀 Quick Start

Before using, make sure you have installed the playwright environment:

npx playwright install

📦 Global Installation via NPM

# Global installation
npm install -g rednote-mcp

# Initialize the login, and the cookie will be automatically saved to the ~/.mcp/rednote/cookies.json file
rednote-mcp init

📦 Installation from Source Code

# Clone the project
git clone https://github.com/ifuryst/rednote-mcp.git
cd rednote-mcp

# Install dependencies
npm install

# Global installation (optional, for convenient command-line calls)
npm install -g .

# Or directly run the initialization login
npm run dev -- init

✨ Features

• Authentication Management (Supports Cookie persistence)
• Search for notes by keywords
• Command-line initialization tool
• Access note content via URL
• [To be completed] Access comment content via URL

💻 Usage Examples

1. Initial Login

You need to initialize the login for the first use:

rednote-mcp init
# Or run directly from the source code
npm run dev -- init
# Or select login in mcp-client

After executing this command:

1. The browser window will open automatically.
2. It will jump to the Xiaohongshu login page.
3. Please complete the login operation manually.
4. After successful login, the Cookie will be automatically saved to the ~/.mcp/rednote/cookies.json file.

2. Configure the MCP Server in Cursor

Add the following configuration to the settings.json file in Cursor:

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

Or use the npx method:

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

📚 Documentation

Environment Requirements

• Node.js and npm are installed.
• Install playwright: npx playwright install

Development Process

# Clone the project and enter the directory
git clone https://github.com/ifuryst/rednote-mcp.git
cd rednote-mcp

# Install dependencies
npm install

# Run the development version
npm run dev

Debugging Tools

Use the debugging tools provided by playwright for debugging:

npx playwright

📄 License

[Specific license content, such as MIT or Apache, should be placed here]

⚠️ Important Note

• For first-time use: Please run the initialization command rednote-mcp init first.
• Cookie security: Please keep the ~/.mcp/rednote/cookies.json file properly to prevent leakage.

💡 Usage Tip

• Code repository address: https://github.com/ifuryst/rednote-mcp
• Welcome to Fork and submit Pull Requests.
• If you have any questions, please submit them in the Issues.