@the-thing/xiaohongshu-mcp

小红书 MCP Server（浏览器自动化实现）。扫码登录后，AI 助手可直接搜索笔记、获取推荐/详情、发布图文、点赞收藏。

借鉴 xpzouying/xiaohongshu-mcp 的实现思路（__INITIAL_STATE__ 数据提取、人性化延迟模拟、发布成功验证），采用 Node.js + puppeteer-core 实现，复用本机 Chrome/Edge，无需下载浏览器，npx 一行接入。

安装（一行配置）

在你的 MCP 客户端配置文件（如 ~/.siact/mcps/xiaohongshu.json）中添加：

{
  "mcpServers": {
    "xiaohongshu": {
      "command": "npx",
      "args": ["-y", "@the-thing/xiaohongshu-mcp@latest"]
    }
  }
}

要求：Node.js 18+，本机装有 Google Chrome 或 Microsoft Edge（自动探测，也可用环境变量 PUPPETEER_EXECUTABLE_PATH 指定）。

可用工具（9 个）

工具	说明	必填参数
xhs_login	扫码登录小红书（首次使用），登录态自动保存	无
xhs_check_login	检查登录状态，返回当前账号昵称	无
xhs_logout	退出登录，清除本地登录态	无
xhs_search_feeds	按关键词搜索笔记	keyword, limit?
xhs_get_recommend_feeds	获取首页推荐列表	limit?
xhs_get_feed_detail	获取笔记详情（正文/图片/互动/评论）	feedId, xsecToken
xhs_publish_note	发布图文笔记（本地图片或 URL）	title, content, images
xhs_like_feed	点赞/取消点赞（自动检测状态防重复）	feedId, xsecToken
xhs_favorite_feed	收藏/取消收藏（自动检测状态防重复）	feedId, xsecToken

搜索/推荐结果会返回 id 与 xsecToken，二者组合才能访问详情页（小红书安全机制），详情/点赞/收藏均需传入。

使用示例

帮我搜索小红书上的"咖啡探店"笔记，取 5 条
→ xhs_search_feeds(keyword="咖啡探店", limit=5)

看一下第一条笔记的详细内容和评论
→ xhs_get_feed_detail(feedId=..., xsecToken=...)

帮我把这张图配一段文案发到小红书：C:\pics\coffee.jpg
→ xhs_publish_note(title="...", content="...", images=["C:\\pics\\coffee.jpg"])

环境变量

变量	说明
PUPPETEER_EXECUTABLE_PATH	指定 Chrome/Edge 可执行文件路径（默认自动探测）
XHS_COOKIES_PATH	登录态 cookies 文件路径（默认 ~/.xiaohongshu-mcp/cookies.json）
XHS_USER_DATA_DIR	浏览器 profile 目录（默认临时目录，登录态由 cookies 管理）
XHS_HEADLESS	false 时所有操作显示浏览器窗口（默认无头）
XHS_PROXY	代理地址（如 http://127.0.0.1:7890）

本地开发

git clone <repo>
cd xiaohongshu-mcp
npm install
npm start        # 启动 MCP server（stdio）
node client.js   # 联调：列出工具并调用 xhs_check_login

免责声明

本项目仅用于学习与研究，使用者应遵守小红书平台规则，控制操作频率，账号风险自负。