🧩 Java Xiaohongshu MCP

Java 实现的小红书 Model Context Protocol (MCP) 工具服务

为 AI Agent / MCP Client 提供标准化接口，实现： 登录、发图文、搜索、评论、推荐内容、用户主页 等核心功能。

---

---

🌟 项目简介

Java Xiaohongshu MCP 是一个基于 Spring Boot + Playwright + MCP 协议 的小红书自动化工具服务，
通过标准化接口封装，实现对小红书常用操作的自动化调用与 AI 集成。

适用于：

• 🤖 AI Agent 工具调用（如 MCP Inspector、LangChain、Spring AI、n8n）
• 🧩 自动化内容发布 / 采集

---

🧱 功能特性

功能	描述
🪪 登录与状态检测	自动化登录与 Cookie 管理，支持状态检测
🖼️ 发布图文内容	支持标题、描述、多图（URL / 本地路径）
🎬️ 发布视频内容	支持标题、描述、本地视频
🔍 搜索内容	根据关键词搜索帖子，支持分页
🏠 获取推荐列表	模拟首页推荐内容
📄 获取帖子详情	获取帖子+互动数据+评论+子评论
💬 自动评论	支持自动发表评论
👤 用户主页信息	获取用户资料及笔记内容

---

⚙️ 技术栈

技术	用途
Java 21	主语言
Spring Boot 3.x	Web 框架
Playwright Java	浏览器自动化
MCP Protocol	AI Agent 接口协议

---

🚀 启动方式

✅ 方式一：直接运行 JAR（CLI 模式）

通过 LoginCli 类快速启动并登录小红书。

# 构建项目
mvn clean package -DskipTests

# 启动 CLI 登录工具
java -cp target/app.jar -Dloader.main=com.lv.xhsmcp.login.LoginCli org.springframework.boot.loader.launch.PropertiesLauncher

CLI 模式适合快速验证或单机自动化任务。

---

🐳 方式二：Docker 运行

项目支持容器化部署，可在任意环境中运行。

# 构建镜像
docker buildx build -t java-xhs-mcp:latest .

# 启动容器
docker run --rm -e PLAYWRIGHT_BROWSERS_PATH=/ms-playwright -v pw-browsers:/ms-playwright java-xhs-mcp:latest /bin/bash

启动后访问：
👉 http://127.0.0.1:8081/mcp

---

🧠 MCP 集成示例

{
  "mcp_server": {
    "name": "xiaohongshu-mcp",
    "url": "http://localhost:8080/mcp",
    "transport": "streamable-http"
  }
}

---

⚠️ 注意事项

• 登录与发帖均依赖有效的 Cookie / 登录态。
• 评论与发帖功能需要合法的 xsec_token 参数。
• 项目仅供学习用途，严禁用于商业爬取、滥用或违反平台政策的行为。

---

📬 联系方式

如需交流或问题反馈，请通过以下方式：

• GitHub Issues: 提交问题
• 邮箱: hack-bzlrj@163.com
• 微信(交流、交朋友、共同进步)：

> ⚠️ 请勿用于广告、推广或商业用途 --- ## 🧾 License

本项目基于 MIT License 进行开源。
© 2025 bzlrj. 保留所有权利。