获取内容或者让 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.go
、mcp_server.go
、handlers_api.go
、routes.go
、service.go
、types.go
等模块,从名字看是典型的 Web 服务 + 路由 + 业务逻辑拆分结构。 - 使用无头浏览器 / 浏览器自动化(或类似技术)来帮助实现登录、图片 / 视频上传等操作(因为小红书并没有公开的官方开放 API 给普通用户这样使用)。这一点从 README 的“首次运行会自动下载无头浏览器”可见。
- 支持通过 MCP 协议与外部客户端通信(HTTP 接口方式)。外部客户端可以调用这些封装好的工具。
四、使用方法(概要)
下面是这个项目的基本使用流程(简略版):
- 登录
运行登录工具,让用户手动登录小红书,以建立登录状态(保存 Cookies / 会话等) - 启动 MCP 服务
启动xiaohongshu-mcp
服务(可以选择无头模式或带界面模式),服务默认监听某个端口(如 18060)作为 MCP 接口服务。 - 客户端接入 MCP
在支持 MCP 协议的客户端(如 Claude Code、Cursor、VSCode 插件等)中配置这个 MCP 服务;这样这些客户端就可以调用小红书相关功能。 - 调用工具 / 接口
客户端或外部程序可以调用以下工具(API):check_login_status
publish_content
publish_with_video
list_feeds
search_feeds
get_feed_detail
post_comment_to_feed
user_profile
- 部署方式
- 直接运行预编译二进制
- 源码编译
- 使用 Docker / Docker Compose 部署
- 调试 / 验证
使用 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