Baoyu Post To Xhs

Posts image-text notes to Xiaohongshu (小红书) via Chrome CDP. Supports uploading multiple images, filling title/description, adding topics, and optional auto-s...

Post to Xiaohongshu (小红书)

Posts image-text notes to Xiaohongshu via real Chrome browser (bypasses anti-bot detection).

Language

Match user's language: Respond in the same language the user uses. If user writes in Chinese, respond in Chinese. If user writes in English, respond in English.

Script Directory

Important: All scripts are located in the scripts/ subdirectory of this skill.

Agent Execution Instructions:

1. Determine this SKILL.md file's directory path as {baseDir}
2. Script path = {baseDir}/scripts/<script-name>.ts
3. Replace all {baseDir} in this document with the actual path
4. Resolve ${BUN_X} runtime: if bun installed → bun; if npx available → npx -y bun; else suggest installing bun

Script Reference:

Script	Purpose
scripts/xhs-browser.ts	Image-text note publishing
scripts/check-permissions.ts	Verify environment & permissions

Preferences (EXTEND.md)

Check EXTEND.md existence (priority order):

# macOS, Linux, WSL, Git Bash
test -f .baoyu-skills/baoyu-post-to-xhs/EXTEND.md && echo "project"
test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-post-to-xhs/EXTEND.md" && echo "xdg"
test -f "$HOME/.baoyu-skills/baoyu-post-to-xhs/EXTEND.md" && echo "user"

# PowerShell (Windows)
if (Test-Path .baoyu-skills/baoyu-post-to-xhs/EXTEND.md) { "project" }
$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
if (Test-Path "$xdg/baoyu-skills/baoyu-post-to-xhs/EXTEND.md") { "xdg" }
if (Test-Path "$HOME/.baoyu-skills/baoyu-post-to-xhs/EXTEND.md") { "user" }

┌──────────────────────────────────────────────────────┬───────────────────┐ │ Path │ Location │ ├──────────────────────────────────────────────────────┼───────────────────┤ │ .baoyu-skills/baoyu-post-to-xhs/EXTEND.md │ Project directory │ ├──────────────────────────────────────────────────────┼───────────────────┤ │ $HOME/.baoyu-skills/baoyu-post-to-xhs/EXTEND.md │ User home │ └──────────────────────────────────────────────────────┴───────────────────┘

┌───────────┬───────────────────────────────────────────────────────────────────────────┐ │ Result │ Action │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ Found │ Read, parse, apply settings │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ Not found │ Use defaults │ └───────────┴───────────────────────────────────────────────────────────────────────────┘

EXTEND.md Supports: Default Chrome profile path

Recommended EXTEND.md example:

chrome_profile_path: /path/to/chrome/profile

Prerequisites

• Google Chrome or Chromium
• bun runtime
• First run: log in to Xiaohongshu manually in the browser (session saved)

Pre-flight Check (Optional)

Before first use, suggest running the environment check. User can skip if they prefer.

${BUN_X} {baseDir}/scripts/check-permissions.ts

Checks: Chrome, profile isolation, Bun.

If any check fails, provide fix guidance per item:

Check	Fix
Chrome	Install Chrome or set XHS_BROWSER_CHROME_PATH env var
Profile dir	Shared profile at baoyu-skills/chrome-profile
Bun runtime	npm install -g bun or brew install oven-sh/bun/bun (macOS)

---

Image-Text Note Posting (图文笔记)

${BUN_X} {baseDir}/scripts/xhs-browser.ts --title "标题" --content "描述" --image img1.png --image img2.png
${BUN_X} {baseDir}/scripts/xhs-browser.ts --markdown article.md --images ./photos/
${BUN_X} {baseDir}/scripts/xhs-browser.ts --title "标题" --content "描述" --images ./photos/ --topic "话题1" --topic "话题2" --submit

Parameters:

Parameter	Description
--title <text>	Note title (max 20 chars, auto-compressed)
--content <text>	Note description (max 1000 chars, auto-compressed)
--markdown <path>	Markdown file for title/content extraction
--image <path>	Image file (repeatable, max 18)
--images <dir>	Directory containing images (PNG/JPG/WEBP)
--topic <text>	Topic/hashtag (repeatable)
--submit	Actually publish (default: preview only)
--profile <dir>	Custom Chrome profile directory
--help	Show help

Note: By default the script only fills content into the browser. User reviews and publishes manually. Add --submit to auto-publish.

Image Limits: Up to 18 images per note. Supported formats: PNG, JPG, JPEG, WEBP, GIF.

---

Publishing Workflow

Step 1: Prepare Content

Input Type	Detection	Action
Markdown file	--markdown <path>	Extract title from H1, content from body
Direct input	--title + --content	Use as-is
Images dir	--images <dir>	Load all images from directory

Step 2: Launch Browser & Login

1. Launch Chrome with dedicated profile
2. Navigate to https://creator.xiaohongshu.com/publish/publish
3. If not logged in → prompt user to scan QR code
4. Wait for login (up to 2 minutes timeout)

Step 3: Upload Images

1. Find the image upload area on the publish page
2. Use DOM.setFileInputFiles or file chooser interception to upload images
3. Wait for upload completion (verify thumbnail count)

Step 4: Fill Content

1. Fill title in the title input
2. Fill description/content in the editor
3. Add topics/hashtags if provided

Step 5: Submit or Preview

• Default: leave browser open for user review
• With --submit: click the publish button

---

Troubleshooting

Issue	Solution
Chrome debug port not ready	Kill existing Chrome CDP instances and retry
Not logged in	First run opens browser — scan QR code to log in
Chrome not found	Set XHS_BROWSER_CHROME_PATH env var
Image upload fails	Check file exists and is a valid image format
Title too long	Title auto-compressed to 20 chars
Content too long	Content auto-compressed to 1000 chars

Chrome debug port not ready

If a script fails with Chrome debug port not ready, kill existing Chrome CDP instances first, then retry:

pkill -f "Chrome.*remote-debugging-port" 2>/dev/null; sleep 2

# PowerShell (Windows)
Get-Process chrome -ErrorAction SilentlyContinue | Where-Object { $_.CommandLine -match 'remote-debugging-port' } | Stop-Process -Force
Start-Sleep -Seconds 2

Important: This should be done automatically — when encountering this error, kill Chrome CDP instances and retry the command without asking the user.

Notes

• First run: manual login required (session persists in Chrome profile)
• All scripts fill content into the browser; user must review and publish manually unless --submit is used
• Cross-platform: macOS, Linux, Windows
• Xiaohongshu publish page: https://creator.xiaohongshu.com/publish/publish

Extension Support

Custom configurations via EXTEND.md. See Preferences section for paths and supported options.