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.0 xhs-server

方式 2: 配置文件运行

在配置文件中添加

{
  "mcpServers": {
    "xhs": {
      "command": "env",
      "args": [
        "DEEPSEEK_API_KEY=xxxx",
        "uvx",
        "--from",
        "lcl_xhs_mcp==0.4.0",
        "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.1.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.1-py3-none-any.whl (14.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: lcl_xhs_mcp-0.4.1.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.1.tar.gz
Algorithm Hash digest
SHA256 b2e620e6b8b9e73d5d79e41227b306e9e7af620a229a09afce5b0399797bc4f4
MD5 744bd6a5f3e012df07f199909e912c01
BLAKE2b-256 7a4f499caf374e4161b07f156dc5bb128dc4c6c8c16051deafc257927c946cb7

See more details on using hashes here.

File details

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

File metadata

  • Download URL: lcl_xhs_mcp-0.4.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2ebc4388d0320804d1c3461268b3fdf6a0455c4934829528d3024368f8a894ba
MD5 cc6432024aad54b8ba0b7d08546a2302
BLAKE2b-256 2651158c5d70251a72d6940109b8e0847c34a399d6711cf05700c8b8c460f752

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