Xhs Auto Publish

---
name: xhs-auto-publish
description: Automate publishing image+text posts (图文笔记) on Xiaohongshu (小红书) creator platform. Use when the user wants to publish a Xiaohongshu post, create XHS content, auto-post to 小红书, or schedule social media posts for the Chinese market. Supports multi-image upload, title, body text, and hashtags. Requires a browser with CDP (Chrome DevTools Protocol) already logged in to creator.xiaohongshu.com.
---

# 小红书自动发布 (Xiaohongshu Auto-Publish)

Publish image+text posts to Xiaohongshu via browser automation. No API key needed — uses CDP to control an already-logged-in browser.

## Prerequisites

1. **playwright-core** installed: `npm install -g playwright-core`
2. **A Chromium browser** running with CDP (remote debugging) enabled
3. **Logged in** to `creator.xiaohongshu.com` in that browser

For **OpenClaw** users: the managed browser (`profile="openclaw"`) provides CDP automatically at `http://127.0.0.1:18800`.

## Quick Start

```bash
node scripts/publish.js \
  --title "你的标题（20字以内）" \
  --body "正文内容（1000字以内）" \
  --images cover.png,slide2.png,slide3.png \
  --hashtags "AI绘画,独立开发" \
  --cdp-url http://127.0.0.1:18800
```

This auto-publishes the post. Add `--dry-run` to preview without publishing.

## Options

| Flag | Description | Required |
|------|-------------|----------|
| `--title <text>` | Post title, max 20 Chinese chars | ✅ |
| `--body <text>` | Post body, max 1000 chars | ✅* |
| `--body-file <path>` | Read body from a text file | ✅* |
| `--images <paths>` | Comma-separated image paths (1-18) | ✅ |
| `--hashtags <tags>` | Comma-separated hashtags (auto-prefixed with #) | Optional |
| `--cdp-url <url>` | CDP endpoint (default: `http://127.0.0.1:9222`, or `XHS_CDP_URL` env) | Optional |
| `--dry-run` | Preview only, skip publish (default: auto-publish) | Optional |
| `--screenshot <path>` | Save preview screenshot path | Optional |

*One of `--body` or `--body-file` is required (unless using `--hashtags` alone).

## Workflow

1. Connects to browser via CDP
2. Navigates to `creator.xiaohongshu.com/publish/publish`
3. Clicks "上传图文" (upload images) tab
4. Uploads all images via file input
5. Sets title (native input value setter for React compatibility)
6. Sets body (innerHTML on TipTap/ProseMirror editor)
7. Takes preview screenshot
8. Optionally clicks "发布" (publish) button

## Tips

- **Title**: Keep under 20 chars. Hook-style titles work best (e.g. "用AI画塔罗牌也太好看了吧")
- **Body**: Short paragraphs with emoji. 小红书 is scroll-heavy — hooks > long text
- **Images**: First image is the cover. Use 3:4 ratio (1242×1660) for best display
- **Hashtags**: Add 3-5 relevant tags for discoverability
- **Preview first**: Always run without `--publish` first to verify via screenshot

## Troubleshooting

| Problem | Solution |
|---------|----------|
| "Cannot connect to CDP" | Ensure browser is running with remote debugging. For OpenClaw: check `openclaw browser status` |
| "Redirected" / not logged in | Open the browser manually and log in to creator.xiaohongshu.com |
| Title input not found | Page may not have loaded. Increase wait time or check network |
| Images fail to upload | Ensure images are PNG/JPG/WebP and under 20MB each |

## XHS Content Best Practices

- **Short hook titles** > descriptive titles (20 char limit forces creativity)
- **3-6 images** per post is the sweet spot
- **First image = cover** — make it eye-catching
- **Short punchy paragraphs** with emoji — not walls of text
- **End with a question** to drive comments
- **3-5 hashtags** for discovery, more feels spammy