Xhs Light

一个文件。四个工具。让你的 AI 直接发小红书。

Python MCP License Stars

中文 MCP 生态最轻量的小红书发布工具 — 200 行代码，不依赖重型框架，Claude / Cursor / Copilot 直接操控小红书。

---

这是什么

一个 单文件（server.py）的 Model Context Protocol (MCP) Server，让你的 AI 助手直接发小红书：

• ✅ 扫码一次，长期免登（Chrome profile 持久化）
• ✅ 发布图文笔记：标题 + 正文 + 多图（最多 9 张）+ 话题标签
• ✅ 搜索笔记
• ✅ 检查登录状态

竞品对比：

	xhs-mcp-light (本项目)	luyike221/xiaohongshu-mcp-python
文件数	1	~10,000
子项目	0	6
核心依赖	4	30+
安装到跑通	3 分钟	30 分钟+
MCP 传输	stdio（Claude Code 原生）	HTTP（需额外起服务）

---

5 分钟上手

1. 安装

# 安装 uv（如果没有）
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# 克隆项目
git clone https://github.com/luyike221/xhs-mcp-light.git
cd xhs-mcp-light

# 安装依赖（3 个包）
uv sync

# 安装 Chromium 浏览器（首次，约 150MB）
uv run playwright install chromium

2. 接入 Claude Code

在 Claude Code 设置文件（~/.claude/settings.json）中添加：

{
  "mcpServers": {
    "xhs-publisher": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "D:/Claudecoda学习/xhs-mcp-light"
    }
  }
}

其他 AI 工具（Cursor、Copilot、Codex）的配置见 MCP 官方文档。

3. 扫码登录

重启 Claude Code，然后说：

"帮我登录小红书"

Claude 会调用 xhs_login → 弹出浏览器窗口 → 用小红书 App 扫码 → 完成。一次扫码，永久有效。

4. 发布第一篇笔记

"帮我发一篇小红书：标题'我的 AI 帮我发了这篇笔记'，内容写……，图片用桌面上的 test.jpg"

---

四个工具

工具	说明	必填参数
xhs_login	打开浏览器扫码登录	无
xhs_check_login	检查登录状态	无
xhs_publish_note	发布图文笔记	title, content, images
xhs_search_feeds	搜索笔记	keyword

---

使用示例

自然语言（推荐）

"发一篇小红书：标题'成都周末探店'，正文分享一家藏在巷子里的咖啡馆，图片用桌面的 cafe1.jpg、cafe2.jpg，标签加 成都探店、咖啡馆、周末去哪"

Claude 自动翻译成工具调用，完成发布。

直接调用

xhs_publish_note(
  title="成都周末探店",
  content="藏在巷子里的惊喜...",
  images=["C:/Users/xxx/Desktop/cafe1.jpg", "C:/Users/xxx/Desktop/cafe2.jpg"],
  tags=["成都探店", "咖啡馆", "周末去哪"]
)

---

原理

Claude Code ──MCP stdio──▶ server.py ──Playwright──▶ Chrome ──▶ 小红书网页版
                                                          │
                                                    登录态保存在
                                                    xhs-browser-data/

• 不碰小红书 API（不逆向、不抓包）——模拟真人操作浏览器
• Playwright persistent context 保存 Chrome profile——一次扫码，长期免登
• stdio 传输——不需要起 HTTP 服务，Claude Code 直接启动子进程

---

文件结构

xhs-mcp-light/
├── server.py          # 全部代码（233 行）
├── pyproject.toml     # 依赖声明
├── .env.example       # 配置模板
├── xhs-browser-data/  # Chrome profile（自动生成，含登录态）
├── assets/            # 图片资源
└── README.md

---

常见问题

Q: 会被封号吗？ A: 本项目模拟真人浏览器操作（有 UI 交互、有随机延迟），发布频率正常就不会。禁止用于批量灌水、刷量、违规营销。

Q: 支持视频吗？ A: V1.0 图文优先。视频、定时发布、草稿箱管理在 Roadmap 中。

Q: Windows 图片路径怎么写？ A: 用正斜杠："C:/Users/xxx/Pictures/a.jpg"，或双反斜杠。不要用单反斜杠（JSON 会把它当转义符）。

Q: Mac / Linux 能用吗？ A: 可以。安装方式一致，路径用 Unix 格式即可。

Q: 一个账号能发多少？ A: 小红书日发上限约 10-15 篇。正常使用不受影响。

---

Roadmap

• 视频发布
• 定时发布
• 草稿箱管理
• 数据看板（阅读/点赞/评论）
• 多账号管理

---

赞助

如果这个项目对你有用，请我喝杯咖啡 ☕

---

商业合作

企业批量发布 · 多平台适配（小红书/抖音/闲鱼/公众号）· 私有化部署 · 定制开发

📧 微信：见赞助码备注 | 📧 Email：[email protected]

已有客户案例：跨境电商批量种草、MCN 机构多账号分发、个人博主自动化运营。欢迎咨询。

---

Star 历史

如果这个项目对你有帮助，点个 ⭐ Star 让更多人看到。每个 Star 都是对中文 MCP 生态的一票。

---

Made with ❤️ by MangoOS × 第三自习室 · 2026