Which integrations are available for this server?

Automates content production, publishing, and engagement on Xiaohongshu (Little Red Book), including login, posting text/image/video, searching, liking, commenting, and data retrieval.

How do I use xhs-kit?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@xhs-kit search for hiking destinations" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

xhs-kit

by luweizheng

Overview Schema Source Related Servers Discussions Admin

Python

Local

xhs-kit

Python License

小红书自动化工具箱，覆盖内容生产、发布、运营全流程。基于 Playwright 浏览器自动化，支持 MCP 协议与 AI Agent 集成。

特性

🔐 扫码登录 - 支持二维码扫码登录，自动保存 cookies
📝 发布内容 - 支持发布图文、视频、文字配图，支持定时发布
🔍 搜索内容 - 支持关键词搜索（高级筛选能力在 MCP API 中提供）
❤️ 互动功能 - 支持点赞、收藏、评论、回复评论
📊 数据获取 - 获取首页推荐、笔记详情、用户主页，支持高级评论加载配置
🤖 MCP 协议 - 支持 MCP 协议，可与 AI 助手集成

Related MCP server: Xiaohongshu MCP Server

安装

pip install xhs-kit

# 首次运行需安装浏览器
playwright install chromium

快速开始

使用流程

首次使用必须先登录：运行 xhs-kit login-browser 弹出浏览器登录或 xhs-kit login-qrcode --terminal 在终端中显示二维码登录
检查登录状态：运行 xhs-kit status（输出 ✅ 已登录 或 ❌ 未登录）
执行操作：登录成功后即可使用各种功能
Cookies 有效期：约 7-30 天，过期后需重新登录

💡 MCP 使用提示：让 AI 助手先调用 check_login_status 检查登录状态，如果未登录：
通过 MCP：调用 login_with_browser
或直接在命令行执行：xhs-kit login-browser

MCP 客户端配置

Claude Desktop

编辑配置文件

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）
%APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "xiaohongshu": {
      "command": "xhs-kit",
      "args": ["serve"]
    }
  }
}

如果 xhs-kit 不在系统 PATH 中，使用完整路径：

{
  "mcpServers": {
    "xiaohongshu": {
      "command": "/path/to/your/python/bin/xhs-kit",
      "args": ["serve"]
    }
  }
}

可通过 which xhs-kit（macOS/Linux）或 where xhs-kit（Windows）查看完整路径。

配置完成后重启 Claude Desktop。

Claude Code

# 添加 MCP 服务
claude mcp add xhs-kit -- xhs-kit serve

# 查看已添加的 MCP
claude mcp list

# 移除 MCP 服务
claude mcp remove xhs-kit

Cursor

在 Cursor 设置中添加 MCP 配置：

打开 Cursor Settings → Features → MCP Servers
点击 "Add Server"
填写：
- Name: xhs-kit
- Command: xhs-kit serve

其他 MCP 客户端

任何支持 MCP 协议的客户端都可以使用，启动命令为：

xhs-kit serve

发布

图文

图：~/Downloads/vc.png

文字标题：Vibe Coding 真的心累💔

文字正文内容：强如 Opus，也只是傻乎乎地解决当下的指令...

就拿我的项目来说👇
App有两个登录渠道：
✅ 浏览器登录 ← 先调试好了
✅ 二维码登录 ← 后调试的

结果你猜怎么着？
浏览器登录的逻辑直接被二维码登录给复用覆盖了！😅

AI不会帮你考虑整体架构
它只看「现在」要解决的问题
就像装修师傅：你让他修灯，他可能把你刚装好的开关拆了😂

标签：#VibeCoding #AI #Claude #Agent #Opus

文字配图

封面文字：我开源了个小红书自动发布工具：xhs-kit

文字标题：我开源了个小红书自动发布工具：xhs-kit

文字正文内容：
我开源了个小红书自动发布工具：xhs-kit。

基于 Python，轻松兼容 Windows、Mac、Linux。
支持 Claude Code 和 OpenClaw，还能发布文字配图笔记。
核心原理：模拟浏览器登录。

项目地址：https://github.com/luweizheng/xhs-kit

欢迎来玩！

命令行使用

# 1. 扫码登录（首次使用必须执行）
# 方式一：打开浏览器窗口扫码
xhs-kit login-browser

# 方式二：在终端显示二维码，在 Claude Code、Open Code 中推荐使用这种
# 注意：需要安装 zbar 库（macOS: brew install zbar，Ubuntu: apt install libzbar0）
# 如果未安装 zbar，会自动保存二维码图片并提示路径
xhs-kit login-qrcode --terminal

# 方式三：保存二维码图片，在 OpenClaw 中将 qrcode.png 发送给 Channel 中的用户
xhs-kit login-qrcode --save qrcode.png

# 2. 检查登录状态（确认已登录后再执行其他操作）
xhs-kit status

# 发布图文
xhs-kit publish -t "标题" -c "文字正文内容" -i image1.jpg -i image2.jpg --tag 旅行 --tag 美食

# 发布视频
xhs-kit publish-video -t "标题" -c "文字正文内容" -v video.mp4

# 发布文字配图（将文字生成为卡片图片）
xhs-kit publish-text-card -c "封面文字" -p "第一页内容" -p "第二页内容" -s "基础" -t "笔记标题"

# 搜索内容
xhs-kit search -k "关键词"

# 获取首页推荐列表
xhs-kit list-feeds

# 获取笔记详情
xhs-kit detail --feed-id FEED_ID --xsec-token XSEC_TOKEN
xhs-kit detail --feed-id FEED_ID --xsec-token XSEC_TOKEN --load-comments

# 获取用户主页
xhs-kit user-profile --user-id USER_ID --xsec-token XSEC_TOKEN

# 点赞/取消点赞
xhs-kit like --feed-id FEED_ID --xsec-token XSEC_TOKEN
xhs-kit like --feed-id FEED_ID --xsec-token XSEC_TOKEN --unlike

# 收藏/取消收藏
xhs-kit favorite --feed-id FEED_ID --xsec-token XSEC_TOKEN
xhs-kit favorite --feed-id FEED_ID --xsec-token XSEC_TOKEN --unfavorite

# 发表评论
xhs-kit comment --feed-id FEED_ID --xsec-token XSEC_TOKEN -c "评论内容"

# 回复评论
xhs-kit reply-comment --feed-id FEED_ID --xsec-token XSEC_TOKEN -c "回复内容" --comment-id COMMENT_ID

# Debug 模式：验证发布内容（不实际发布）
# 用于测试 agentic workflow，验证参数格式、图片存在性、分辨率等
xhs-kit debug-publish -t "标题" -c "内容" -i image1.jpg -i image2.jpg --tag "标签1" --tag "标签2"

# 使用 --verbose/-v 显示详细信息（错误、警告、图片详情）
xhs-kit debug-publish -t "标题" -c "内容" -i image1.jpg --verbose

# 退出登录
xhs-kit logout

# 启动 MCP 服务
xhs-kit serve

MCP 工具列表

工具名	说明
`login_with_browser`	浏览器登录 - 弹出浏览器窗口扫码登录，cookies 保存后可复用
`check_login_status`	检查登录状态
`get_login_qrcode`	获取登录二维码（返回 Base64 图片，需配合轮询使用）
`delete_cookies`	删除 cookies，重置登录
`publish_content`	发布图文内容
`publish_text_card`	发布文字配图笔记
`publish_with_video`	发布视频内容
`list_feeds`	获取首页推荐列表
`search_feeds`	搜索内容
`get_feed_detail`	获取笔记详情
`get_user_profile`	获取用户主页
`like_feed`	点赞/取消点赞
`favorite_feed`	收藏/取消收藏
`post_comment`	发表评论
`reply_comment`	回复评论
`debug_publish_content`	Debug 模式 - 验证发布内容而不实际发布（用于测试 workflow）

API 参考

💡 提示： 点击下方功能标题可展开查看详细说明

第一步必须，小红书需要进行登录。可以检查当前登录状态。

MCP 工具：

login_with_browser - 启动浏览器扫码登录，cookies 保存后可复用
check_login_status - 检查当前登录状态
delete_cookies - 删除 cookies，重置登录状态

命令行：

# 浏览器扫码登录
xhs-kit login-browser

# 终端二维码登录，在 Claude Code、Open Code 中推荐使用这种
xhs-kit login-qrcode --terminal

# 检查登录状态
xhs-kit status

# 退出登录
xhs-kit logout

支持发布图文内容到小红书，包括标题、内容描述和图片。

MCP 工具： publish_content

参数：

参数	类型	必需	说明
`title`	string	✅	文章标题（最多20个字）
`content`	string	✅	文字正文内容
`images`	list[string]	✅	图片路径列表（本地绝对路径）
`tags`	list[string]	❌	话题标签列表
`schedule_at`	string	❌	定时发布时间（ISO8601格式）

命令行：

xhs-kit publish -t "标题" -c "文字正文内容" -i image1.jpg -i image2.jpg --tag 旅行 --tag 美食

支持发布视频内容到小红书，包括标题、内容描述和本地视频文件。

MCP 工具： publish_with_video

参数：

参数	类型	必需	说明
`title`	string	✅	文章标题（最多20个字）
`content`	string	✅	文字正文内容
`video`	string	✅	本地视频绝对路径
`tags`	list[string]	❌	话题标签列表
`schedule_at`	string	❌	定时发布时间（ISO8601格式）

命令行：

xhs-kit publish-video -t "标题" -c "文字正文内容" -v video.mp4

将文字生成为卡片图片并发布，支持多页和多种样式。

MCP 工具： publish_text_card

参数：

参数	类型	必需	说明
`cover_text`	string	✅	封面文字
`pages`	list[string]	❌	正文页列表（最多17页）
`style`	string	❌	卡片样式：基础/边框/备忘/手写/便签/涂写/简约/光影/几何
`title`	string	❌	文章标题
`content`	string	❌	文字正文内容
`tags`	list[string]	❌	话题标签列表

命令行：

xhs-kit publish-text-card -c "封面文字" -p "第一页" -p "第二页" -s "基础" -t "笔记标题"

根据关键词搜索小红书内容，支持多维度筛选。

MCP 工具： search_feeds

参数：

参数	类型	必需	说明
`keyword`	string	✅	搜索关键词
`sort_by`	string	❌	排序：综合/最新/最多点赞/最多评论/最多收藏
`note_type`	string	❌	类型：不限/视频/图文
`publish_time`	string	❌	时间：不限/一天内/一周内/半年内
`search_scope`	string	❌	范围：不限/已看过/未看过/已关注
`location`	string	❌	位置：不限/同城/附近

命令行：

xhs-kit search -k "关键词"

获取小红书首页推荐内容列表。

MCP 工具： list_feeds

参数： 无

获取小红书笔记的完整详情，包括内容、互动数据和评论。

MCP 工具： get_feed_detail

参数：

参数	类型	必需	说明
`feed_id`	string	✅	笔记 ID（从搜索或推荐列表获取）
`xsec_token`	string	✅	访问令牌（从搜索或推荐列表获取）
`load_comments`	bool	❌	是否加载评论（基础模式，前10条）
`load_all_comments`	bool	❌	是否加载全部评论（滚动加载）
`limit`	int	❌	限制一级评论数量（默认20）
`click_more_replies`	bool	❌	是否展开二级回复
`reply_limit`	int	❌	跳过回复数过多的评论（默认10）
`scroll_speed`	string	❌	滚动速度：slow/normal/fast

获取小红书用户的个人主页信息。

MCP 工具： get_user_profile

参数：

参数	类型	必需	说明
`user_id`	string	✅	用户 ID
`xsec_token`	string	✅	访问令牌

对笔记进行点赞或收藏操作。

MCP 工具：

like_feed - 点赞/取消点赞
favorite_feed - 收藏/取消收藏

参数：

参数	类型	必需	说明
`feed_id`	string	✅	笔记 ID
`xsec_token`	string	✅	访问令牌
`unlike`/`unfavorite`	bool	❌	是否取消操作（默认 false）

对笔记发表评论或回复已有评论。

MCP 工具：

post_comment - 发表评论
reply_comment - 回复评论

post_comment 参数：

参数	类型	必需	说明
`feed_id`	string	✅	笔记 ID
`xsec_token`	string	✅	访问令牌
`content`	string	✅	评论内容

reply_comment 参数：

参数	类型	必需	说明
`feed_id`	string	✅	笔记 ID
`xsec_token`	string	✅	访问令牌
`content`	string	✅	回复内容
`comment_id`	string	❌	目标评论 ID
`user_id`	string	❌	目标用户 ID

注意： comment_id 和 user_id 至少需要提供一个

用于测试 agentic workflow，验证参数格式、图片存在性、分辨率等，不会实际发布到小红书。

MCP 工具：

debug_publish_content - 验证发布内容

命令行：

# 简洁模式（默认）：只显示验证结果
xhs-kit debug-publish -t "标题" -c "内容" -i image1.jpg -i image2.jpg --tag "标签1"

# Verbose 模式：显示详细信息（错误、警告、图片详情等）
xhs-kit debug-publish -t "标题" -c "内容" -i image1.jpg --verbose
# 或使用短选项
xhs-kit debug-publish -t "标题" -c "内容" -i image1.jpg -v

输出示例：

简洁模式：

✅ 验证通过

Verbose 模式：

✅ 验证通过

详细信息:
{
  "title_length": 4,
  "content_length": 6,
  "total_images": 2,
  "valid_images": 2,
  "image_details": [...]
}

验证内容：

✅ 标题长度（最多 20 字符）
✅ 图片文件是否存在
✅ 图片格式是否支持（jpg/png/webp/heic）
✅ 图片分辨率（建议至少 480x480）
✅ 图片大小（建议 20MB 以内）
✅ 标签数量和长度

返回结果：

{
  "is_valid": true,
  "errors": [],
  "warnings": [],
  "info": {
    "title_length": 4,
    "content_length": 6,
    "total_images": 2,
    "valid_images": 2,
    "image_details": [...]
  }
}

debug_publish_content 参数：

参数	类型	必需	说明
`title`	string	✅	文字标题
`content`	string	✅	文字正文内容
`images`	list[string]	✅	图片路径列表
`tags`	list[string]	❌	标签列表

项目结构

xhs-kit 采用模块化设计，当前包含以下模块：

po (Post & Operations) - 运营模块
- 发布：图文、视频、文字配图
- 互动：点赞、收藏、评论、回复
- 数据：搜索、推荐、笔记详情、用户主页
- 登录：浏览器扫码、二维码登录

未来计划：

image - 图片生成模块（文字封面、文生图）
video - 视频处理模块（剪辑、字幕）

开发

# 克隆项目
git clone https://github.com/luweizheng/xhs-kit.git
cd xhs-kit

# 安装开发依赖
pip install -e ".[dev]"

# 安装浏览器
playwright install chromium

# 运行测试
pytest

注意事项

首次使用需要扫码登录，登录后 cookies 会保存到本地
浏览器扫码登录需要弹出浏览器窗口，请使用 xhs-kit login-browser
cookies 默认保存在当前目录的 cookies.json 文件
可通过环境变量 COOKIES_PATH 指定 cookies 文件路径

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessUnresponsive

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

blbl147-xhs-mcpOAuth
ai.smithery
搜索笔记、浏览首页推荐、查看笔记内容与评论，并发表你的评论。直接在工作流中与小红书内容互动，高效跟进话题。
Social Media Note Taking Content Management Systems
2
chinese-social-signals-mcpOAuth
com.thenextgennexus
MCP server: AI-agent access to Chinese social & trend signals — Douyin, Weibo, Xiaohongshu/RedNote,
Social Media Marketing
2
socialclaw B
io.github.ndesv21
Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
Social Media Marketing
32287
GTM API: LinkedIn MCP ServerOAuth
com.gtm-api
Managed LinkedIn MCP server for AI agents: search, connect, message and enrich on accounts you own.
Social Media Communication
199

Related MCP Servers

XHS MCP
Social Media Browser Automation App Automation
Algovate
A
license
Not graded
quality
F
maintenance
Enables interaction with Xiaohongshu (Little Red Book) platform through automated browser operations. Supports authentication, content publishing, search, discovery, and commenting using Puppeteer-based automation.
Updated 4 months ago (2026-05-17 02:31 UTC)
167 npm
55
MIT
Xiaohongshu MCP Server
Browser Automation Social Media Web Scraping
billyangbc
-
license
Not graded
quality
Not graded
maintenance
Enables enterprise-grade multi-account management and automated operations for Xiaohongshu (Little Red Book) platform. Supports content searching, publishing, user data collection, and anti-detection features through browser automation with proxy rotation and fingerprint spoofing.
Updated a year ago (2025-10-08 04:10 UTC)
-
Xiaohongshu MCP Python
Social Media Content Management Systems App Automation
luyike221
F
license
Not graded
quality
F
maintenance
Enables automated content publishing and management on Xiaohongshu (Little Red Book) platform, supporting image/video posts, content search, user profiles, and interactions through the Model Context Protocol.
Updated 4 months ago (2026-05-13 15:04 UTC)
142
-
xiaohongshu-skill
Social Media App Automation
Youhai020616
A
license
Not graded
quality
B
maintenance
MCP server for automating Xiaohongshu (RED Note). Publish posts, search content, comment, like, and analyze creator data on China's largest lifestyle social platform.
Updated 4 days ago (2026-09-12 08:17 UTC)
24
MIT

xhs-kit

特性

安装

快速开始

使用流程

MCP 客户端配置

Claude Desktop

Claude Code

Cursor

其他 MCP 客户端

发布

图文

文字配图

命令行使用

MCP 工具列表

API 参考

项目结构

开发

注意事项

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

XHS MCP

Xiaohongshu MCP Server

Xiaohongshu MCP Python

xiaohongshu-skill