让 Claude Code 自动化运营小红书

获取内容或者让 Claude Code 自己调研
让 Claude Code 调用 xiaohongshu-mcp 完成发布

一、项目定位和目的

  • “MCP” 在这里是 “Model Context Protocol”(模型上下文协议)的一种协议/接入方式,该项目把小红书的操作封装成 MCP 服务,以供外部客户端(如 ChatGPT 插件、Claude、Cursor 等支持 MCP 的客户端)进行调用。
  • 简单来说,它把小红书的各种操作(登录、发帖、搜索、获取用户信息、发表评论等)封装成 API / 工具,使得其他工具或模型可以“用自然语言”控制小红书,而不用自己写爬虫或接口。
  • 项目自称主要用于“学习”的目的,禁止从事违法行为。

二、主要功能

这个项目提供了以下核心功能:

功能说明
登录 / 检查登录状态让账号登录到小红书,并判断当前是否处于登录状态
发布图文内容可以发布带标题、文字描述、图片的帖子到小红书
发布视频内容支持上传视频内容并发表到小红书(带标题、描述、标签等)
搜索内容给定关键词搜索小红书的帖子内容
获取推荐/首页内容获取小红书首页推荐的帖子列表(feed 列表)
获取帖子详情通过帖子 ID + xsec_token 获取帖子的完整内容、互动数据、评论等
发表评论向某个帖子发表评论(需要帖子 ID / xsec_token / 评论内容)
获取用户主页获取某个用户的主页信息(昵称、粉丝、笔记列表等)

除此之外,它还支持以 MCP 工具的方式被其他客户端调用。

三、架构与技术栈

从项目结构和说明看:

  • 使用 Go 语言 作为后端服务语言。
  • 提供预编译的二进制文件以及 Docker 镜像以便部署。
  • 项目中包含 app_server.gomcp_server.gohandlers_api.goroutes.goservice.gotypes.go 等模块,从名字看是典型的 Web 服务 + 路由 + 业务逻辑拆分结构。
  • 使用无头浏览器 / 浏览器自动化(或类似技术)来帮助实现登录、图片 / 视频上传等操作(因为小红书并没有公开的官方开放 API 给普通用户这样使用)。这一点从 README 的“首次运行会自动下载无头浏览器”可见。
  • 支持通过 MCP 协议与外部客户端通信(HTTP 接口方式)。外部客户端可以调用这些封装好的工具。

四、使用方法(概要)

下面是这个项目的基本使用流程(简略版):

  1. 登录
    运行登录工具,让用户手动登录小红书,以建立登录状态(保存 Cookies / 会话等)
  2. 启动 MCP 服务
    启动 xiaohongshu-mcp 服务(可以选择无头模式或带界面模式),服务默认监听某个端口(如 18060)作为 MCP 接口服务。
  3. 客户端接入 MCP
    在支持 MCP 协议的客户端(如 Claude Code、Cursor、VSCode 插件等)中配置这个 MCP 服务;这样这些客户端就可以调用小红书相关功能。
  4. 调用工具 / 接口
    客户端或外部程序可以调用以下工具(API):
    • check_login_status
    • publish_content
    • publish_with_video
    • list_feeds
    • search_feeds
    • get_feed_detail
    • post_comment_to_feed
    • user_profile
  5. 部署方式
    • 直接运行预编译二进制
    • 源码编译
    • 使用 Docker / Docker Compose 部署
  6. 调试 / 验证
    使用 MCP Inspector 或 curl 等方式验证服务是否正常。

五、优点与局限 / 风险

优点:

  • 对使用者而言,隐藏了很多复杂性(登录、文件上传、xsec_token 管理等),使用者像调用普通 API 一样操作小红书。
  • 可以结合 AI 模型 / 工具,实现“用自然语言操作小红书(发帖、搜索、获取数据)”的体验。
  • 支持 Docker、二进制发布,部署相对方便。

局限 / 风险 /需要注意的地方:

  • 账号安全:使用浏览器自动化登录(模拟操作账户),存在被小红书风控检测、账号被封或限制的风险。
  • xsec_token 等安全参数:有些接口(如获取帖子的详情、发表评论)需要 xsec_token 等参数,需要通过前端 / 列表接口获得;如果 token 失效或缺失,接口可能无法正常调用。
  • 依赖于前端行为:因为小红书没有对外公开官方完整 API,这种方式本质是模拟用户行为或抓包/逆向。如果小红书前端接口升级、加密策略变更,项目可能随时失效或需要维护。
  • 合法性与合规性:虽然作者声明用于学习目的,但如果用于商业运营、批量刷量、违规营销等,就有版权 / 使用条款 /平台规则的风险。
  • 稳定性:Cookies 可能过期、登录状态可能失效;网络波动、反爬机制都有可能造成请求失败。 README 中也提到 Cookies 过期需要重新登录。

项目地址:https://github.com/xpzouying/xiaohongshu-mcp
文章介绍:https://www.haha.ai/xiaohongshu-mcp

油管:https://youtu.be/Z2QjvjjDuTA