字
字节笔记本
2026年2月22日
小红书自动搜索评论 MCP Server 2.0:基于 Playwright 的自动化工具
本文介绍 Redbook-Search-Comment-MCP2.0,一款基于 Playwright 开发的小红书自动搜索和评论 MCP Server。该项目支持接入 Claude for Desktop 等 MCP Client,帮助用户自动完成登录小红书、搜索关键词、获取笔记内容及发布 AI 生成评论等操作。截至目前,该项目在 GitHub 上已获得 384 stars 和 56 forks。
项目简介
Redbook-Search-Comment-MCP2.0 是一个开源的 MCP Server 项目,由 chenningling 开发维护。它通过 Playwright 自动化技术,实现了与小红书平台的交互,让用户可以通过自然语言指令控制小红书操作。
核心特性
- 自动登录:支持扫码登录小红书,保存登录状态
- 智能搜索:根据关键词搜索笔记,支持自定义返回数量
- 内容获取:获取笔记详情、正文内容和评论列表
- AI 评论:基于笔记内容自动生成并发布智能评论
- MCP 协议:完全兼容 Model Context Protocol 标准
2.0 版本优化
- 更稳定的浏览器实例管理
- 改进的内容提取算法
- 支持更多评论类型(专业、幽默、友好等)
- 更好的错误处理和日志输出
- 模块化代码结构,易于扩展
技术栈
- Python 3.8+:主要开发语言
- Playwright:浏览器自动化框架
- MCP SDK:Model Context Protocol 官方 SDK
- 异步架构:基于 asyncio 的高性能处理
安装指南
前置要求
- Python 3.8 或更高版本
- pip 包管理器
- Chrome 或 Chromium 浏览器
安装步骤
bash
# 克隆仓库
git clone https://github.com/chenningling/Redbook-Search-Comment-MCP2.0.git
cd Redbook-Search-Comment-MCP2.0
# 创建虚拟环境
python3 -m venv venv
# 激活虚拟环境
# macOS/Linux:
source venv/bin/activate
# Windows:
venv\Scripts\activate
# 安装依赖
pip install -r requirements.txt
# 安装 Playwright 浏览器
playwright install chromiumMCP Server 配置
Mac 配置示例
在 Claude for Desktop 的配置文件中添加:
json
{
"mcpServers": {
"xiaohongshu MCP": {
"command": "/绝对路径/到/venv/bin/python3",
"args": [
"/绝对路径/到/xiaohongshu_mcp.py",
"--stdio"
]
}
}
}Windows 配置示例
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"
]
}
}
}使用方法
1. 登录小红书
帮我登录小红书账号
或
mcp0_login()
2. 搜索笔记
帮我搜索小红书笔记,关键词为:美食
或
mcp0_search_notes(keywords="美食", limit=5)
3. 获取笔记内容
帮我获取这个笔记的内容:https://www.xiaohongshu.com/explore/xxxx
或
mcp0_get_note_content(url="笔记URL")
4. 获取笔记评论
帮我获取这个笔记的评论:https://www.xiaohongshu.com/explore/xxxx
或
mcp0_get_note_comments(url="笔记URL")
5. 发布智能评论
帮我为这个笔记写一条专业类型的评论:https://www.xiaohongshu.com/explore/xxxx
或
mcp0_post_smart_comment(url="笔记URL", comment_type="专业")
6. 发布指定评论
text
帮我发布这条评论到笔记:https://www.xiaohongshu.com/explore/xxxx
评论内容:写得太好了,学到了很多!或
mcp0_post_comment(url="笔记URL", comment="评论内容")
评论类型选项
| 类型 | 说明 |
|---|---|
| 专业 | 专业角度的深度评论 |
| 幽默 | 轻松幽默风格的评论 |
| 友好 | 友善亲切的评论 |
| 简短 | 简洁明了的短评 |
| 详细 | 详细展开的长评 |
工作原理
本工具采用两步式流程实现智能评论功能:
- 内容获取:工具获取笔记内容并返回给 MCP 客户端
- AI 生成:MCP 客户端(如 Claude)基于内容生成评论,再调用工具发布
这种设计充分利用了 MCP 客户端的 AI 能力,实现了更自然、相关的评论生成。
代码结构
text
Redbook-Search-Comment-MCP2.0/
├── xiaohongshu_mcp.py # MCP Server 主文件
├── xiaohongshu_bot.py # 小红书操作核心模块
├── requirements.txt # 依赖列表
├── browser_data/ # 浏览器数据目录
└── README.md # 项目文档常见问题
浏览器实例问题
如果遇到 "Page.goto: Target page, context or browser has been closed" 错误:
bash
# 删除浏览器锁文件
rm -f /项目路径/browser_data/SingletonLock
rm -f /项目路径/browser_data/SingletonCookie
# 如果问题仍然存在,备份并重建浏览器数据目录
mkdir -p /项目路径/backup_browser_data
mv /项目路径/browser_data/* /项目路径/backup_browser_data/
mkdir -p /项目路径/browser_data内容获取问题
如果无法获取笔记内容或内容不完整:
- 检查网络连接是否稳定
- 确认小红书页面结构未发生变化
- 尝试增加页面等待时间
- 检查是否需要重新登录
平台变化适应
小红书平台可能会更新页面结构和 DOM 元素,导致工具无法正常工作。如遇到此类问题:
- 检查浏览器控制台是否有元素选择失败的错误
- 根据新的页面结构更新选择器
- 关注项目更新,获取适配新版本
注意事项
- 本工具仅用于学习和研究目的
- 使用者应严格遵守相关法律法规以及小红书平台的规定
- 请合理控制操作频率,避免触发平台风控
- 建议配合小红书账号使用,不要过度自动化操作
- 因使用不当导致的任何问题,项目开发者不承担任何责任
项目链接
- GitHub 仓库:https://github.com/chenningling/Redbook-Search-Comment-MCP2.0
- Stars:384
- Forks:56
总结
Redbook-Search-Comment-MCP2.0 是一个功能强大的小红书自动化 MCP Server,通过 MCP 协议与 AI 助手无缝集成。它不仅能帮助用户高效获取小红书内容,还能基于 AI 生成智能评论,是内容创作者和营销人员的实用工具。
分享: