xhs-comment

name	xhs_comment
description	Universal Xiaohongshu skill via VibeSurf. Use when the user asks to (1) comment on a target account's first post, (2) browse feed/search results and comment multiple posts, or (3) draft/publish a Xiaohongshu post.
homepage	https://github.com/vibesurf-ai/VibeSurf
metadata	{"moltbot":{"emoji":"📕","requires":{"bins":["python3","curl","jq"]}}}

XHS Universal Skill

Use one script with three subcommands:

• comment-user-first: search a target user and comment on the first matched post
• browse-comment: browse feed/search results and comment multiple posts
• post: draft or publish a Xiaohongshu post via browser-use automation

Prerequisites

• VibeSurf is running (default endpoint: http://127.0.0.1:9335)
• Xiaohongshu account is logged in inside VibeSurf browser session
• python3 is available
• curl and jq are available (used by automation wrappers)

Quick dependency check:

{baseDir}/scripts/check_dependencies.sh

Command Entrypoints

Main script:

python3 {baseDir}/scripts/xhs_universal.py <subcommand> [args...]

Backward-compatible alias (same as comment-user-first):

{baseDir}/scripts/xhs_comment.sh --nickname "发哥不发愁" --comment "路过支持一下"

1) Comment Target User's First Post

python3 {baseDir}/scripts/xhs_universal.py comment-user-first \
  --nickname "发哥不发愁" \
  --comment "发哥好，路过支持一下！"

Dry run:

python3 {baseDir}/scripts/xhs_universal.py comment-user-first \
  --nickname "发哥不发愁" \
  --comment "发哥好，路过支持一下！" \
  --dry-run

2) Browse Feed and Comment

Browse recommendations and comment up to 2 posts:

python3 {baseDir}/scripts/xhs_universal.py browse-comment \
  --comment "路过支持一下，内容很有帮助" \
  --max-posts 12 \
  --max-comments 2

Filter by keyword and dry-run:

python3 {baseDir}/scripts/xhs_universal.py browse-comment \
  --keyword "AI" \
  --comment "路过支持一下，感谢分享" \
  --source auto \
  --dry-run

3) Draft or Publish a Post

Default is safe draft-only mode (will not click publish):

python3 {baseDir}/scripts/xhs_universal.py post \
  --title "今天的AI效率工作流" \
  --body "分享 3 个我最近在用的提效技巧..."

Attach images during post flow:

python3 {baseDir}/scripts/xhs_universal.py post \
  --title "产品更新" \
  --body "本周版本更新如下..." \
  --image /abs/path/cover.png \
  --image /abs/path/detail.png

Actual publish requires explicit confirmation:

python3 {baseDir}/scripts/xhs_universal.py post \
  --title "正式发布测试" \
  --body "这是一次自动化发布测试" \
  --publish \
  --confirm PUBLISH

Notes

• post subcommand uses execute_browser_use_agent because Xiaohongshu publish API is not exposed as a stable direct website-api method.
• Prefer dry-run first for any high-risk action.
• If website-api calls are slow, add --api-timeout 30 to fail fast and diagnose login/session issues.
• xhs_openclaw_celebrate.sh now uses built-in default image (assets/openclaw_skill_default.png) and no longer depends on external nano-banana skill.