红皮书-搜索-评论-MCP
项目介绍
小红书自动搜索评论工具（MCP服务器）
本项目基于JonaFly/RednoteMCP，并根据个人使用经验进行优化改进（由windsurf完成）。衷心感谢原作者！
这是一个基于Playwright开发的小红书自动搜索和评论工具。作为MCP服务器，它可以通过特定配置连接到MCP客户端（如Claude桌面版），帮助用户自动完成登录小红书、搜索关键词、获取笔记内容以及发布智能评论等操作。
注意：Redbook-Search-Comment-MCP2.0 已经发布！点击即可直接使用！
2.0版本的主要优化内容如下：
- 优化了搜索笔记时标题不显示的问题
- 增加了多种获取笔记的方法，确保完全检索笔记内容
- 重构了评论功能，利用MCP客户端（如Claude）的AI能力生成更自然的评论
- 将功能模块化为三个独立模块：笔记分析、评论生成和评论发布
1、 功能特性
- 自动登录支持手动二维码登录方式，首次成功登录后会保存登录状态，后续使用无需再次扫描二维码。
- 关键词搜索可以根据用户输入的关键词搜索小红书笔记，并指定返回的结果数量。
- 获取笔记内容输入笔记的URL以获取其详细内容。
- 笔记及评论获取通过笔记URL检索对应的评论信息。
- 智能评论发布支持多种类型的评论，包括引流（引导用户关注或私聊）、点赞（简单的互动以获得好感）、咨询（以提问形式增加互动）、专业（展示专业知识以建立权威），可根据需要选择发布。
2、 安装步骤
-
准备Python环境确保系统已安装Python 3.8或更高版本。如果没有安装，可以从官方Python网站下载并安装。
-
获取项目本地克隆或下载此项目。
-
创建虚拟环境在项目目录中创建并激活虚拟环境（推荐）：
# 创建虚拟环境 python3 -m venv venv # 激活虚拟环境 # Windows venv\Scripts\activate # macOS/Linux source venv/bin/activate -
安装依赖在激活的虚拟环境中安装所需的依赖：
pip install -r requirements.txt pip install fastmcp -
安装浏览器安装Playwright所需浏览器：
playwright install
3、 MCP服务器配置
在MCP客户端（如Claude桌面版）的配置文件中添加以下内容，以将此工具配置为MCP服务器：
{
"mcpServers": {
"xiaohongshu MCP": {
"command": "/绝对路径/到/venv/bin/python3",
"args": [
"/绝对路径/到/xiaohongshu_mcp.py",
"--stdio"
]
}
}
}
重要提示：
- 请使用虚拟环境中的Python解释器完整绝对路径
- 例如：
/Users/username/Desktop/RedBook-Search-Comment-MCP/venv/bin/python3- 同样，xiaohongshu_ccp.py也需要使用完整绝对路径
4、 使用方法
（1） 启动服务器
-
直接运行在项目目录中激活虚拟环境后执行：
python3 xiaohongshu_mcp.py -
通过MCP客户端启动配置好MCP客户端后，按照客户端的操作流程启动并连接。
（2） 主要功能操作
在MCP客户端（如Claude桌面版）连接到服务器后，可以使用以下功能：
1. 登录小红书
实用函数：
mcp0_login()
在MCP客户端中的使用： 直接发送以下文本：
帮我登录小红书账号
或者：
请登录小红书
功能描述首次使用时，浏览器窗口会打开并等待用户手动扫码登录。登录成功后，工具会保存登录状态。
2. 搜索笔记
实用函数：
mcp0_search_notes(keywords="关键词", limit=5)
在MCP客户端中的使用： 发送包含关键词的搜索请求：
帮我搜索小红书笔记，关键词为：美食
指定返回的数量：
帮我搜索小红书笔记，关键词为旅游，返回11条结果
功能描述根据关键词搜索小红书笔记，并返回指定数量的结果，默认返回5个结果。
3. 获取笔记内容
实用函数：
mcp0_get_note_content(url="笔记URL")
在MCP客户端中的使用： 发送包含笔记URL的请求：
帮我获取这个笔记的内容：https://www.xiaohongshu.com/search_result/xxxx
或者：
请查看这个小红书笔记的内容：https://www.xiaohongshu.com/search_result/xxxx
功能描述检索指定笔记URL的详细内容，包括标题、作者、发布时间和正文内容。
4. 获取笔记评论
实用函数：
mcp0_get_note_comments(url="笔记URL")
在MCP客户端中的使用： 发送包含笔记URL的评论请求：
帮我获取这个笔记的评论：https://www.xiaohongshu.com/search_result/xxxx
或者：
请查看这个小红书笔记的评论区：https://www.xiaohongshu.com/search_result/xxxx
功能描述检索指定笔记URL的评论信息，包括评论者、评论内容和评论时间。
5. 发布智能评论
实用函数：
mcp0_post_smart_comment(url="笔记URL", comment_type="评论类型")
在MCP客户端中的使用： 发送包含笔记URL和评论类型的请求：
帮我在这个笔记发布专业类型的评论：https://www.xiaohongshu.com/search_result/xxxx
或者：
请在这个小红书笔记下发布一条引流评论：https://www.xiaohongshu.com/search_result/
评论类型参数可选值：
"引流"(默认)：引导用户关注或私聊"点赞"：简单的互动以获得好感"咨询"：以提问形式增加互动"专业"：展示专业知识以建立权威
功能描述在指定笔记下发布智能评论，系统将根据笔记内容和指定的评论类型自动生成合适的评论内容。
5、 代码结构
- xiaohongshu_mcp.py实现主要功能的核心文件，包括登录、搜索、获取内容和评论以及发布评论的代码逻辑。
- requirements.txt记录项目所需的依赖库。
6、 常见问题与解决方案
-
连接失败：
- 确保使用虚拟环境中的Python解释器完整绝对路径
- 确保MCP服务器正在运行
- 尝试重启MCP服务器和客户端
-
浏览器会话问题： 如果遇到
Page.goto: 目标页面、上下文或浏览器已被关闭错误- 重启MCP服务器
- 重新连接并登录
-
依赖安装问题： 如果遇到
ModuleNotFoundError错误- 确保所有依赖已在虚拟环境中安装
- 检查是否已安装fastmcp包
7、 注意事项
- 浏览器模式该工具在Playwright的非隐藏模式下运行，在运行时会打开真实的浏览器窗口。
- 登录方式首次登录需要手动扫描二维码。如果后续使用时登录状态有效，则无需再次扫描二维码。
- 平台规则使用过程中请严格遵守小红书平台的相关规定，避免过度操作，防止账户面临被封禁等风险。
- 功能兼容性由于小红书平台可能存在的更新和调整，搜索结果和评论功能的可用性可能会受到影响。如有异常，请及时关注项目更新或联系开发者。
8、 免责声明
本工具仅用于学习和研究目的，用户应严格遵守相关法律法规以及小红书平台的规定。本项目开发者不对因不当使用而产生的任何问题负责。