An automated tool to search notes, retrieve content, and post comments on Xiaohongshu (RedBook) using Playwright.
本项目基于 JonaFly/RednoteMCP 并结合我自己的使用经验,进行优化和改进(by windsurf)。在此向原作者表示衷心的感谢!
这是一款基于 Playwright 开发的小红书自动搜索和评论工具,作为 MCP Server,可通过特定配置接入 MCP Client(如Claude for Desktop),帮助用户自动完成登录小红书、搜索关键词、获取笔记内容及发布智能评论等操作。
2.0主要优化内容如下:
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
在 MCP Client(如Claude for Desktop)的配置文件中添加以下内容,将本工具配置为 MCP Server:
{
"mcpServers": {
"xiaohongshu MCP": {
"command": "/绝对路径/到/venv/bin/python3",
"args": [
"/绝对路径/到/xiaohongshu_mcp.py",
"--stdio"
]
}
}
}
重要提示:
- 请使用虚拟环境中Python解释器的完整绝对路径
- 例如:
/Users/username/Desktop/RedBook-Search-Comment-MCP/venv/bin/python3
- 同样,xiaohongshu_mcp.py也需要使用完整绝对路径
直接运行:在项目目录下,激活虚拟环境后执行:
python3 xiaohongshu_mcp.py
通过 MCP Client 启动:配置好MCP Client后,按照客户端的操作流程进行启动和连接。
在MCP Client(如Claude for Desktop)中连接到服务器后,可以使用以下功能:
工具函数:
mcp0_login()
在MCP客户端中的使用方式: 直接发送以下文本:
帮我登录小红书账号
或:
请登录小红书
功能说明:首次使用时会打开浏览器窗口,等待用户手动扫码登录。登录成功后,工具会保存登录状态。
工具函数:
mcp0_search_notes(keywords="关键词", limit=5)
在MCP客户端中的使用方式: 发送包含关键词的搜索请求:
帮我搜索小红书笔记,关键词为:美食
指定返回数量:
帮我搜索小红书笔记,关键词为旅游,返回10条结果
功能说明:根据关键词搜索小红书笔记,并返回指定数量的结果。默认返回5条结果。
工具函数:
mcp0_get_note_content(url="笔记URL")
在MCP客户端中的使用方式: 发送包含笔记URL的请求:
帮我获取这个笔记的内容:https://www.xiaohongshu.com/search_result/xxxx
或:
请查看这个小红书笔记的内容:https://www.xiaohongshu.com/search_result/xxxx
功能说明:获取指定笔记URL的详细内容,包括标题、作者、发布时间和正文内容。
工具函数:
mcp0_get_note_comments(url="笔记URL")
在MCP客户端中的使用方式: 发送包含笔记URL的评论请求:
帮我获取这个笔记的评论:https://www.xiaohongshu.com/search_result/xxxx
或:
请查看这个小红书笔记的评论区:https://www.xiaohongshu.com/search_result/xxxx
功能说明:获取指定笔记URL的评论信息,包括评论者、评论内容和评论时间。
工具函数:
mcp0_post_smart_comment(url="笔记URL", comment_type="评论类型")
在MCP客户端中的使用方式: 发送包含笔记URL和评论类型的请求:
帮我在这个笔记发布专业类型的评论:https://www.xiaohongshu.com/search_result/xxxx
或:
请在这个小红书笔记下发布一条引流评论:https://www.xiaohongshu.com/search_result/xxxx
评论类型参数可选值:
"引流"
(默认):引导用户关注或私聊"点赞"
:简单互动获取好感"咨询"
:以问题形式增加互动"专业"
:展示专业知识建立权威功能说明:在指定笔记下发布智能评论,系统会根据笔记内容和指定的评论类型自动生成适合的评论内容。
连接失败:
浏览器会话问题:
如果遇到Page.goto: Target page, context or browser has been closed
错误:
依赖安装问题:
如果遇到ModuleNotFoundError
错误:
本工具仅用于学习和研究目的,使用者应严格遵守相关法律法规以及小红书平台的规定。因使用不当导致的任何问题,本项目开发者不承担任何责任。
Discover, extract, and interact with the web - one interface powering automated access across the public internet.
Automate web browsers and perform web scraping tasks using the Playwright framework.
Fetch the content of a remote URL as Markdown with Jina Reader.
High-quality screenshot capture optimized for Claude Vision API. Automatically tiles full pages into 1072x1072 chunks (1.15 megapixels) with configurable viewports and wait strategies for dynamic content.
Attaches to existing browser sessions using the Chrome DevTools Protocol for automation and interaction.
Provides web context to LLMs using Cloudflare's Browser Rendering API.
Access YouTube video transcripts and translations using the YouTube Translate API.
A server for browser automation using Playwright, providing powerful tools for web scraping, testing, and automation.
Automate Chrome via its debugging port with session persistence. Requires Chrome to be started with remote debugging enabled.
A fast, lightweight MCP server that empowers LLMs with browser automation via Puppeteer’s structured accessibility data, featuring optional vision mode for complex visual understanding and flexible, cross-platform configuration.