📦

Xhs MCP

用于小红书（xiaohongshu.com）的 Model Context Protocol（MCP）服务器与 CLI 工具，支持登录、发布、搜索、推荐等自动化能力

0 installs

8 stars

2 forks

Trust: 59 — Fair

Devtools

Installation

npx xhs-mcp

Ask AI about Xhs MCP

I know everything about Xhs MCP. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

小红书 MCP 服务器

中文 | English

小红书 Model Context Protocol (MCP) 服务器，让 AI 助手能够搜索、浏览、发布和互动小红书内容。

完整文档 · 问题反馈

功能概览

多账号管理

账号池管理，支持同时登录多个账号。会话持久化存储，重启后无需重新登录。内置并发保护，防止同一账号同时操作冲突。

工具	说明
`xhs_add_account`	开始登录流程，返回二维码 URL
`xhs_check_login_session`	检查登录状态（扫码后调用）
`xhs_submit_verification`	提交短信验证码
`xhs_list_accounts`	列出所有账号及状态
`xhs_check_auth_status`	检查账号是否已登录
`xhs_remove_account`	删除账号
`xhs_set_account_config`	修改账号配置（名称、代理、状态）
`xhs_get_account_prompt`	获取账号 Prompt（人设/选择/评论）
`xhs_set_account_prompt`	更新账号 Prompt
`xhs_delete_cookies`	清除账号会话

内容查询

关键词搜索，支持多种排序和筛选条件。获取笔记详情，包括图片、评论、互动数据。查看用户资料和发布的笔记列表。

工具	说明
`xhs_search`	搜索笔记，支持排序和筛选
`xhs_get_note`	获取笔记详情和评论
`xhs_user_profile`	获取用户资料和笔记列表
`xhs_list_feeds`	获取首页推荐

内容发布

发布图文/视频笔记，支持多图、话题标签、封面设置。支持定时发布和多账号批量发布。

工具	说明
`xhs_publish_content`	发布图文笔记
`xhs_publish_video`	发布视频笔记

互动功能

点赞、收藏、评论、回复，支持多账号批量互动。

工具	说明
`xhs_like_feed`	点赞/取消点赞笔记
`xhs_favorite_feed`	收藏/取消收藏笔记
`xhs_post_comment`	发表评论
`xhs_reply_comment`	回复评论
`xhs_like_comment`	点赞/取消点赞评论

AI 创作

AI 驱动的图片生成流程，从截图自动生成小红书风格配图（封面、标注截图、文字卡片）。草稿管理系统，保存和编辑创作内容。

工具	说明
`xhs_create_draft`	创建笔记草稿（AI 自动处理截图生成配图）
`xhs_list_drafts`	列出所有草稿
`xhs_get_draft`	获取草稿详情
`xhs_update_draft`	更新草稿内容
`xhs_delete_draft`	删除草稿
`xhs_publish_draft`	发布草稿到小红书

创作者工具

获取已发布笔记的数据统计（浏览、点赞、收藏、评论）。通知管理：评论提醒、点赞通知、新增关注。

工具	说明
`xhs_get_my_notes`	获取已发布笔记列表和数据
`xhs_query_my_notes`	查询已缓存的笔记（支持多条件筛选）
`xhs_get_notifications`	获取通知（评论、点赞、关注）

自动浏览

AI 驱动的探索页自动浏览，根据兴趣关键词智能选择笔记，智能决定点赞帖子或评论，概率控制的评论行为。

工具	说明
`xhs_explore`	AI 驱动的自动浏览探索页
`xhs_stop_explore`	停止正在运行的 explore 会话

数据统计

操作日志查询和成功率分析。

工具	说明
`xhs_get_account_stats`	获取账号操作统计
`xhs_get_operation_logs`	查询操作历史日志

下载

工具	说明
`xhs_download_images`	下载笔记图片
`xhs_download_video`	下载笔记视频

详细 API 文档请访问完整文档

快速开始

安装

Claude Code（推荐）

claude mcp add xhs -- npx -y @sillyl12324/xhs-mcp@latest

Claude Desktop

编辑配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "xhs": {
      "command": "npx",
      "args": ["-y", "@sillyl12324/xhs-mcp@latest"]
    }
  }
}

Cursor / Cline / 其他 MCP 客户端

在 MCP 设置中添加相同配置：

{
  "mcpServers": {
    "xhs": {
      "command": "npx",
      "args": ["-y", "@sillyl12324/xhs-mcp@latest"]
    }
  }
}

详细配置说明请查看安装文档

1. 调用 xhs_add_account() → 获取 sessionId 和二维码 URL
2. 扫描二维码（或访问返回的 qrCodeUrl）
3. 调用 xhs_check_login_session({ sessionId }) 检查状态
4. 如需短信验证，调用 xhs_submit_verification({ sessionId, code })
5. 完成！会话自动保存到本地数据库

多账号操作

所有操作工具都支持 account（单账号）或 accounts（多账号）参数：

// 单账号操作
xhs_search({ keyword: "美食", account: "主账号" })

// 指定多个账号同时操作
xhs_like_feed({ noteId: "xxx", xsecToken: "yyy", accounts: ["账号1", "账号2"] })

// 所有活跃账号同时操作
xhs_publish_content({ title: "...", content: "...", images: [...], accounts: "all" })

如果只有一个账号且未指定 account 参数，会自动使用该账号。

环境变量

变量	默认值	说明
`GEMINI_API_KEY`	-	Gemini API 密钥（AI 图片生成必需）
`GEMINI_IMAGE_GENERATE_MODEL`	`gemini-3-pro-image`	图片生成模型
`XHS_MCP_DATA_DIR`	`~/.xhs-mcp`	数据存储目录
`XHS_MCP_HEADLESS`	`true`	是否使用无头浏览器
`XHS_MCP_KEEP_OPEN`	`false`	操作完成后保持浏览器打开
`XHS_MCP_REQUEST_INTERVAL`	`2000`	请求间隔（毫秒）

数据存储

所有数据存储在 ~/.xhs-mcp/ 目录：

~/.xhs-mcp/
├── data.db              # SQLite 数据库（账号、会话、日志）
├── logs/
│   └── xhs-mcp.log      # 应用日志
└── downloads/
    ├── images/{noteId}/ # 下载的图片
    └── videos/{noteId}/ # 下载的视频

开发

git clone https://github.com/ShunL12324/xhs-mcp.git
cd xhs-mcp
bun install
bun run dev      # 开发模式（watch）
bun run build    # 构建

技术栈

运行时: Bun / Node.js
语言: TypeScript (ESNext, strict mode)
浏览器自动化: Playwright
数据库: SQLite (better-sqlite3)
MCP SDK: @modelcontextprotocol/sdk
AI: Google Gemini API

致谢

xpzouying/xiaohongshu-mcp - Go 语言实现，本项目的发布和互动功能参考了其优秀工作

Star History

许可证

MIT