小红书 MCP 服务器

基于模型上下文协议（MCP）的小红书自动化服务器，通过Selenium网页自动化技术实现与小红书平台的交互。该服务器提供搜索文章、查看内容、阅读评论和发表评论等功能。 可以帮助你完成一些小红书引流、爆款文章分析、评论舆论分析等功能，喜欢的可以给这个项目点个Star，或者提交PR增加新的功能

功能特性

• 🔐 自动登录管理：持久化会话存储，保存登录状态
• 🔍 文章搜索：根据关键词搜索相关文章
• 📖 内容查看：阅读文章内容和评论
• 💬 评论互动：在文章下发表评论
• 🗂️ 会话持久化：自动保存和加载登录状态
• 🌐 网页自动化：基于 Selenium 的浏览器自动化

后续开发计划

• 实现发送笔记功能
• 实现笔记收藏、点赞功能
• 实现关注功能

环境要求

• Python 3.8+
• Chrome 浏览器
• ChromeDriver 驱动

安装步骤

1. 克隆项目：

   git clone git@github.com:cjpnice/xiaohongshu_mcp.git
   

2. 下载 ChromeDriver并解压：

   • 从官方网站下载与本地Chrome版本对应的 ChromeDriver
   • 解压到项目根目录

3. 安装Python环境：

   • 创建虚拟环境,推荐使用uv进行管理，并安装依赖

   cd xiaohongshu_mcp
   uv python pin 3.12
   uv init --bare
   uv venv
   .venv\Scripts\activate # windows激活环境方式
   source .venv/bin/activate # MaxOS/Linux激活环境方式
   uv pip install -r requirements.txt
   

使用说明

MCP Server 配置

CHROME_DRIVER_PATH设置为ChromeDriver可执行文件的位置

{
  "mcpServers": {
    "xiaohongshu_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/PATH/TO/PARENT/FOLDER/xiaohongshu_mcp",
        "run",
        "mcp_server.py"
      ],
      "env": {
        "CHROME_DRIVER_PATH": "/PATH/TO/PARENT/FOLDER/chromedriver/chromedriver.exe"
      }
    }
  }
}

服务器默认使用 stdio 传输协议运行。

可用工具

1. login()

启动小红书手动登录流程。打开浏览器并等待用户完成登录。

返回值：

• success：布尔值，表示登录是否成功
• message：状态消息

2. search_articles(keyword: str)

根据关键词搜索文章。

参数：

• keyword：搜索关键词

返回值：

• success：布尔值，表示操作是否成功
• keyword：使用的搜索关键词
• articles：文章对象列表，包含：
  • title：文章标题
  • author：作者姓名
  • link：文章链接
  • like：点赞数
• count：找到的文章数量

3. get_current_page_articles()

获取当前页面的文章列表。可配合页面滚动功能使用。

返回值：

• 与 search_articles 格式相同

4. get_article_content(article_url: str)

获取指定文章的内容。

参数：

• article_url：文章链接

返回值：

• success：布尔值，表示操作是否成功
• content：文章文本内容

5. view_article_comments(article_url: str, limit: int = 20)

获取文章的评论列表。

参数：

• article_url：文章链接
• limit：获取评论的最大数量（默认：20）

返回值：

• success：布尔值，表示操作是否成功
• article_url：文章链接
• comments：评论对象列表，包含：
  • username：评论者用户名
  • content：评论内容
• count：获取的评论数量

6. post_comment(article_url: str, comment_text: str)

在文章下发表评论。

参数：

• article_url：文章链接
• comment_text：评论内容

返回值：

• success：布尔值，表示操作是否成功
• message：状态消息
• comment：发表的评论内容

7. scroll()

滚动当前页面以加载更多内容。

返回值：

• success：布尔值，表示操作是否成功
• message：状态消息

8. close_browser()

关闭浏览器实例。

返回值：

• success：布尔值，表示操作是否成功
• message：状态消息

重要提醒

1. 需要手动登录：首次运行服务器时，需要在打开的浏览器窗口中手动完成登录过程。

2. 注意频率限制：请注意小红书的频率限制，服务器在操作间包含合理的延迟。

3. 会话持久化：登录会话会在本地保存，后续运行时会自动恢复。

技术支持

如遇问题，请：

1. 查看故障排除部分
2. 检查环境配置
3. 在 GitHub 提交 Issue

注意：请负责任地使用本工具，遵守平台规则和相关法律法规。