xiaohongshu-mcp 是一个基于 Go 语言的开源 MCP(Model Context Protocol)自动化工具,专为小红书平台设计,支持登录验证、图文内容发布、内容搜索和首页推荐列表获取,通过 HTTP MCP 协议无缝集成 AI 客户端(如 Claude Code CLI、Cursor、VSCode),实现自动化内容运营,已验证无封号风险,适用于内容创作者和自动化脚本开发者。
构建小红书专用 MCP 服务器:获取内容或者让 Claude Code 自己调研; 让 Claude Code 调用 xiaohongshu-mcp 完成发布;
•
稳定与安全:基于一年多实测经验(无封号,仅 Cookies 过期),支持无头/有头浏览器模式,集成 MCP Inspector 验证。
功能速览
•登录与状态检查:手动登录保存 Cookies,检查当前登录状态(避免多端冲突);支持无头模式(无浏览器界面)。•发布图文内容:上传标题(≤20 字)、描述、图片(URL 或本地),一键发布帖子;未来支持标签、视频/纯文字(低优先级)。•搜索内容:根据关键词搜索帖子,支持精确匹配和结果列表。•获取推荐列表:拉取小红书首页推荐内容,获取热门帖子列表。•MCP 集成:4 个核心工具(check_login_status、publish_content、list_feeds、search_feeds),通过 HTTP MCP 协议(http://localhost:18060/mcp)连接 AI 客户端,实现 AI 驱动发布(如 Claude 生成内容后自动上传)。•其他特性:浏览器自动化(基于 Go 驱动,可能 Selenium/Playwright),演示视频(login.mp4、mcp_search.mp4 等);实操成果展示(首日高互动、一周多帖)。•限制:当前仅图文;每天限 50 篇;单账号单端登录;无视频/纯文字高优先级支持。•风险提示:学习目的,禁止违法;实测稳定,但 Cookies 过期需重登。
安装与部署
1前提条件•Go 1.21+(标准安装,https://go.dev/doc/install)。•Chrome/Chromium 浏览器(无头模式需安装)。•MCP 客户端:Claude Code CLI(claude mcp add)、Cursor/VSCode(配置 mcp.json)。2安装步骤•克隆仓库:git clone https://github.com/xpzouying/xiaohongshu-mcp.git•进入目录:cd xiaohongshu-mcp•首次登录:go run cmd/login/main.go(手动登录小红书,保存 Cookies)。•启动服务:go run .(默认无头);或 go run . -headless=false(有浏览器界面)。•服务地址:http://localhost:18060/mcp3验证与测试•MCP Inspector:npx @modelcontextprotocol/inspector,连接 http://localhost:18060/mcp,检查 List Tools(4 个工具)。•Curl 测试:curl -X POST http://localhost:18060/mcp -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}'•客户端接入:Claude CLI claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp4部署•本地开发:go run 即可;生产:go build -o xiaohongshu-mcp main.go,运行二进制。•远程:暴露端口(e.g., ngrok),但注意登录安全。•更新:git pull,重新 go run。