Content
# Xiaohongshu Automatic Comment Search Tool (MCP Server 2.0)
<div align="right">
[English](README_EN.md) | 中文
</div>
> This project is based on [JonaFly/RednoteMCP](https://github.com/JonaFly/RednoteMCP.git) and has been comprehensively optimized and functionally expanded based on multiple practical experiences (by windsurf). Sincere thanks to the original author for their contributions!
This is an automatic search and comment tool for Xiaohongshu developed using Playwright. As an MCP Server, it can be integrated with MCP Client (such as Claude for Desktop) through specific configurations, helping users to automatically log in to Xiaohongshu, search for keywords, retrieve note content, and publish AI-generated comments.
## Main Features and Advantages
- **Deep Integration of AI Capabilities**: Utilizes the large model capabilities of MCP clients (like Claude) to generate more natural and relevant comment content.
- **Modular Design**: Divides functionalities into three independent modules: note analysis, comment generation, and comment publishing, improving code maintainability.
- **Powerful Content Retrieval**: Integrates various methods for retrieving note content, ensuring complete acquisition of titles, authors, and body content of various notes.
- **Persistent Login**: Uses persistent browser context, eliminating the need for repeated logins after the first login.
- **Two-Step Comment Process**: First retrieves note analysis results, then generates and publishes comments using the MCP client.
## Major Optimizations in Version 2.0
- **Enhanced Content Retrieval**: Refactored the note content retrieval module, increasing page load wait times and scroll operations, implementing four different content retrieval methods.
- **AI Comment Generation**: Refactored the comment functionality to return note analysis results to the MCP client, allowing the client's AI capabilities to generate more natural and relevant comments.
- **Functional Modularization**: Divided functionalities into three independent modules: note analysis, comment generation, and comment publishing, improving code maintainability.
- **Search Result Optimization**: Resolved the issue of titles not displaying when searching for notes, providing more complete search results.
- **Enhanced Error Handling**: Added more detailed error handling and debugging information output.
## I. Core Functions
### 1. User Authentication and Login
- **Persistent Login**: Supports manual QR code login, saving the state after the first login, so no need to scan again for subsequent uses.
- **Login Status Management**: Automatically detects login status and prompts the user to log in when necessary.
### 2. Content Discovery and Retrieval
- **Intelligent Keyword Search**: Supports multi-keyword searches, allows specifying the number of results to return, and provides complete note information.
- **Multi-Dimensional Content Retrieval**: Integrates four different retrieval methods to ensure accurate acquisition of note titles, authors, publication times, and body content.
- **Comment Data Retrieval**: Supports retrieving comment content for notes, including commenters, comment text, and time information.
### 3. Content Analysis and Generation
- **Note Content Analysis**: Automatically analyzes note content, extracts key information, and identifies the field to which the note belongs.
- **AI Comment Generation**: Utilizes the AI capabilities of MCP clients (like Claude) to generate natural and relevant comments based on note content.
- **Support for Multiple Comment Types**: Supports generating four different types of comments:
- **Traffic Generation**: Guides users to follow or message privately.
- **Like Type**: Simple interaction to gain favor.
- **Inquiry Type**: Increases interaction in the form of questions.
- **Professional Type**: Demonstrates expertise to establish authority.
### 4. Data Return and Feedback
- **Structured Data Return**: Returns note analysis results in JSON format to the MCP client, facilitating AI comment generation.
- **Comment Publishing Feedback**: Provides real-time feedback on comment publishing results.
## II. Installation Steps
1. **Prepare Python Environment**: Ensure that Python 3.8 or higher is installed on your system. If not, download and install it from the official Python website.
2. **Obtain the Project**: Clone or download this project to your local machine.
3. **Create a Virtual Environment**: Create and activate a virtual environment in the project directory (recommended):
```bash
# Create virtual environment
python3 -m venv venv
# Activate virtual environment
# Windows
venv\Scripts\activate
# macOS/Linux
source venv/bin/activate
```
4. **Install Dependencies**: Install the required dependencies in the activated virtual environment:
```bash
pip install -r requirements.txt
pip install fastmcp
```
5. **Install Browsers**: Install the browsers required by Playwright:
```bash
playwright install
```
## III. MCP Server Configuration
Add the following content to the configuration file of the MCP Client (such as Claude for Desktop) to configure this tool as an MCP Server:
### Mac Configuration Example
```json
{
"mcpServers": {
"xiaohongshu MCP": {
"command": "/absolute/path/to/venv/bin/python3",
"args": [
"/absolute/path/to/xiaohongshu_mcp.py",
"--stdio"
]
}
}
}
```
### Windows Configuration Example
```json
{
"mcpServers": {
"xiaohongshu MCP": {
"command": "C:\\Users\\username\\Desktop\\MCP\\Redbook-Search-Comment-MCP2.0\\venv\\Scripts\\python.exe",
"args": [
"C:\\Users\\username\\Desktop\\MCP\\Redbook-Search-Comment-MCP2.0\\xiaohongshu_mcp.py",
"--stdio"
]
}
}
}
```
> **Important Note**:
> - Please use the **full absolute path** of the Python interpreter in the virtual environment.
> - Mac example: `/Users/username/Desktop/RedBook-Search-Comment-MCP/venv/bin/python3`
> - Windows example: `C:\Users\username\Desktop\MCP\Redbook-Search-Comment-MCP2.0\venv\Scripts\python.exe`
> - Similarly, `xiaohongshu_mcp.py` also needs to use the **full absolute path**.
> - Backslashes in Windows paths need to be double-escaped in JSON (use `\`).
### Python Command Distinction (python vs python3)
The Python command may vary in different system environments depending on your system configuration. Here’s how to determine which command you should use:
1. **Determine Your Python Command**:
- Run in the terminal: `python --version` and `python3 --version`
- Check which command returns Python 3.x version (this project requires Python 3.8+).
2. **Confirm in the Virtual Environment**:
- After activating the virtual environment, run `which python` or `where python` (Windows).
- This will display the full path of the Python interpreter.
3. **Use the Correct Command in Configuration**:
- Mac: Usually `python3` or `python` in the virtual environment.
- Windows: Usually `python` or `python.exe`.
In the configuration file, always use the **full absolute path** of the Python interpreter in the virtual environment, rather than the command name.
## IV. Usage Instructions
### (I) Start the Server
1. **Run Directly**: In the project directory, activate the virtual environment and execute:
```bash
python3 xiaohongshu_mcp.py
```
2. **Start via MCP Client**: After configuring the MCP Client, follow the client’s operational process to start and connect.
### (II) Main Function Operations
After connecting to the server in the MCP Client (such as Claude for Desktop), you can use the following functions:
### 1. Log in to Xiaohongshu
**Tool Function**:
```
mcp0_login()
```
**Usage in MCP Client**:
Simply send the following text:
```
Help me log in to my Xiaohongshu account
```
or:
```
Please log in to Xiaohongshu
```
**Function Description**: The first time you use it, a browser window will open, waiting for the user to manually scan the QR code to log in. After a successful login, the tool will save the login status.
### 2. Search for Notes
**Tool Function**:
```
mcp0_search_notes(keywords="keyword", limit=5)
```
**Usage in MCP Client**:
Send a search request containing keywords:
```
Help me search for Xiaohongshu notes with the keyword: food
```
Specify the number of results:
```
Help me search for Xiaohongshu notes with the keyword travel, return 10 results
```
**Function Description**: Searches Xiaohongshu notes based on keywords and returns the specified number of results. Defaults to returning 5 results.
### 3. Retrieve Note Content
**Tool Function**:
```
mcp0_get_note_content(url="note URL")
```
**Usage in MCP Client**:
Send a request containing the note URL:
```
Help me get the content of this note: https://www.xiaohongshu.com/search_result/xxxx
```
or:
```
Please check the content of this Xiaohongshu note: https://www.xiaohongshu.com/search_result/xxxx
```
**Function Description**: Retrieves detailed content of the specified note URL, including title, author, publication time, and body content.
### 4. Retrieve Note Comments
**Tool Function**:
```
mcp0_get_note_comments(url="note URL")
```
**Usage in MCP Client**:
Send a request containing the note URL for comments:
```
Help me get the comments for this note: https://www.xiaohongshu.com/search_result/xxxx
```
or:
```
Please check the comment section of this Xiaohongshu note: https://www.xiaohongshu.com/search_result/xxxx
```
**Function Description**: Retrieves comment information for the specified note URL, including commenters, comment content, and comment time.
### 5. Publish Smart Comments
**Tool Function**:
```
mcp0_post_smart_comment(url="note URL", comment_type="comment type")
```
**Usage in MCP Client**:
Send a request containing the note URL and comment type:
```
Help me write a [type] comment for this note: https://www.xiaohongshu.com/explore/xxxx
```
**Function Description**: Retrieves note analysis results and returns them to the MCP client, which generates comments and calls `post_comment` to publish.
### 6. Publish Comments
**Tool Function**:
```
mcp0_post_comment(url="note URL", comment="comment content")
```
**Usage in MCP Client**:
Send a request containing the note URL and comment content:
```
Help me publish this comment to the note: https://www.xiaohongshu.com/explore/xxxx
Comment content: [comment content]
```
**Function Description**: Publishes the specified comment content to the note page.
## V. Usage Guide
### 0. Working Principle
This tool implements the smart comment function through a two-step process:
1. **Note Analysis**: Calls the `post_smart_comment` tool to retrieve note information (title, author, content, etc.).
2. **Comment Generation and Publishing**:
- The MCP client (like Claude) generates comments based on the note analysis results.
- Calls the `post_comment` tool to publish comments.
This design fully utilizes the AI capabilities of the MCP client to achieve more natural and relevant comment generation.
### 1. Usage in MCP Client
#### Basic Operations
| Function | Example Command |
|---------|----------|
| **Search Notes** | `Help me search for Xiaohongshu notes about [keyword]` |
| **Get Note Content** | `Help me check the content of this Xiaohongshu note: https://www.xiaohongshu.com/explore/xxxx` |
| **Analyze Note** | `Help me analyze this Xiaohongshu note: https://www.xiaohongshu.com/explore/xxxx` |
| **Get Comments** | `Help me check the comments for this note: https://www.xiaohongshu.com/explore/xxxx` |
| **Generate Comment** | `Help me write a [type] comment for this Xiaohongshu note: https://www.xiaohongshu.com/explore/xxxx` |
#### Comment Type Options
| Type | Description | Applicable Scenarios |
|---------|------|----------|
| **Traffic Generation** | Guides users to follow or message privately | Increase followers or private message interaction |
| **Like Type** | Simple interaction to gain favor | Increase exposure and interaction rate |
| **Inquiry Type** | Increases interaction in the form of questions | Provokes responses from the author, increasing interaction depth |
| **Professional Type** | Demonstrates expertise to establish authority | Builds a professional image and enhances credibility |
### 2. Example of Actual Workflow
```
User: Help me write a professional type comment for this Xiaohongshu note: https://www.xiaohongshu.com/explore/xxxx
Claude: I will help you write a professional type comment. Let me retrieve the note content and generate a comment.
[Calling post_smart_comment tool]
# Tool returns note analysis results, including title, author, content, field, and keywords
Claude: I have retrieved the note information; this is a note about [topic]. Based on the content, I generated and published the following professional comment:
"[Generated professional comment content]"
[Calling post_comment tool]
Claude: The comment has been successfully published!
```
**Note**: In the above process, the `post_smart_comment` tool is only responsible for retrieving note analysis results and returning them to the MCP client; the actual comment generation is completed by the MCP client (like Claude) itself.
### 3. Working Principle
The new Xiaohongshu MCP tool adopts a modular design, divided into three core modules:
1. **Note Analysis Module** (`analyze_note`)
- Retrieves the note's title, author, publication time, and content.
- Analyzes the field and keywords of the note.
- Returns structured note information.
2. **Comment Generation Module** (implemented by the MCP client)
- Receives note analysis results.
- Generates natural and relevant comments based on note content and comment type.
- Allows users to preview and modify comments before publishing.
3. **Comment Publishing Module** (`post_comment`)
- Receives the generated comment content.
- Locates and interacts with the comment input box.
- Publishes comments and returns results.
## VI. Code Structure
- **xiaohongshu_mcp.py**: The core file implementing the main functionalities, including login, search, content retrieval, comment retrieval, and comment publishing.
- **requirements.txt**: Records the dependencies required for the project.
## VII. Common Issues and Solutions
1. **Connection Failure**:
- Ensure you are using the **full absolute path** of the Python interpreter in the virtual environment.
- Ensure the MCP server is running.
- Try restarting the MCP server and client.
2. **Browser Session Issues**:
If you encounter the `Page.goto: Target page, context or browser has been closed` error:
- Restart the MCP server.
- Reconnect and log in again.
3. **Dependency Installation Issues**:
If you encounter a `ModuleNotFoundError` error:
- Ensure all dependencies are installed in the virtual environment.
- Check if the fastmcp package is installed.
## VIII. Notes and Problem Solving
### 1. Usage Notes
- **Browser Mode**: The tool runs in non-headless mode using Playwright, opening a real browser window during execution.
- **Login Method**: The first login requires manual QR code scanning; subsequent uses do not require rescanning if the login status is valid.
- **Platform Rules**: Please strictly adhere to Xiaohongshu platform regulations during use to avoid excessive operations that may risk account suspension.
- **Comment Frequency**: It is recommended to control the frequency of comment publishing, avoiding the publication of a large number of comments in a short time, with a maximum of 30 comments per day.
### 2. Common Issues and Solutions
#### Browser Instance Issues
If you encounter errors like “Page.goto: Target page, context or browser has been closed,” it may be due to the browser instance not closing properly or issues with the data directory lock file. Please try:
```bash
# Delete browser lock files
rm -f /project/path/browser_data/SingletonLock /project/path/browser_data/SingletonCookie
# If the problem persists, back up and rebuild the browser data directory
mkdir -p /project/path/backup_browser_data
mv /project/path/browser_data/* /project/path/backup_browser_data/
mkdir -p /project/path/browser_data
```
#### Content Retrieval Issues
If you cannot retrieve note content or the content is incomplete, you can try:
1. **Increase Wait Time**: Xiaohongshu note pages may require longer loading times, especially for notes with many images or videos.
2. **Clear Browser Cache**: Sometimes, browser cache can affect content retrieval.
3. **Try Different Retrieval Methods**: The tool integrates multiple retrieval methods; if one fails, you can try others.
#### Adapting to Platform Changes
Xiaohongshu may update its page structure and DOM elements, causing the tool to malfunction. If you encounter such issues:
1. **Check Project Updates**: Stay updated with the latest version of the project and update promptly.
2. **Adjust Selectors**: If you are familiar with the code, you can try adjusting CSS selectors or XPath expressions.
3. **Submit Issue Feedback**: Report issues to the project maintainers, describing the specific problems encountered and page changes.
## IX. Disclaimer
This tool is intended for educational and research purposes only. Users should strictly comply with relevant laws and regulations as well as Xiaohongshu platform rules. The developers of this project bear no responsibility for any issues arising from improper use.
