xiaohongshu-mcp

让 AI 客户端直接搜索和发布小红书内容

开源 🏷️定价信息待确认 ⏳ 访问状态待核验 智能体 🍴 复刻 2534 🐛 待处理 112 👀 关注 37
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 17200
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

xiaohongshu-mcp 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类智能体
开发团队xpzouying
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态⏳ 访问状态待核验
是否开源是
开源协议Apache-2.0
主要语言Go
技术栈/模型mcp,mcp-server,xiaohongshu-mcp
GitHub 星标★ 17200
上线时间2025-08-03 00:00:00
代码更新2026-11-16
仓库体积84.1 MB
本站数据更新2026-11-19
维护状态活跃
收录时间2026-11-19
浏览次数0

项目介绍

xiaohongshu-mcp 是一个用 Go 编写的 MCP 服务器,把小红书的内容浏览与发布能力封装成标准 Model Context Protocol 工具,供 Claude、Cursor 等支持 MCP 的 AI 客户端直接调用。它解决的是 AI 助手无法直接操作小红书的问题:通过浏览器自动化完成登录态维持、搜索笔记、读取详情与评论、发布图文等操作,让智能体在对话中就能检索小红书内容或代用户发帖。核心能力包括账号登录与状态管理、关键词搜索、笔记详情抓取、评论获取以及图文发布,接口以 MCP 工具形式暴露,配置简单,适合做内容调研、选题分析和自动化运营的实验性项目。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-11-19 · 当前星标 ★ 17200

技术标签

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:进阶 约 15 分钟 部署方式:本地安装 6 步

环境要求

  • 系统平台:macOS Apple Silicon、Windows x64 或 Linux x64(macOS Intel 与 Linux ARM64 暂不支持)
  • 首次启动需联网自动下载无头浏览器(约 150MB)
  • 下载前请确认网络连接稳定
  • 使用源码编译需先安装 Go 环境
  • 由支持 HTTP MCP 的客户端调用(如 Claude Code、Cursor、VSCode、Cline 等)

安装与启动步骤

  1. 1下载预编译文件

    在 GitHub Releases 页面按平台下载 MCP 主程序与登录工具两个文件,放入同一目录

  2. 2运行登录工具

    先运行登录工具完成小红书账号登录,登录态会被保存供后续服务复用

    chmod +x xiaohongshu-login-darwin-arm64
    ./xiaohongshu-login-darwin-arm64
  3. 3启动 MCP 服务

    运行主程序启动 MCP 服务,默认监听本地 18060 端口;首次启动会下载无头浏览器

    chmod +x xiaohongshu-mcp-darwin-arm64
    ./xiaohongshu-mcp-darwin-arm64
  4. 4可选启用访问鉴权

    若不希望服务被随意调用,可通过 AUTH_TOKEN 环境变量设置令牌,默认不启用鉴权

    AUTH_TOKEN=your-secret-token ./xiaohongshu-mcp-darwin-arm64
  5. 5配置 MCP 客户端

    在客户端 MCP 配置中填入服务地址;Cursor 可在项目根目录新建 .cursor/mcp.json

    {
      "mcpServers": {
        "xiaohongshu-mcp": {
          "url": "http://localhost:18060/mcp",
          "description": "小红书内容发布服务 - MCP Streamable HTTP"
        }
      }
    }
  6. 6确认连接成功

    保存配置并重启客户端后,用命令行列出 MCP 服务,看到已连接即表示接入成功

    claude mcp list

关键配置

配置项必填说明示例
url是MCP 服务的 HTTP 接入地址,客户端据此连接http://localhost:18060/mcp
AUTH_TOKEN否启用服务端访问鉴权的令牌,非空启动参数优先于该环境变量your-secret-token
Authorization否启用鉴权后客户端需携带的请求头,格式为 Bearer 加令牌Bearer your-secret-token
type否部分客户端用于指定传输类型http
timeout否客户端请求超时时间,单位毫秒(Gemini CLI 配置项)30000

如何确认成功

客户端执行 claude mcp list 或 opencode mcp list,显示 xiaohongshu-mcp 已连接即表示服务启动成功。

常见问题

Q:显示发布成功但小红书上没有内容?

A:先用非无头模式重新发布一次并更换内容测试;再检查账号是否被限制网页版发布、图片是否过大、图片路径是否含中文字符、网络图片链接能否正常访问。

Q:程序运行时闪退怎么办?

A:确认系统平台在支持范围内,并检查首次运行所需的无头浏览器是否已完整下载;排查耗时较久可先查阅仓库 Issues #56 的疑难杂症汇总。

Q:客户端配置后连不上服务?

A:确认 MCP 服务已在本机启动且地址端口填写正确;若启用了 AUTH_TOKEN,还需在客户端配置中加上 Authorization: Bearer 请求头。

Q:可以用令牌启动时怎么更安全?

A:命令行参数可能被进程列表看到,部署环境建议改用 AUTH_TOKEN 环境变量传入令牌。

Q:为什么检查登录用户名显示固定名称?

A:该用户名在实现中是写死的,不代表实际登录账号,属正常现象。

注意事项

  • 首次运行会自动下载约 150MB 的无头浏览器,请预留时间和磁盘空间,之后无需重复下载。
  • 目前仅提供 macOS Apple Silicon、Windows x64、Linux x64 三个平台的预编译文件。
  • 发布图片建议使用本地路径作为图片地址,能提升稳定性。
  • 若已启用访问鉴权,所有 MCP 客户端都必须配置对应的 Authorization 请求头。

核心亮点

  • 用 Go 单二进制部署,启动快、依赖少,配置 MCP 客户端即可接入
  • 把搜索、读笔记、看评论、发图文封装成标准 MCP 工具,AI 可直接调用
  • 基于浏览器自动化维持登录态,贴近真实用户操作路径,接入门槛低

不足之处

  • 依赖浏览器自动化,平台页面结构或风控策略变化时容易失效
  • 发布与抓取行为受平台规则约束,高频调用可能触发验证或限流
  • 仅覆盖小红书单一平台,工具粒度和稳定性仍待长期验证

适用场景

  • 内容创作者让 AI 助手调研某关键词下的热门笔记与评论风向
  • 运营人员在对话中批量生成并发布图文笔记草稿
  • 数据分析场景下抓取笔记详情,做选题与竞品内容分析

替代项目

mcp-server-browserbase、playwright-mcp、browser-use

上一篇:github-mcp-server

下一篇:ida-pro-mcp

同类项目推荐

dsh-nekowhale-stickers 开源

给聊天机器人接入大肥鱼表情包,回复更有情绪

大肥鱼 / GPT娘 sticker knowledge kit for DeepSeek Harness (dsh), MCP and any chat bo···

★ 201 2026-11-02
everyinfra-agent-plugins 开源

给 AI 编程工具一键接入百平台数据采集

EveryInfra MCP server & agent plugin: scraper API for TikTok, Instagram, Amazon, You···

★ 604 2026-11-05
mcp-for-blender 开源

用嘴指挥 Blender 建模,说句话就改场景

Community plugin to control Blender 3D with any LLM of your choice. Not affiliated w···

★ 34883 2026-09-26
skills 开源

给 AI 装上社媒运营大脑,一句话跑通内容全流程

106 social media skills for AI agents - strategy, writing, video, design, platform g···

★ 339 2026-10-09
awesome-gamedev-agent-skills 开源

给AI装上游戏引擎大脑,一键生成专业游戏代码

Make games with your AI coding agent: 79 game-dev skills and a router for Godot, Uni···

★ 9437 2026-08-09
mnemory 开源

给 AI 助手装一个自托管、会自动整理事实的长期记忆库

A self-hosted, secure, feature-rich memory system for AI agents and assistants. Prov···

★ 284 2026-10-24
oryxos 开源

像管进程一样管 AI Agent,分布式调度开箱即用

OryxOS is an open-source Distributed AI Agent OS

★ 214 2026-10-01
mantishack 开源

用AI智能体自动挖漏洞,提升渗透测试效率

Mantis Hack

★ 507 2026-08-09
xint 开源

本地命令行玩转 X 数据,搜索监控分析导出一步到位

Local-first X Intelligence CLI for search, monitoring, analysis, exports, OAuth acti···

★ 262 2026-08-09