AI导哈

小红书自动发布工具

一个通过Playwright浏览器自动化实现AI代理自动发布小红书笔记的MCP服务器。

  • by FrancoSbaffi
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 francosbaffi/xhs-mcp

使用说明

xhs-mcp🍠

一个MCP服务器，让你的AI代理向小红书发布笔记（RedNote/小红书) 自动使用Playwright浏览器自动化。

特性

  • 📸 发布带有标题、正文和图像的照片注释
  • 🤖 MCP兼容——与Claude、Cursor和任何MCP支持的代理兼容
  • 🔐 会话持久性——登录一次，永久发布
  • 🧠 类人打字以避免机器人检测

需求

  • Python 3.10+
  • macOS（使用Apple Silicon在macOS上测试）

安装

1.克隆仓库

git clone https://github.com/FrancoSbaffi/xhs-mcp.git
cd xhs-mcp

2.安装依赖项

pip install -r requirements.txt

3.安装Chromium

python -m playwright install chromium

4.设置会话（仅限第一次）

运行登录脚本，并在打开的浏览器中手动登录：

python post.py

登录后，在终端中按ENTER键。您的会话将保存到 session/auth.json.

用法

选项A——独立运行

编辑 content/texto.txt 用你的帖子内容（第一行=标题，其余=正文）。 将您的图像添加为 content/imagen.jpg。然后运行：

python post.py

选项B——与Claude一起用作MCP服务器

将此添加到您的Claude MCP配置中(claude_desktop_config.json):

{
  "mcpServers": {
    "xiaohongshu": {
      "command": "python3.11",
      "args": ["/absolute/path/to/xhs-mcp/server.py"]
    }
  }
}

然后在克劳德，你可以说：

“将此帖子发布到我的小红书上：标题为‘Hello World’，正文为‘这是我的第一个自动帖子’，图片位于/path/to/image.jpg”

MCP工具参考

post_note

参数 类型 说明
title string 帖子标题（最多20个字符）
body string 发布正文
image_path string 图像的绝对路径（jpg/png）

项目结构

xhs-mcp/
├── post.py          # Standalone posting script
├── server.py        # MCP server
├── requirements.txt # Dependencies
├── content/         # Default content folder
│   ├── texto.txt    # Post text (title on first line)
│   └── imagen.jpg   # Post image
└── session/         # Saved login session (git ignored)
    └── auth.json

重要说明

  • ⚠️ 该项目使用浏览器自动化，与小红书无关
  • ⚠️ 负责任地使用——避免频繁发布
  • ⚠️ 会话可能会过期，需要重新登录
  • 🔒 永不承诺 session/auth.json 到GitHub——它包含您的登录凭据

微笑。

在按下之前，请确保添加以下内容：

session/
.env

许可证

麻省理工学院

相关 MCP