@siact/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", "@siact/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 目录（默认 ~/.xiaohongshu-mcp/profile） | | 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

免责声明

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