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.
3 stars
0 votes
0 copies
4 views
Added September 9, 2026
toolsbashreactnodedebuggingapi
Works with
cli
api
Security analysis
A92/100
mediumInstalls packages at runtime which could introduce malicious dependencies
Installs into .claude/skills of the current project.
Sponsors
SSkills DirectorySkills Directory
Know which skills are safe — weekly.
SSkills DirectorySkills Directory
Is that skill safe to install?
Are you the author of Xhs Auto Publish?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/lord1egypt-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