Post to Xiaohongshu (小红书)

Publish image-text notes to Xiaohongshu via a local MCP server (xiaohongshu-mcp). Supports images, tags, visibility control, and scheduled posts.

Prerequisites

Download xiaohongshu-mcp binary from xiaohongshu-mcp releases
Place the binary at a known path (e.g. ~/xiaohongshu-mcp/xiaohongshu-mcp-darwin-arm64)
Configure the path in EXTEND.md (see Preferences below)
Run login once to save cookies: python3 ${SKILL_DIR}/scripts/login.py

Preferences (EXTEND.md)

Check EXTEND.md (priority: project → user):

test -f .baoyu-skills/xhs-studio/EXTEND.md && echo "project"
test -f "$HOME/.baoyu-skills/xhs-studio/EXTEND.md" && echo "user"

Path	Location
`.baoyu-skills/xhs-studio/EXTEND.md`	Project directory
`$HOME/.baoyu-skills/xhs-studio/EXTEND.md`	User home

EXTEND.md schema:

mcp_bin: /path/to/xiaohongshu-mcp-darwin-arm64   # required
mcp_port: 18060                                    # optional, default 18060

If EXTEND.md not found → ask user for mcp_bin path, save EXTEND.md, then continue.

Script Directory

Agent Execution Instructions:

Determine this SKILL.md file's directory path as SKILL_DIR
Script path = ${SKILL_DIR}/scripts/<script-name>.py

Script	Purpose
`scripts/publish.py`	Publish image-text note
`scripts/search.py`	Search trending content
`scripts/login.py`	QR code login

Publishing a Note

python3 ${SKILL_DIR}/scripts/publish.py \
  --title "标题（≤20字）" \
  --content "正文内容" \
  --images /path/to/image1.png /path/to/image2.png \
  --tags "AI工具" "效率神器" \
  --visibility "公开可见"

Parameters:

Parameter	Required	Description
`--title`	✅	标题，最多 20 个中文字
`--content`	✅	正文内容（支持换行）
`--images`	✅	图片路径列表（本地绝对路径或 https:// 链接，最多 18 张）
`--tags`	optional	话题标签，如 `"AI工具" "效率"`
`--visibility`	optional	`公开可见`（默认）/ `仅自己可见` / `仅互关好友可见`
`--schedule`	optional	定时发布，ISO8601 格式：`2026-03-16T20:00:00+08:00`

Searching Trending Content

python3 ${SKILL_DIR}/scripts/search.py "关键词"

Returns top notes with title, author, and like count. Use this for topic research before writing.

Login / Re-login

python3 ${SKILL_DIR}/scripts/login.py

Opens a QR code image. Scan with Xiaohongshu app. Session is saved automatically to cookies.json next to the MCP binary.

Notes

The MCP server starts automatically if not already running
Requests to localhost must bypass any system proxy (NO_PROXY=localhost is set automatically)
Title limit: 20 Chinese characters or equivalent
Image limit: 18 images per post
Scheduled posts: 1 hour to 14 days from now

xhs-studio