使用说明
项目简介
RednoteMCP (小红书自动评论工具) 是一款基于 Playwright 开发的 MCP 服务器,旨在帮助用户通过 MCP 客户端自动化与小红书平台的内容互动。它提供了一系列工具,包括自动登录小红书、根据关键词搜索笔记、获取笔记内容和评论,以及发布智能评论等功能。通过配置,LLM 应用可以利用这些工具获取小红书平台的信息,并进行互动操作。
主要功能点
- 自动登录: 支持扫码登录小红书,并能保持登录状态,避免重复登录。
- 关键词搜索: 根据关键词搜索小红书笔记,并可自定义返回结果数量。
- 笔记内容获取: 通过笔记 URL 获取完整的笔记内容,包括标题、作者、发布时间及正文。
- 笔记评论获取: 通过笔记 URL 抓取笔记下的评论信息,了解用户互动情况。
- 智能评论发布: 支持多种预设评论类型(引流、点赞、咨询、专业),能够根据笔记内容发布不同类型的智能评论,实现自动化互动。
安装步骤
- 检查 Python 环境: 确保已安装 Python 3.8 或更高版本。
- 获取项目代码: 从 GitHub 仓库 https://github.com/JonaFly/RednoteMCP 克隆或下载项目代码到本地。
- 安装依赖: 打开命令行工具,切换到项目根目录,运行 'pip install -r requirements.txt' 安装项目依赖的 Python 库。
- 浏览器安装: 首次运行工具时,会自动安装 Playwright 所需的浏览器组件。
服务器配置
要将 RednoteMCP 配置为 MCP 服务器,需要在 MCP Client 的配置文件(通常是 JSON 格式)中添加 'mcpServers' 字段。以下是一个配置示例,请根据实际情况修改文件路径:
{ "mcpServers": { "xiaohongshu MCP": { // 服务器名称,可以自定义 "command": "python", // 启动服务器的命令,这里使用 python 解释器 "args": [ // 启动参数 "/ABSOLUTE/PATH/TO/PARENT/FOLDER/xiaohongshu_mcp.py", // xiaohongshu_mcp.py 脚本的绝对路径,请替换为实际路径 "--stdio" // 指定使用 stdio 作为传输协议 ] } } }
注意:
- 请将 '/ABSOLUTE/PATH/TO/PARENT/FOLDER/xiaohongshu_mcp.py' 替换为 'xiaohongshu_mcp.py' 文件在您本地文件系统中的绝对路径。例如,如果您的项目放在 'D:\projects\RednoteMCP' 目录下,则路径可能类似于 'D:\projects\RednoteMCP\xiaohongshu_mcp.py'。
- '--stdio' 参数指定 MCP 服务器使用标准输入输出 (stdio) 进行通信,这是与 MCP 客户端通信的一种常用方式。
基本使用方法
-
启动 MCP 服务器:
- 通过 MCP Client 启动:按照 MCP Client 的文档指引配置并启动 MCP 服务器。MCP Client 会根据您在配置文件中提供的 'command' 和 'args' 启动 RednoteMCP 服务器。
- 直接运行:在项目根目录下,打开命令行工具,执行 'python xiaohongshu_mcp.py --stdio' 命令启动服务器。
-
使用 MCP 客户端调用工具:
-
启动服务器后,您可以使用 MCP 客户端(例如实现了 MCP 协议的 LLM 应用或开发工具)与 RednoteMCP 服务器进行交互。
-
通过客户端,您可以调用 RednoteMCP 提供的各种工具,例如:
- 'login()': 登录小红书账号 (首次使用需要手动扫码)。
- 'search_notes(keywords, limit)': 搜索指定关键词的笔记,'keywords' 为关键词字符串,'limit' 为返回结果数量限制(整数)。
- 'get_note_content(url)': 获取指定 URL 的笔记内容,'url' 为笔记链接字符串。
- 'get_note_comments(url)': 获取指定 URL 笔记的评论,'url' 为笔记链接字符串。
- 'post_smart_comment(url, comment_type)': 在指定 URL 的笔记下发布智能评论,'url' 为笔记链接字符串,'comment_type' 为评论类型(可选值: "引流", "点赞", "咨询", "专业",默认为 "引流")。
-
具体的工具调用方式和参数传递方法请参考您使用的 MCP 客户端的文档。客户端会通过 JSON-RPC 协议与 RednoteMCP 服务器通信,发送请求并接收响应。
-
示例调用 (在 MCP 客户端中): 假设您使用的 MCP 客户端允许您直接调用已配置的 MCP 服务器的工具,以下是一些示例:
# 登录小红书 await client.call_tool('xiaohongshu MCP', 'login') # 搜索关键词 "咖啡",返回前 5 条结果 search_result = await client.call_tool('xiaohongshu MCP', 'search_notes', {'keywords': '咖啡', 'limit': 5}) print(search_result) # 获取指定笔记的内容 note_content = await client.call_tool('xiaohongshu MCP', 'get_note_content', {'url': 'https://www.xiaohongshu.com/note/xxxx'}) print(note_content) # 在指定笔记下发布 "咨询" 类型评论 comment_result = await client.call_tool('xiaohongshu MCP', 'post_smart_comment', {'url': 'https://www.xiaohongshu.com/note/xxxx', 'comment_type': '咨询'}) print(comment_result)
请注意:
- RednoteMCP 依赖于小红书网站的结构,如果小红书网站更新,可能需要调整代码以适应变化。
- 使用自动化工具进行社交平台互动时,请务必遵守平台的使用规则,避免过度操作导致账号风险。
- 本项目仅供学习和研究目的,开发者不对不当使用承担任何责任。
信息
分类
通信与社交