使用说明
项目简介
本项目是一个基于 Model Context Protocol (MCP) 的服务器实现,专注于小红书平台的内容互动。它通过模拟用户在小红书平台的操作,提供了一系列工具,如关键词搜索笔记、获取笔记内容、获取笔记评论以及发布智能评论等功能。您可以将此MCP服务器配置到支持MCP协议的客户端(如 Claude for Desktop)中,从而通过自然语言指令,让大语言模型(LLM)驱动此服务器完成在小红书平台上的自动化任务,例如信息收集、内容互动和营销推广等。
主要功能点
- 自动登录: 支持扫码登录小红书账号,并保持登录状态,简化操作流程。
- 关键词搜索: 根据关键词在小红书平台搜索相关笔记,并可指定返回结果数量。
- 笔记内容获取: 通过笔记URL获取完整的笔记内容,包括标题、作者、发布时间及正文。
- 笔记评论获取: 通过笔记URL获取笔记下的评论信息,了解用户互动情况。
- 智能评论发布: 支持多种评论类型(引流、点赞、咨询、专业),根据笔记内容和预设类型智能生成并发布评论,实现互动营销。
安装步骤
- 安装 Python: 确保您的系统已安装 Python 3.8 或更高版本。
- 下载项目: 从 GitHub 仓库下载或克隆本项目到本地。
- 创建并激活虚拟环境:
# 创建虚拟环境 python3 -m venv venv # 激活虚拟环境 (根据您的操作系统选择命令) # Windows: venv\Scripts\activate # macOS/Linux: source venv/bin/activate - 安装依赖: 在激活的虚拟环境中,运行以下命令安装项目依赖和 fastmcp 库:
pip install -r requirements.txt pip install fastmcp - 安装浏览器: 安装 Playwright 所需的浏览器,用于驱动自动化操作:
playwright install
服务器配置
要将此工具配置为 MCP 服务器,您需要在 MCP 客户端(如 Claude for Desktop)的配置文件中添加以下 JSON 配置。请根据您的实际项目路径进行修改:
{ "mcpServers": { "xiaohongshu MCP": { "command": "/绝对路径/到/venv/bin/python3", // 替换为您的虚拟环境 Python 解释器绝对路径 "args": [ "/绝对路径/到/xiaohongshu_mcp.py", // 替换为 xiaohongshu_mcp.py 文件的绝对路径 "--stdio" ] } } }
配置参数说明:
- '"xiaohongshu MCP"': MCP 服务器的名称,您可以自定义。
- '"command"': 必须使用您在步骤3创建的虚拟环境中的 Python 解释器的绝对路径。例如:'/Users/your_username/RedBook-Search-Comment-MCP/venv/bin/python3' 或 'C:\path\to\RedBook-Search-Comment-MCP\venv\Scripts\python.exe'。
- '"args"': 启动服务器的参数列表。
- '"xiaohongshu_mcp.py"': 必须使用 'xiaohongshu_mcp.py' 文件的绝对路径。例如:'/Users/your_username/RedBook-Search-Comment-MCP/xiaohongshu_mcp.py' 或 'C:\path\to\RedBook-Search-Comment-MCP\xiaohongshu_mcp.py'。
- '"--stdio"': 指定 MCP 服务器使用 'stdio' 作为传输协议,这是 fastmcp 默认支持的协议,并且与配置示例代码一致。
基本使用方法
-
启动服务器:
- 方法一:直接运行 - 在项目目录下,激活虚拟环境后,执行命令 'python3 xiaohongshu_mcp.py' 或 'python xiaohongshu_mcp.py' (取决于您的系统环境)。
- 方法二:通过 MCP 客户端启动 - 在 MCP 客户端中配置好服务器信息后,按照客户端的操作流程启动和连接服务器。
-
在 MCP 客户端中使用工具: 成功连接服务器后,您可以在 MCP 客户端中通过自然语言指令调用以下工具函数,与小红书平台进行交互:
-
登录小红书:
- 工具函数: 'mcp0_login()'
- 使用示例: 在客户端中发送 '帮我登录小红书账号' 或 '请登录小红书'。首次使用需手动扫码登录,之后会自动保持登录状态。
-
搜索笔记:
- 工具函数: 'mcp0_search_notes(keywords="关键词", limit=数量)'
- 使用示例: '帮我搜索小红书笔记,关键词为:美食' 或 '帮我搜索小红书笔记,关键词为旅游,返回10条结果'。
-
获取笔记内容:
- 工具函数: 'mcp0_get_note_content(url="笔记URL")'
- 使用示例: '帮我获取这个笔记的内容:https://www.xiaohongshu.com/note/xxxx' 或 '请查看这个小红书笔记的内容:https://www.xiaohongshu.com/note/xxxx'。
-
获取笔记评论:
- 工具函数: 'mcp0_get_note_comments(url="笔记URL")'
- 使用示例: '帮我获取这个笔记的评论:https://www.xiaohongshu.com/note/xxxx' 或 '请查看这个小红书笔记的评论区:https://www.xiaohongshu.com/note/xxxx'。
-
发布智能评论:
- 工具函数: 'mcp0_post_smart_comment(url="笔记URL", comment_type="评论类型")'
- 使用示例: '帮我在这篇笔记下发布引流评论:https://www.xiaohongshu.com/note/xxxx' 或 '请在这个小红书笔记下发布一条专业评论:https://www.xiaohongshu.com/note/xxxx'。
- 评论类型可选值: '"引流"', '"点赞"', '"咨询"', '"专业"'。 默认为 '"引流"'。
-
注意: 请务必遵守小红书平台的使用规范,合理使用工具,避免账号风险。
信息
分类
通信与社交