mcpField
X
xhs

xhs

github.com/pearl799Marketing & growth535 installsUpdated 35w ago
Repository

About xhs

xhs is an automation skill for creating and managing Xiaohongshu posts through command-line scripts for login, trend collection, content generation, and publishing. It supports workflows that preview and confirm content before publication.

Key features

  1. 01Check login status and start login
  2. 02Collect category trends or keyword results
  3. 03Generate copy and images
  4. 04Preview or automatically publish posts

Use cases

  1. 01Find topics by checking Xiaohongshu trends
  2. 02Generate image-and-text content for review
  3. 03Publish approved posts through scripts

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/pearl799/openclaw-skill-xhs --skill xhs

After installing, type/xhsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

README_CN.md
config.example.json
.gitignore
install.sh
README.md
uninstall.sh
scripts/
xhs_auth.py
xhs_login_persistent.py
configure_openclaw.py
xhs_generate_content.py
xhs_auto_pipeline.py
xhs_status.py
xhs_trending.py
xhs_publish.py
xhs-toolkit/
.all-contributorsrc
LICENSE
.gitignore
README.md
env_example
pyproject.toml
requirements.txt
install_deps.py
install.sh
xhs-toolkit/.github/workflows/
contributors.yml
xhs-toolkit/docs/
小红书话题标签自动化实现方案.md
xhs-toolkit/src/
__init__.py
xhs-toolkit/src/auth/
__init__.py
cookie_manager.py
smart_auth_server.py
xhs-toolkit/src/cli/
__init__.py

Details

From the project README

小红书自动化 (XHS)

重要：所有小红书操作必须使用 exec 工具执行以下命令，不要用 browser 工具打开网页。

环境变量

变量必填说明
XHS_TOOLKIT_DIR是xhs-toolkit 项目路径（git clone https://github.com/pearl799/xhs-toolkit）
IMAGE_API_KEY是图片生成 API Key（任意 OpenAI 兼容的图片生成服务）
IMAGE_BASE_URL是图片生成 API Base URL（例如 https://openrouter.ai/api/v1/chat/completions）
IMAGE_MODEL是图片生成模型名称（例如 google/gemini-3-pro-image-preview）
OPENCLAW_GATEWAY_TOKEN否OpenClaw Gateway token（文案生成用，如果 gateway 开了 auth）
XHS_DATA_DIR否数据目录，默认 ~/.openclaw/skills/xhs/data

命令

检查登录状态：

uv run --project $XHS_TOOLKIT_DIR {baseDir}/scripts/xhs_status.py

登录小红书（用户说"登录小红书"/"xhs login"时）：

uv run --project $XHS_TOOLKIT_DIR {baseDir}/scripts/xhs_auth.py

会在 Mac 桌面打开 Chrome，告知用户去扫码。

发布笔记（用户说"发小红书"/"发布笔记"时）：

uv run --project $XHS_TOOLKIT_DIR {baseDir}/scripts/xhs_publish.py --title "标题" --content "正文" --images "/path/1.png,/path/2.png" --topics "话题1,话题2"

发布前先用 xhs_status.py 检查登录。--images 必须是本地文件路径，1-9 张。--dry-run 可验证不发布。

爬取热点（用户说"小红书热点"/"trending"/"今天什么热门"时）：

uv run --project $XHS_TOOLKIT_DIR {baseDir}/scripts/xhs_trending.py --category "综合" --limit 20

支持 --keyword "AI" 搜索。分类：综合/时尚/美食/旅行/美妆/科技/健身/宠物/家居/教育。

AI 生成内容（用户说"生成小红书"/"帮我生成"时）：

uv run --project $XHS_TOOLKIT_DIR {baseDir}/scripts/xhs_generate_content.py --topic "主题" --style "干货分享" --image-count 4

生成文案+配图。生成后发给用户预览，确认后再调 xhs_publish.py 发布。

全自动流水线（用户说"自动发布"/"全自动"时）：

uv run --project $XHS_TOOLKIT_DIR {baseDir}/scripts/xhs_auto_pipeline.py --mode preview

热点→选题→生成→预览/发布。--mode auto 直接发布。

所有脚本输出 JSON，解析 status 字段判断结果。MEDIA: 行表示附件图片。

注意事项

  • 每个命令只需调用一次，等待结果即可，不要重复执行
  • 脚本输出的 JSON 是给你解析用的，转述关键信息给用户即可，不要原样转发
  • 生成内容后，把标题、正文、话题发给用户预览，图片用 MEDIA 行的路径作为附件
  • 不要在一次回复中发送多条消息，合并为一条

Comments

Markdown supported