RedNote

You can run a dedicated MCP server that enables keyword-based content search on Xiaohongshu, with automatic login handling and parallel data retrieval. This server exposes structured results including note titles, content, author details, and engagement metrics, so you can build powerful search and data extraction workflows in your MCP client.

How to use

Once you have the MCP server running, configure your MCP client to connect to either of the provided local stdio endpoints. You can perform a search by issuing a query like a normal search task in your client, and you will receive structured results that include titles, content, author information, images, and direct note links. The server handles login cookies automatically after the first manual login and reuses them for subsequent requests.

Available capabilities include smart search, automatic login management, parallel retrieval, and rich data extraction. You can expect results to include: note title, note content, author, author description, link, likes, collects, comments, tags, and image URLs.

How to install

Prerequisites include Node.js 18+ and the pnpm package manager.

Install dependencies and set up the project by following these steps.

pnpm install

pnpm exec playwright install

pnpm build

Configuration and usage notes

The server is typically started as part of the standard development workflow using the package manager scripts. Use the built server file with your MCP client, or connect via a local stdio endpoint.

For the standard local runtime, you can start the server with the following command.

pnpm start

Example MCP client configurations

The following configurations illustrate how to connect a client to a local stdio MCP server. Use the full path to the built entry script on your machine.

{
  "mcpServers": {
    "rednote_win": {
      "type": "stdio",
      "command": "node",
      "args": [
        "C:\\ABSOLUTE\\PATH\\TO\\rednote-mcp\\build\\index.js"
      ]
    }
  }
}

Troubleshooting

If you encounter login prompts on first use, perform a manual login and ensure the cookies directory is created and accessible. If timeouts occur, increase your MCP client timeout settings. If browser binaries are missing, install them with the specified command.

pnpm exec playwright install

Additional runtime options for macOS/Linux users

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

Available tools

smart_search

Performs keyword-based searches on Xiaohongshu to retrieve matching notes with rich metadata.

auto_login

Manages login cookies automatically, performing initial login on first use and reusing cookies for subsequent requests.

parallel_processing

Enables concurrent content retrieval to speed up overall search performance.

data_extraction

Extracts and structures note data including title, content, author, metrics, tags, and images.