@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

免责声明

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