小红书内容运营 MCP 专家

让 AI 直接操作小红书的 MCP 运营助手（基于开源项目 xiaohongshu-mcp）：支持发布图文/视频笔记、关键词搜索笔记、获取帖子详情与评论、发表评论回复、点赞收藏、查看用户主页。本技能提供完整工具清单、部署与扫码登录配置、内容运营规范（标题≤20字、正文≤1000字、图文流量优先）与风控合规要点，文案生成与工具决策统一由平台大模型驱动。

Skill Documentation

📕 小红书内容运营 MCP 专家

摘要

让 AI 直接操作小红书的 MCP 运营助手（基于开源项目 **xiaohongshu-mcp**）：支持**发布图文 / 视频笔记**、**关键词搜索笔记**、**获取帖子详情与评论**、**发表评论与回复**、**点赞 / 收藏**、**查看用户主页**。本技能提供完整工具清单、部署与登录配置、**内容运营规范**与风控要点。

**作者:** WorkBuddy 用户

**评分:** ⭐⭐⭐⭐⭐

🎯 核心事实速查（唯一口径 · 回答前先读本节）

| 项 | 值 |

|---|---|

| 上游项目 | `xpzouying/xiaohongshu-mcp`（Go，Apache-2.0） |

| 形态 | MCP Server（可被 AI 客户端直接调用） |

| 默认端口 | **18060** |

| 传输协议 | MCP Streamable HTTP（协议版本 `2025-03-26`，Stateless 模式，可跳过 initialize 握手） |

| 端点 | `/mcp`（MCP）、`/api/v1/*`（HTTP API）、`/health`（健康检查） |

| 登录方式 | **首次需手动扫码登录**，成功后 Cookie 持久化 |

| Cookie 路径优先级 | `COOKIES_PATH` > 当前目录 > `/tmp` |

| 可选鉴权 | `AUTH_TOKEN`（Bearer Token，**默认关闭**） |

| 代理 | `XHS_PROXY`，支持 HTTP / HTTPS / SOCKS5 |

| 支持平台 | macOS Apple Silicon、Windows x64、Linux x64 |

| **不支持** | macOS Intel、Linux ARM64 |

工具清单

| 工具 | 用途 |

|---|---|

| `check_login_status` | 检查登录状态（**第一步必做**） |

| `get_login_qrcode` / `check_qrcode_status` | 获取登录二维码 / 轮询扫码状态 |

| `publish_content` | 发布**图文**内容（标题、正文、图片、Tags） |

| `publish_video` | 发布**视频**内容 |

| `list_feeds` | 获取首页推荐列表 |

| `search_feeds` | 按关键词搜索笔记 |

| `get_feed_detail` | 获取帖子详情（含互动数据、评论及子评论） |

| `post_comment` | 发表评论 |

| `like_feed` | 点赞（`unlike=true` 取消） |

| `favorite_feed` | 收藏（`unfavorite=true` 取消） |

| `user_profile` | 获取用户主页信息 |

> 通知类工具（`get_unread_count` / `list_notifications` / `reply_notification` / `like_notification`）以项目版本为准。

内容运营规范（非常重要，直接影响流量）

| 规范 | 要求 |

|---|---|

| **标题长度** | **不超过 20 个字**（硬性限制） |

| **正文字数** | **不超过 1000 个字**（硬性限制） |

| 内容形式流量 | **图文 > 视频 > 纯文字** |

| Tags | 合理添加可带来更多曝光 |

| 日发帖量 | 建议约 **50 篇**以内 |

| 账号登录 | **同一账号不允许在多个网页端同时登录**，否则会被"踢出登录"；查看账号请用移动 App |

**视频发布额外限制**：仅支持**本地视频文件绝对路径**（不支持 HTTP 链接），建议文件不超过 **1GB**，处理耗时较长。

**图片发布**：支持 HTTP/HTTPS 链接与本地绝对路径两种；**推荐本地路径**——更稳定、上传更快、避免链接失效。

**帖子详情 / 评论类操作**：需同时提供 **`feed_id`（帖子 ID）** 与 **`xsec_token`**，两者缺一不可，可从 Feed 列表或搜索结果中获取。

部署与配置

方式一 · 预编译二进制（推荐）

# 1. 先登录（会打开浏览器扫码）
chmod +x xiaohongshu-login-darwin-arm64
./xiaohongshu-login-darwin-arm64

# 2. 再启动 MCP 服务
chmod +x xiaohongshu-mcp-darwin-arm64
./xiaohongshu-mcp-darwin-arm64

> 首次启动会**自动下载无头浏览器（约 150MB）**，后续无需重复下载。

> 文件命名：主程序 `xiaohongshu-mcp-{平台}-{架构}`，登录工具 `xiaohongshu-login-{平台}-{架构}`。

方式二 · Docker

docker pull xpzouying/xiaohongshu-mcp
# 使用 docker/docker-compose.yml，暴露 18060 端口，自动挂载 cookies 与 images 目录
docker compose up -d

方式三 · 源码编译（Go）

需配置 Go 代理（如 `GOPROXY=https://goproxy.cn,direct`），然后 `go run cmd/login/main.go` 登录、`go run .` 启动。

客户端接入方式

{
  "mcpServers": {
    "xiaohongshu-mcp": {
      "command": "curl",
      "args": ["-X", "POST", "http://localhost:18060/mcp",
               "-H", "Content-Type: application/json", "-d", "@-"],
      "description": "小红书内容发布和管理服务"
    }
  }
}

启用鉴权时（可选）：

AUTH_TOKEN=your-secret-token ./xiaohongshu-mcp-darwin-arm64

平台大模型对接（本技能的统一口径）

本项目本身是 **MCP 工具服务器，不含大模型**。所有需要"理解与生成"的环节——

**笔记文案撰写、标题提炼、Tags 生成、搜索意图理解、评论话术、运营分析**——

**统一由平台大模型驱动**，无需自备模型账号。

工作方式：由 AI 客户端（平台模型）决定"调哪个工具、传什么参数"，本服务只负责执行。

| 环节 | 由谁完成 |

|---|---|

| 写标题 / 正文 / Tags | **平台大模型**生成 |

| 判断该调用哪个工具、怎么填参数 | **平台大模型**决策 |

| 实际发布、搜索、评论等动作 | xiaohongshu-mcp 执行 |

适用场景

• **内容批量运营**：一次生成多篇笔记文案并发布
• **选题调研**：搜索关键词，分析高互动笔记的标题与结构
• **评论互动**：批量回复评论、维护笔记热度
• **账号运营**：查看主页数据、粉丝与笔记表现
• **竞品观察**：搜索同类内容，分析其选题与标签策略

常见问题（FAQ）

**Q1：需要自己部署吗？**

A：需要。本项目是本地 MCP 服务（Go 编写的二进制 / Docker / 源码），运行在本机 18060 端口。

**Q2：第一次怎么登录？**

A：运行登录工具，会打开浏览器，用小红书 App 扫码；成功后 Cookie 持久化，后续无需重复登录。

**Q3：提示未登录 / 操作失败？**

A：先调 `check_login_status` 确认状态；失效则重新登录并清理旧 cookies。另需确认**没有在多个网页端同时登录同一账号**。

**Q4：为什么标题发不出去？**

A：检查**标题是否超过 20 字**、**正文是否超过 1000 字**——这是硬性限制。

**Q5：视频为什么发不了？**

A：视频**只支持本地文件绝对路径**，不支持网络链接；建议文件 ≤ 1GB。

**Q6：获取帖子详情报错缺参数？**

A：需要同时提供 `feed_id` 与 `xsec_token`，两者缺一不可。

**Q7：会被限流或封号吗？**

A：项目实测长期运行未出现封号，仅遇到 Cookie 过期。但**内容违规（引流、纯搬运）是官方重点打击对象**，且未实名认证的新号会收到实名提醒。建议先实名、控制频率、避免搬运。

风险与合规（务必阅读）

1. **内容责任**：AI 生成并发布的文案由使用者负责，不得发布虚假宣传、违禁内容或侵犯他人权益的信息。

2. **禁止行为**：**严禁引流与纯搬运**（官方重点打击）；严禁用于任何违法违规用途。

3. **账号风险**：自动化操作存在**限流与账号风险**，请遵守平台规则，控制发布频率，建议先用小号验证。

4. **凭证安全**：登录 Cookie 与 `AUTH_TOKEN` 属敏感凭证，**仅存本地，不要发到对话里或提交到代码仓库**。

5. **曝光异常**：曝光低时先自查是否含违禁词。

6. **版权**：使用他人图片/视频素材需获得授权。

限制

• **平台支持有限**：不支持 macOS Intel 与 Linux ARM64。
• 首次运行需下载约 150MB 无头浏览器。
• 同一账号**不允许多网页端同时登录**，否则会被踢出。
• 视频仅支持本地绝对路径且处理较慢。
• 依赖 Cookie 有效性，**过期需手动重新登录**。

联系方式

通过 aimsgateway.cn 联系发布者反馈问题。

---

🤖 Agent 使用说明

• **触发关键词**：小红书、xhs、RedNote、xiaohongshu-mcp、发布笔记、图文笔记、视频笔记、搜索笔记、点赞、收藏、评论、小红书运营、Tags。
• **第一步永远是 `check_login_status`**：未登录先走扫码流程，不要直接调用发布类工具。
• **发布前必查两条硬性限制**：标题 ≤ 20 字、正文 ≤ 1000 字。超限需先精简。
• **详情 / 评论类操作**：必须同时带 `feed_id` 与 `xsec_token`，缺失时先通过 `search_feeds` 或 `list_feeds` 获取。
• **工具名必须拼写准确**（见工具清单），不要臆造工具或参数名；本文档未记载的，回答「以项目仓库为准」。
• **输出格式**：先给**可直接发布的内容**（标题 / 正文 / Tags 分列），再给工具调用参数。
• **安全红线**：绝不请求、接收或回显用户的 Cookie 与 `AUTH_TOKEN`；绝不执行违法违规内容的发布。
• **合规前置**：涉及引流、搬运类需求，**明确拒绝并说明平台规则**。

👤 用户需要做什么

• [ ] 完成本地部署（二进制 / Docker / 源码三选一）并启动服务（默认 18060 端口）
• [ ] 首次使用完成**扫码登录**，确认 `check_login_status` 正常
• [ ] 准备要发布的图片（**推荐本地绝对路径**）或视频（**必须是本地绝对路径**）
• [ ] 确认内容合规：标题 ≤ 20 字、正文 ≤ 1000 字，不含引流与搬运内容
• [ ] 控制发布频率（建议 ≤ 50 篇/天），避免多网页端同时登录
• [ ] 从 Feed 列表或搜索结果中保存 `feed_id` 与 `xsec_token`，供详情/评论操作使用