Xiaohongshu MCP Server is a social media automation toolkit that enables AI-powered content management for the Xiaohongshu (Little Red Book) platform through the Model Context Protocol. Key features: - Secure cookie-based authentication and login credential management - Automated publishing of image/text posts and video notes with topic tags - Data collection from creator dashboard including follower metrics, engagement analytics, and content performance statistics - Scheduled automated data scraping using cron expressions - AI-friendly data formatting with Chinese headers for direct analysis by AI agents - Local CSV data storage for performance tracking - Seamless integration with Claude Desktop, Cherry Studio, and other MCP-compatible AI clients - Support for both local Chrome automation and remote browser deployment via Selenium/WebDriver

📕 小红书创作者MCP工具包

[](LICENSE) []((https://kayin-1253854796.cos.ap-shanghai.myqcloud.com/ownmedia/20250622023225261.jpg?imageSlim))

一个强大的小红书自动化工具包，支持通过MCP协议与AI客户端（如Claude Desktop等）集成，实现与AI对话即可进行内容创作、发布及创作者数据分析。

✨ 主要特性

📋 功能清单

登录

内容发布

数据采集

📋 环境要求

🌐 浏览器环境

🔍 查看Chrome版本

📥 ChromeDriver安装方式

#### 方法一：自动下载（推荐）

# 使用webdriver-manager自动管理
pip install webdriver-manager

#### 方法二：手动下载 1. 📋 访问官方下载页面：Chrome for Testing 2. 🎯 选择与您Chrome版本完全匹配的ChromeDriver 3. 📁 下载后解压到合适位置（如 /usr/local/bin/ 或 C:\tools\） 4. ⚙️ 在 .env 文件中配置正确路径

#### 方法三：包管理器安装

# macOS (Homebrew)
brew install --cask chromedriver
Windows (Chocolatey)  
choco install chromedriver
Linux (Ubuntu/Debian)
sudo apt-get install chromium-chromedriver

> ⚠️ 重要提示：版本不匹配是最常见的问题原因，请确保ChromeDriver版本与Chrome浏览器版本完全一致！

🌐 远程浏览器连接

支持连接到已运行的远程Chrome实例，提高性能和支持远程部署场景。

#### 🔧 配置方法

在 .env 文件中添加以下配置：

# 启用远程浏览器连接
ENABLE_REMOTE_BROWSER=true
REMOTE_BROWSER_HOST=http://xx.xx.xx.xx
REMOTE_BROWSER_PORT=xxxx

#### 🚀 启动远程Chrome

version: '3.8'
services:
  selenium-chrome:
    image: selenium/standalone-chrome:latest
    container_name: selenium-chrome
    ports:
      - "54444:4444"
      - "57900:7900"
    shm_size: 2g
    environment:
      - SE_VNC_NO_PASSWORD=1
    volumes:
      - ./chrome-data:/home/seluser  # 更换挂载路径，确保权限
    restart: unless-stopped
    command: >
      bash -c "mkdir -p /home/seluser/.config/google-chrome &&
              touch /home/seluser/.config/google-chrome/test.txt &&
              /opt/bin/entry_point.sh"

#### 💡 使用场景

#### ⚠️ 注意事项

🚀 快速开始

💡 极简使用方式

# 克隆项目
git clone https://github.com/aki66938/xhs-toolkit.git
cd xhs-toolkit
运行（会自动安装依赖）
./xhs              # Mac/Linux
xhs.bat            # Windows
或使用 Python
python install_deps.py  # 安装依赖向导
./xhs                   # 启动程序

🎮 交互式菜单

运行 ./xhs 后会显示友好的菜单界面：

╭─────────────────────────────────────────╮
│         小红书MCP工具包 v1.3.0           │
│           快速操作菜单系统                │
╰─────────────────────────────────────────╯
【主菜单】
1. 🔄 数据收集
2. 🌐 浏览器操作
3. 📊 数据管理
4. 🍪 Cookie管理
5. 🚀 MCP服务器
6. ⚙️  系统工具
0. 退出

🛠️ 从源码运行

#### 方法一：uv (推荐 ⚡)

# 克隆项目
git clone https://github.com/aki66938/xhs-toolkit.git
cd xhs-toolkit
使用uv安装依赖并运行
uv sync
uv run python xhs_toolkit.py status  ## 验证工具是否可用

> 💡 uv使用提示：文档中所有 python 命令都可以用 uv run python 替代，享受更快的依赖管理体验！

#### 方法二：pip (传统方式)

# 克隆项目
git clone https://github.com/aki66938/xhs-toolkit.git
cd xhs-toolkit
创建虚拟环境（推荐）
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
安装依赖
pip install -r requirements.txt
python xhs_toolkit.py status  ## 验证工具是否可用

🛠️ 使用指南

1. 创建配置文件

复制并编辑配置文件：

cp env_example .env
vim .env  # 编辑配置

必需配置：

# Chrome浏览器路径
CHROME_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
ChromeDriver路径  
WEBDRIVER_CHROME_DRIVER="/opt/homebrew/bin/chromedriver"

2. 获取登录凭证

# 方式一：使用交互式菜单
./xhs
选择 4 -> Cookie管理 -> 1 -> 获取新的Cookies
方式二：直接命令
./xhs cookie save

在弹出的浏览器中, 如果是连接的远程浏览器，可以访问 http://ip:57900 访问vnc界面，然后执行下面的步骤： 1. 登录小红书创作者中心 2. 确保能正常访问创作者中心功能 3. 完成后按回车键保存

3. 启动MCP服务器

```bash

方式一：使用交互式菜单

选择 5 -> MCP服务器 -> 1 -> 启动服务器

方式二：直接命