使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现,专注于小红书平台的内容互动。它通过模拟用户在小红书平台的操作,提供了一系列工具,如关键词搜索笔记、获取笔记内容、获取笔记评论以及发布智能评论等功能。您可以将此MCP服务器配置到支持MCP协议的客户端(如 Claude for Desktop)中,从而通过自然语言指令,让大语言模型(LLM)驱动此服务器完成在小红书平台上的自动化任务,例如信息收集、内容互动和营销推广等。

主要功能点

  • 自动登录: 支持扫码登录小红书账号,并保持登录状态,简化操作流程。
  • 关键词搜索: 根据关键词在小红书平台搜索相关笔记,并可指定返回结果数量。
  • 笔记内容获取: 通过笔记URL获取完整的笔记内容,包括标题、作者、发布时间及正文。
  • 笔记评论获取: 通过笔记URL获取笔记下的评论信息,了解用户互动情况。
  • 智能评论发布: 支持多种评论类型(引流、点赞、咨询、专业),根据笔记内容和预设类型智能生成并发布评论,实现互动营销。

安装步骤

  1. 安装 Python: 确保您的系统已安装 Python 3.8 或更高版本。
  2. 下载项目: 从 GitHub 仓库下载或克隆本项目到本地。
  3. 创建并激活虚拟环境:
    # 创建虚拟环境
    python3 -m venv venv
    # 激活虚拟环境 (根据您的操作系统选择命令)
    # Windows: venv\Scripts\activate
    # macOS/Linux: source venv/bin/activate
  4. 安装依赖: 在激活的虚拟环境中,运行以下命令安装项目依赖和 fastmcp 库:
    pip install -r requirements.txt
    pip install fastmcp
  5. 安装浏览器: 安装 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 默认支持的协议,并且与配置示例代码一致。

基本使用方法

  1. 启动服务器:

    • 方法一:直接运行 - 在项目目录下,激活虚拟环境后,执行命令 'python3 xiaohongshu_mcp.py' 或 'python xiaohongshu_mcp.py' (取决于您的系统环境)。
    • 方法二:通过 MCP 客户端启动 - 在 MCP 客户端中配置好服务器信息后,按照客户端的操作流程启动和连接服务器。
  2. 在 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'。
      • 评论类型可选值: '"引流"', '"点赞"', '"咨询"', '"专业"'。 默认为 '"引流"'。

注意: 请务必遵守小红书平台的使用规范,合理使用工具,避免账号风险。

信息

分类

通信与社交