### 2.4 项目定位

xiaohongshu-mcp 填补了 AI 助手与小红书平台之间的 Gap。通过 MCP 协议，AI 助手可以像人类一样操作小红书账号，实现自动化运营、内容发布、社群互动等功能。

---

## §3 核心功能详解

### 3.1 内容发布

#### 3.1.1 发布图文

`publish_content` 工具用于发布图文内容到小红书：

| 参数 | 类型 | 必需 | 说明 |
|------|------|------|------|
| `title` | string | ✅ | 标题（不超过 20 字） |
| `content` | string | ✅ | 正文（不超过 1000 字） |
| `images` | string[] | ✅ | 图片路径列表（至少 1 张），支持 HTTP 链接或本地绝对路径 |
| `tags` | string[] | 可选 | 话题标签列表，如 `["美食", "旅行"]` |
| `schedule_at` | string | 可选 | 定时发布时间，ISO8601 格式，支持 1 小时至 14 天内 |
| `is_original` | boolean | 可选 | 是否声明原创，默认 false |
| `visibility` | string | 可选 | 可见范围：`公开可见`（默认）/ `仅自己可见` / `仅互关好友可见` |
| `products` | string[] | 可选 | 商品关键词列表，用于绑定带货商品 |

#### 3.1.2 发布视频

`publish_with_video` 工具用于发布视频内容：

| 参数 | 类型 | 必需 | 说明 |
|------|------|------|------|
| `title` | string | ✅ | 标题 |
| `content` | string | ✅ | 正文 |
| `video` | string | ✅ | 本地视频文件绝对路径（仅支持单个视频文件） |
| `tags` | string[] | 可选 | 话题标签列表 |
| `schedule_at` | string | 可选 | 定时发布时间 |
| `visibility` | string | 可选 | 可见范围 |
| `products` | string[] | 可选 | 商品关键词列表 |

### 3.2 登录与认证

#### 3.2.1 检查登录状态

`check_login_status` 用于检查当前小红书账号的登录状态（无参数）。

#### 3.2.2 获取登录二维码

`get_login_qrcode` 用于获取登录二维码，返回 Base64 图片和超时时间（无参数）。

#### 3.2.3 删除 Cookies

`delete_cookies` 用于删除 cookies 文件，重置登录状态，删除后需要重新登录（无参数）。

**⚠️ 重要提示**：
- 小红书同一账号不允许在多个网页端登录
- 登录 MCP 后，不要在其它网页端登录该账号，否则会被"踢出登录"
- 可以使用移动 App 端查看账号信息

### 3.3 内容获取

#### 3.3.1 获取首页推荐

`list_feeds` 用于获取小红书首页推荐列表（无参数）。

#### 3.3.2 搜索内容

`search_feeds` 用于搜索小红书内容：

| 参数 | 类型 | 必需 | 说明 |
|------|------|------|------|
| `keyword` | string | ✅ | 搜索关键词 |
| `filters.sort_by` | string | 可选 | 排序依据：`综合`（默认）/ `最新` / `最多点赞` / `最多评论` / `最多收藏` |
| `filters.note_type` | string | 可选 | 笔记类型：`不限`（默认）/ `视频` / `图文` |
| `filters.publish_time` | string | 可选 | 发布时间：`不限`（默认）/ `一天内` / `一周内` / `半年内` |
| `filters.search_scope` | string | 可选 | 搜索范围：`不限`（默认）/ `已看过` / `未看过` / `已关注` |
| `filters.location` | string | 可选 | 位置距离：`不限`（默认）/ `同城` / `附近` |

#### 3.3.3 获取帖子详情

`get_feed_detail` 用于获取帖子详情：

| 参数 | 类型 | 必需 | 说明 |
|------|------|------|------|
| `feed_id` | string | ✅ | 帖子 ID |
| `xsec_token` | string | ✅ | 安全令牌 |
| `load_all_comments` | boolean | 可选 | 是否加载全部评论，默认 false 仅返回前 10 条一级评论 |
| `limit` | number | 可选 | 限制加载的一级评论数量，默认 20 |
| `click_more_replies` | boolean | 可选 | 是否展开二级回复，默认 false |
| `reply_limit` | number | 可选 | 跳过回复数过多的评论阈值，默认 10 |
| `scroll_speed` | string | 可选 | 滚动速度：`slow` / `normal` / `fast` |

### 3.4 评论互动

#### 3.4.1 发表评论

`post_comment_to_feed` 用于发表评论到小红书帖子：

| 参数 | 类型 | 必需 | 说明 |
|------|------|------|------|
| `feed_id` | string | ✅ | 帖子 ID |
| `xsec_token` | string | ✅ | 安全令牌 |
| `content` | string | ✅ | 评论内容 |

#### 3.4.2 回复评论

`reply_comment_in_feed` 用于回复帖子下的指定评论：

| 参数 | 类型 | 必需 | 说明 |
|------|------|------|------|
| `feed_id` | string | ✅ | 帖子 ID |
| `xsec_token` | string | ✅ | 安全令牌 |
| `content` | string | ✅ | 回复内容 |
| `comment_id` 或 `user_id` | string | ✅ | 评论 ID 或用户 ID（至少提供一个） |

### 3.5 点赞与收藏

#### 3.5.1 点赞

`like_feed` 用于点赞或取消点赞：

| 参数 | 类型 | 必需 | 说明 |
|------|------|------|------|
| `feed_id` | string | ✅ | 帖子 ID |
| `xsec_token` | string | ✅ | 安全令牌 |
| `unlike` | boolean | 可选 | true 为取消点赞，默认为点赞 |

#### 3.5.2 收藏

`favorite_feed` 用于收藏或取消收藏：

| 参数 | 类型 | 必需 | 说明 |
|------|------|------|------|
| `feed_id` | string | ✅ | 帖子 ID |
| `xsec_token` | string | ✅ | 安全令牌 |
| `unfavorite` | boolean | 可选 | true 为取消收藏，默认为收藏 |

### 3.6 用户信息

`user_profile` 用于获取用户个人主页信息：

| 参数 | 类型 | 必需 | 说明 |
|------|------|------|------|
| `user_id` | string | ✅ | 用户 ID |
| `xsec_token` | string | ✅ | 安全令牌 |

---

## §4 安装与部署

### 4.1 方案 A：下载预编译二进制文件（推荐）

#### 4.1.1 下载程序

从 [GitHub Releases](https://github.com/xpzouying/xiaohongshu-mcp/releases) 下载对应平台的二进制文件：

**MCP 主程序：**

| 平台 | 文件名 |
|------|--------|
| macOS Apple Silicon | `xiaohongshu-mcp-darwin-arm64` |
| macOS Intel | `xiaohongshu-mcp-darwin-amd64` |
| Windows x64 | `xiaohongshu-mcp-windows-amd64.exe` |
| Linux x64 | `xiaohongshu-mcp-linux-amd64` |

**登录工具：**

| 平台 | 文件名 |
|------|--------|
| macOS Apple Silicon | `xiaohongshu-login-darwin-arm64` |
| macOS Intel | `xiaohongshu-login-darwin-amd64` |
| Windows x64 | `xiaohongshu-login-windows-amd64.exe` |
| Linux x64 | `xiaohongshu-login-linux-amd64` |

#### 4.1.2 安装步骤

```bash
# 1. 赋予执行权限
chmod +x xiaohongshu-mcp-darwin-arm64
chmod +x xiaohongshu-login-darwin-arm64

# 2. 运行登录工具
./xiaohongshu-login-darwin-arm64

# 3. 启动 MCP 服务（无头模式，无浏览器界面）
./xiaohongshu-mcp-darwin-arm64

# 4. 或者启动 MCP 服务（非无头模式，有浏览器界面）
./xiaohongshu-mcp-darwin-arm64 -headless=false
```textbash
# 设置代理后启动
XHS_PROXY=http://user:pass@proxy:port ./xiaohongshu-mcp-darwin-arm64

# 支持 HTTP/HTTPS/SOCKS5 代理
# 日志中会自动隐藏代理的认证信息
```textbash
# 克隆仓库
git clone https://github.com/xpzouying/xiaohongshu-mcp.git
cd xiaohongshu-mcp

# 编译 MCP 主程序
go build -o xiaohongshu-mcp .

# 编译登录工具
go build -o xiaohongshu-login ./cmd/login

# 运行登录
./xiaohongshu-login

# 运行 MCP 服务
./xiaohongshu-mcp
```textbash
# 拉取镜像
docker pull xpzouying/xiaohongshu-mcp:latest

# 运行容器
docker run -d \
  --name xiaohongshu-mcp \
  -p 18060:18060 \
  xpzouying/xiaohongshu-mcp:latest

# 非无头模式
docker run -d \
  --name xiaohongshu-mcp \
  -p 18060:18060 \
  xpzouying/xiaohongshu-mcp:latest \
  -headless=false
```textbash
# 添加 HTTP MCP 服务器
claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp

# 检查 MCP 是否添加成功
claude mcp list
```textbash
npx @modelcontextprotocol/inspector
```text
帮我写一篇帖子发布到小红书上，配图为：https://cn.bing.com/th?id=OHR.MaoriRock_EN-US6499689741_UHD.jpg&w=3840
图片是："纽西兰陶波湖的Ngātoroirangi矿湾毛利岩雕（© Joppi Getty Images）"
使用 xiaohongshu-mcp 进行发布。
```text
帮我写一篇关于春天的帖子发布到小红书上，使用这些本地图片：
- /Users/username/Pictures/spring_flowers.jpg
- /Users/username/Pictures/cherry_blossom.jpg
使用 xiaohongshu-mcp 进行发布。
```text
帮我写一篇关于美食制作的视频发布到小红书上，使用这个本地视频文件：
- /Users/username/Videos/cooking_tutorial.mp4
使用 xiaohongshu-mcp 的视频发布功能。
```text
帮我搜索一下最近关于 AI 写作的小红书帖子，看看有哪些热门内容。
```text
帮我给我刚发布的那篇小红书帖子添加一条评论："写得真好，收藏了！"