xhs-mcp

一款针对小红书的MCP服务器，支持账户登录、文本生成以及通过对话自动发布。与现有实现相比，其优势在于能够在对话过程中自动登录账户并发布文案，并支持多个账户批量发布文案。此外，在调用发布文章接口时，该工具还支持根据文案内容自动生成小红书风格的图片。

原理

通过浏览器模拟，利用Chrome驱动程序启动浏览器以自动登录账户（向手机发送验证码）并发布文案。登录后，会保存cookie，发布文章后无需再次登录。该项目集成了webdriver管理器，无需手动下载和配置Chrome驱动程序。只需下载并安装Chrome浏览器主体（下载链接：https://www.google.com/intl/zh-CN/chrome/ ）。

示例

<img src="https://gips3.baidu.com/it/u=3528502322,2019738985&fm=3081&app=3081&f=PNG?w=1036&h=1140" alt="Snipaste_2025-06-04_17-40-50" width="50%">

环境配置

1. 确保系统已安装Chrome浏览器（项目将自动管理相应的驱动程序，无需手动下载驱动程序，只需手动下载并安装浏览器主体），下载地址（https://www.google.com/intl/zh-CN/chrome/ ）
2. 安装UV

pip install uv # 注意，如果使用anaconda进行环境管理，需要在base环境中pip

启动服务器

发布图片和文本时，必须先有配套的图片才能发布。因此，在调用文案工具时，它将基于文案自动生成小红书风格的图片。在生成迷你图时，使用了DeepSeek的聊天模型，因此需要配置DEEPSEEK_API_KEY环境变量。如果需要切换到其他模型，请配置BASE-URL环境变量，默认为DEEPSEEK的地址。

方法1：直接运行命令

env DEEPSEEK_API_KEY=xxxx uvx --from lcl_xhs_mcp@latest xhs-server

如果切换模型：

env DEEPSEEK_API_KEY=xxxx BASE_URL=xxxx uvx --from lcl_xhs_mcp@latest xhs-server

为了避免冗余，以下介绍中将省略BASE-URL环境变量的配置。

方法2：运行配置文件

添加到配置文件

{
  "mcpServers": {
    "xhs": {
      "command": "env",
      "args": [
        "DEEPSEEK_API_KEY=xxxx",
        "uvx",
        "--from",
        "lcl_xhs_mcp@latest",
        "xhs-server"
      ]
    }
  }
}

方法3：安装并运行源代码

此方法可以获取最新代码。

git clone https://github.com/SoftEgLi/xhs-mcp.git
cd xhs-mcp
pip install -e . # 注意，如果安装了anaconda，需要在base环境中进行pip

MCP配置文件：

{
  "mcpServers": {
    "xhs-test": {
      "command": "xhs-server",
      "args": [],
      "env": {
        "DEEPSEEK_API_KEY": "xxxx"
      }
    }
  }
}

注意事项

Cookie的有效期为一个月。如果您自己在网页上登录小红书，之前的cookie可能会过期。过期后，发布文章时将再次经历MCP登录过程。

开源许可协议

使用MIT协议。