Skip to main content

A Model Context Protocol (MCP) server for Xiaohongshu (Little Red Book) automation

Project description

xhs-mcp

一个小红书的 MCP 服务器,支持通过对话的方式进行账号登陆、文案生成、以及自动发布。相比于已有的实现,优势在于登陆账号以及文案发布全部可以在对话过程中自动实现,并能支持多个账号批量发布文案。此外,在调用发表文章的接口时,该工具还支持自动根据文案内容生成小红书配图。

原理

使用浏览器模拟的方式,通过 Chrome 驱动启动浏览器,来自动进行账号登录(会发送验证码到手机上),以及发布文案。登录后,会将 Cookie 保存下来,之后发布文章就不再需要重新登录了。项目已集成 webdriver-manager,无需手动下载和配置 Chrome 驱动,只需下载 Chrome 浏览器本体即可(下载地址:https://www.google.com/intl/zh-CN/chrome/)。

示例

Snipaste_2025-06-04_17-40-50

环境配置

  1. 确保系统已安装 Chrome 浏览器(项目会自动管理对应的驱动程序,不需要手动下载驱动程序,只要手动下载浏览器本体即可),下载地址(https://www.google.com/intl/zh-CN/chrome/)
  2. 安装 uv
pip install uv

启动服务器

在发布图文时,必须有一张配图才可以发布。所以在调用发布文案工具时会自动根据文案生成一张小红书风格的配图。在生成小配图时,用到了 DeepSeek 的 chat 模型,所以需要配置 DEEPSEEK_API_KEY 这个环境变量。

方式 1:直接运行命令

env DEEPSEEK_API_KEY=xxxx uvx --from lcl_xhs_mcp==0.4.1 xhs-server

方式 2: 配置文件运行

在配置文件中添加

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

注意事项

Cookie 的有效期是一个月,如果你自己在网页上登录了小红书,那么之前的 Cookie 有可能会失效,失效后在发布文章时,会重新走一遍 MCP 的登录流程。

开源协议

使用 MIT 协议。

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lcl_xhs_mcp-0.4.2.tar.gz (13.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

lcl_xhs_mcp-0.4.2-py3-none-any.whl (14.9 kB view details)

Uploaded Python 3

File details

Details for the file lcl_xhs_mcp-0.4.2.tar.gz.

File metadata

  • Download URL: lcl_xhs_mcp-0.4.2.tar.gz
  • Upload date:
  • Size: 13.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.7

File hashes

Hashes for lcl_xhs_mcp-0.4.2.tar.gz
Algorithm Hash digest
SHA256 cc5ebb79eacca382b5c86c6f6d278f9ecceae5633cbb2575f364b25c10b3de58
MD5 9182fb4af14856b7741bf1c1d1a77c52
BLAKE2b-256 54470a92a8ae487214dec61c14ede2913b4b6476c3aabb985e15db381db99c2e

See more details on using hashes here.

File details

Details for the file lcl_xhs_mcp-0.4.2-py3-none-any.whl.

File metadata

  • Download URL: lcl_xhs_mcp-0.4.2-py3-none-any.whl
  • Upload date:
  • Size: 14.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.7

File hashes

Hashes for lcl_xhs_mcp-0.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 ec2938092f8b21c78cf2c226160718556a144f1c2460f85294233ec955866fae
MD5 12991ccd25cb130f918842bc36e00081
BLAKE2b-256 2ef773d45892e0e5232223c3eda457804e0cd6a5e6be0c5117142f48fa0ba645

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page