Skip to main content
Glama
JessYan0913

xiaohongshu-mcp

by JessYan0913

@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 指定)。

Related MCP server: XHS MCP

可用工具(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

搜索/推荐结果会返回 idxsecToken,二者组合才能访问详情页(小红书安全机制),详情/点赞/收藏均需传入。

使用示例

帮我搜索小红书上的"咖啡探店"笔记,取 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

免责声明

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

Install Server
A
license - permissive license
A
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    B
    quality
    D
    maintenance
    Enables automated interaction with Xiaohongshu (Little Red Book) social media platform through browser automation. Supports login management, status checking, and publishing text content with images to Xiaohongshu accounts.
    3
    3
  • A
    license
    -
    quality
    D
    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.
    344
    54
    MIT
  • F
    license
    -
    quality
    D
    maintenance
    Enables AI agents to publish content to XiaoHongShu (Little Red Book) social platform, including checking login status and posting with titles, content, images, and hashtags through browser automation.
    4
  • F
    license
    -
    quality
    D
    maintenance
    Enables automated interaction with Xiaohongshu (Little Red Book) platform including searching posts, retrieving content and comments, and posting AI-generated comments with persistent login support.
    442

View all related MCP servers

Related MCP Connectors

  • 搜索笔记、浏览首页推荐、查看笔记内容与评论,并发表你的评论。直接在工作流中与小红书内容互动,高效跟进话题。

  • AI-powered browser automation — navigate, click, fill forms, and extract data from any website.

  • Provides cloud browser automation capabilities using Stagehand and Browserbase, enabling LLMs to i…

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/JessYan0913/xiaohongshu-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server