RedNote 小红书

# RedNote MCP [](docs/README.en.md) [](README.md) [](https://www.npmjs.com/package/rednote-mcp) MCP service for accessing content on Xiaohongshu https://github.com/user-attachments/assets/06b2c67f-d9ed-4a30-8f1d-9743f3edaa3a ## Quick Start Before you begin, ensure that you have the [playwright](https://github.com/microsoft/playwright) environment installed: ```bash npx playwright install ``` ### Global Installation via NPM ```bash # Global installation npm install -g rednote-mcp # Initialize login, which will automatically save cookies to ~/.mcp/rednote/cookies.json rednote-mcp init ``` ### Installation from Source ```bash # Clone the project git clone https://github.com/ifuryst/rednote-mcp.git cd rednote-mcp # Install dependencies npm install # Global installation (optional, for easier command line access) npm install -g . # Or run directly, such as initializing login npm run dev -- init ``` ## Features - Authentication management (supports Cookie persistence) - Keyword search for notes - Command line initialization tool - Access note content via URL - [ ] Access comment content via URL ## Usage Instructions ### 1. Initialize Login The first time you use it, you need to perform login initialization: ```bash rednote-mcp init # Or run directly from source npm run dev -- init # Or choose login in mcp-client ``` After executing this command: 1. A browser window will automatically open 2. It will redirect to the Xiaohongshu login page 3. Please complete the login operation manually 4. Upon successful login, the Cookie will be automatically saved to the `~/.mcp/rednote/cookies.json` file ### 2. Configure MCP Server in Cursor Add the following configuration in the settings.json of Cursor: ```json { "mcpServers": { "RedNote MCP": { "command": "rednote-mcp", "args": [ "--stdio" ] } } } ``` Or use the npx method: ```json { "mcpServers": { "RedNote MCP": { "command": "npx", "args": [ "rednote-mcp", "--stdio" ] } } } ``` Configuration Explanation: - `command`: Can be the `rednote-mcp` command after global installation, or run directly using `npx` - `args`: Must include the `--stdio` parameter to support communication with Cursor ## Development Guide ### Environment Requirements - Node.js >= 16 - npm >= 7 ### Development Process ```bash # Install dependencies npm install # Build the project npm run build # Run in development mode npm run dev # Run tests npm test ``` ### Debugging with MCP Inspector MCP Inspector is a tool for debugging the MCP server, helping developers inspect and validate the behavior of the MCP server. Start it with the following command: ```bash npx @modelcontextprotocol/inspector npx rednote-mcp --stdio ``` This command will: 1. Start the MCP Inspector tool 2. Run the rednote-mcp service through the Inspector 3. Provide an interactive interface to inspect requests and responses 4. Assist in debugging and validating the implementation of the MCP protocol ## Notes 1. You must execute the `init` command for login the first time you use it 2. The Cookie file contains sensitive information; avoid leaking it 3. It is recommended to update the Cookie regularly to prevent expiration 4. Ensure that the Node.js environment is correctly installed ## Contribution Guidelines 1. Fork this repository 2. Create your feature branch (`git checkout -b feature/AmazingFeature`) 3. Commit your changes (`git commit -m 'Add some AmazingFeature'`) 4. Push to the branch (`git push origin feature/AmazingFeature`) 5. Open a Pull Request ## License MIT License - See the [LICENSE](LICENSE) file for details.