# Post to Xiaohongshu

Publishes image posts or long articles to Xiaohongshu from content or a web URL.

- Repository: https://github.com/xpzouying/xiaohongshu-mcp (16723 stars)
- Category: Marketing
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add xpzouying/xiaohongshu-mcp --skill post-to-xhs -g -a claude-code -y`
Codex: `npx skills add xpzouying/xiaohongshu-mcp --skill post-to-xhs -g -a codex -y`
Cursor: `npx skills add xpzouying/xiaohongshu-mcp --skill post-to-xhs -g -a cursor -y`
Gemini CLI: `npx skills add xpzouying/xiaohongshu-mcp --skill post-to-xhs -g -a gemini-cli -y`

## Description

小红书内容发布技能。支持两种发布模式：(1) 上传图文模式 - 图片+短文；(2) 写长文模式 - 长篇文章+排版模板。 支持两种输入方式：用户提供完整内容和图片/图片URL，直接发布；或提供网页URL，自动提取内容和图片。 用户说"发长文"时使用长文模式，否则默认图文模式。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 小红书内容发布

根据用户输入自动判断发布方式和发布模式，简化发布流程。

## 发布模式

- **上传图文**（默认）：图片 + 短文，适合日常分享
- **写长文**：长篇文章 + 排版模板选择，适合深度内容。用户明确说"发长文"时使用

## 工作流程

```
用户输入
    │
    ├─ 完整内容 + 图片/图片URL → 判断模式 → 发布流程
    │
    └─ 网页 URL → WebFetch 提取内容和图片
                      │
                      ├─ 有图片 → 适当总结内容 → 判断模式 → 发布流程
                      │
                      └─ 无图片 → 提示用户手动下载图片
                                  │
                                  └─ 用户提供图片后 → 发布流程
```

## Step 1: 判断输入类型

根据用户输入判断：

- **完整内容模式**：用户提供了标题、正文内容、以及图片（本地路径或URL）
- **URL 提取模式**：用户只提供了一个网页 URL

如果不确定，询问用户。

## Step 2: 处理内容

### 完整内容模式

直接使用用户提供的标题和正文，跳到 Step 3。

### URL 提取模式

1. 使用 WebFetch 提取网页内容
2. 提取关键信息：标题、正文、图片URL
3. 适当总结内容，保持：
   - 关键信息完整
   - 语言自然流畅
   - 适合小红书阅读习惯

#### 图片提取失败处理

如果从网页中提取不到图片URL，或图片URL无法访问，**必须**：

1. 告知用户图片提取失败
2. 提供原网页链接，请用户手动访问
3. 指导用户：
   - 在浏览器中打开原网页
   - 右键点击想要的图片 → "图片另存为" 或 "复制图片地址"
   - 将保存的图片路径或复制的图片URL提供给我
4. 等待用户提供图片后再继续发布流程

**示例提示语**：
```
从网页中未能提取到可用的图片。请手动获取：

1. 打开原文链接：[URL]
2. 找到合适的配图，右键另存为本地，或复制图片地址
3. 将图片路径或URL发给我

拿到图片后我们继续发布。
```

## Step 3: 内容检查

### 标题检查

标题长度必须 ≤ 38，计算规则：
- 中文字符和中文标点（《》、，。等）：每个计 2
- 英文字母/数字/空格/ASCII标点：每个计 1

如果超长，自动生成符合长度要求的新标题，保持语义一致。

### 正文格式

- 段落之间使用双换行分隔
- 语言自然，避免机器翻译感
- 简体中文

## Step 4: 发布到小红书

完整发布流程参考: [references/publish-workflow.md](references/publish-workflow.md)

### 4.1 用户确认内容

通过 `AskUserQuestion` 向用户展示即将发布的内容（标题、正文、图片），获得明确确认后再继续。

### 4.2 选择发布模式

通过 `AskUserQuestion` 让用户选择发布模式：

- **无头模式**（推荐）：后台运行，速度快，无浏览器窗口。发布完成后直接报告结果。
- **有窗口模式**：显示浏览器窗口，可以预览内容。需要用户确认后再点击发布。

```
AskUserQuestion 示例：
问题：选择发布模式
选项：
  - 无头模式（推荐）：后台快速发布，无需预览
  - 有窗口模式：显示浏览器，可预览确认
```

### 4.3 写入临时文件

将标题和正文写入临时 UTF-8 文本文件。不要在 `python -c` 中内联中文文本。

### 4.4 运行发布（根据模式分流）

#### A. 上传图文模式（默认）

根据用户选择的模式执行发布脚本：

**无头模式**（添加 `--headless` 参数）：
```bash
python "C:\Users\admin\AI\.claude\skills\post-to-xhs\scripts\publish_pipeline.py" --headless --title-file title.txt --content-file content.txt --image-urls "URL1" "URL2"
```

The rest: https://github.com/xpzouying/xiaohongshu-mcp/blob/HEAD/skills/post-to-xhs/SKILL.md