🦀 Xiaohongshu MCP Skill

小红书 MCP 完整使用方案 - 基于 xpzouying/xiaohongshu-mcp

📋 目录

• 概述
• 特性
• 安装
• 快速开始
• 文件结构
• 常见问题
• 致谢

📖 概述

本 Skill 基于 xpzouying/xiaohongshu-mcp (8.4k+ stars) 构建，提供完整的小红书自动化解决方案。

核心功能：

• 🔐 登录管理（支持截图发送到飞书）
• 🔍 搜索内容
• 📄 获取笔记详情
• 📤 发布图文/视频
• 👥 互动操作（点赞、评论等）

引用来源：

• MCP 服务器: xpzouying/xiaohongshu-mcp
• 框架: OpenClaw

✨ 特性

• ✅ 登录修复 - 从探索页面点击登录按钮（小红书页面变更修复）
• ✅ 飞书集成 - 二维码自动发送到飞书
• ✅ 一键登录 - 自动化登录流程
• ✅ 完整功能 - 搜索、详情、推荐、发布
• ✅ Agent 友好 - 可被 OpenClaw 调用
• ✅ 跨平台 - macOS、Linux、Windows

🚀 安装

方式1：一键安装（推荐）

# 克隆本 Skill
git clone https://github.com/tclawde/xiaohongshu-mcp-skill.git
cd xiaohongshu-mcp-skill

# 运行安装脚本
bash install.sh

方式2：手动安装

# 1. 克隆本 Skill
git clone https://github.com/tclawde/xiaohongshu-mcp-skill.git ~/.openclaw/skills/xiaohongshu-mcp

# 2. 安装 MCP 服务器（二进制文件）
cd ~/.openclaw/skills/xiaohongshu-mcp
bash install.sh

# 3. 安装依赖
pip3 install requests playwright
playwright install chromium

📦 文件结构

xiaohongshu-mcp-skill/
├── SKILL.md              # 本文档
├── README.md             # 英文文档
├── SOP.md                # 详细使用指南
├── install.sh            # 安装脚本（下载 MCP 二进制）
├── xhs_login.sh          # 一键登录脚本
└── scripts/
    ├── xhs_client.py     # Python 客户端
    └── xhs_login_sop.py  # 登录 SOP（Playwright 自动化）

🚀 快速开始

1. 安装 MCP 服务器

cd ~/.openclaw/skills/xiaohongshu-mcp
bash install.sh

2. 登录

# 本地登录
bash xhs_login.sh

# 或登录并发送到飞书
bash xhs_login.sh --notify

3. 启动 MCP 服务器

cd ~/.openclaw/skills/xiaohongshu-mcp
./xiaohongshu-mcp-darwin-arm64 &

4. 使用

# 检查登录状态
python3 scripts/xhs_client.py status

# 搜索笔记
python3 scripts/xhs_client.py search "咖啡"

# 发布笔记
python3 scripts/xhs_client.py publish "标题" "内容" "图片URL"

📖 详细文档

• SOP.md - 完整使用指南和故障排查
• xpzouying/xiaohongshu-mcp - 官方 API 文档

❓ 常见问题

Q1: MCP 服务器从哪里下载？

# MCP 服务器由 install.sh 自动下载
# 手动下载：
curl -L -o xiaohongshu-mcp-darwin-arm64 \
  https://github.com/xpzouying/xiaohongshu-mcp/releases/download/v0.0.8/xiaohongshu-mcp-darwin-arm64

Q2: 登录失败？

# 小红书登录页面可能变更，使用修复版登录：
bash scripts/xhs_login.sh --notify

Q3: 如何重新登录？

# 1. 清除 cookies
rm ~/.openclaw/workspace/cookies.json

# 2. 重新登录
bash xhs_login.sh --notify

🙏 致谢

• xpzouying/xiaohongshu-mcp - MCP 服务器核心实现
• OpenClaw - AI Agent 框架

📝 更新日志

v1.4.0 (2026-02-11)

• ✅ 修复登录流程（小rednote 登录页面变更）
• ✅ 新增 Playwright 自动化登录 SOP
• ✅ 二维码自动发送到飞书
• ✅ MCP 二进制预集成

📄 许可证

MIT License

👨‍💻 作者

TClawDE 🦀

• GitHub: @tclawde

---

基于 xpzouying/xiaohongshu-mcp 构建