mcpField
X
xiaohongshu-upload

xiaohongshu-upload

github.com/dreammisMarketing & growth15.9k137 installsUpdated 6d ago
Repository

About xiaohongshu-upload

A skill for publishing to Xiaohongshu through `sau`. It manages account cookies and uploads videos or image-and-text posts, with troubleshooting guidance for failed commands.

Key features

  1. 01Log in and refresh account cookies
  2. 02Check cookie validity
  3. 03Upload and publish videos
  4. 04Upload and publish image-and-text posts

Use cases

  1. 01Obtain or refresh cookies for a Xiaohongshu account
  2. 02Publish a video with a title, description, and tags
  3. 03Publish an image-and-text post with a title, note, and tags

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/dreammis/social-auto-upload --skill xiaohongshu-upload

After installing, type/xiaohongshu-uploadin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
cli-contract.md
runtime-requirements.md
troubleshooting.md
scripts/examples/
xiaohongshu_cli_template.py
xiaohongshu_commands.ps1
xiaohongshu_commands.sh

Details

From the project README

小红书上传 Skill

优先把 sau 作为主接口。

不要假设当前环境一定能读取仓库源码。 不要一开始就去读 uploader/。 只有在命令不可用或 CLI 执行失败时，才回退到故障排查说明。

功能概览

功能命令入口说明
小红书登录sau xiaohongshu login --account <name>生成或刷新指定账号的 cookie
cookie 校验sau xiaohongshu check --account <name>检查指定账号 cookie 是否有效
视频上传sau xiaohongshu upload-video ...上传并发布小红书视频
图文上传sau xiaohongshu upload-note ...上传并发布小红书图文

元数据约定：

  • 视频使用 title + desc + tags
  • 图文使用 title + note + tags

默认工作流

  1. 先确认 references/runtime-requirements.md 里的运行前提。
  2. 再确认 references/cli-contract.md 里的命令契约。
  3. 执行匹配的 sau xiaohongshu ... 命令。
  4. 如果命令失败，再看 references/troubleshooting.md。

支持动作

  • 使用 sau xiaohongshu login --account <name> 登录小红书
  • 使用 sau xiaohongshu check --account <name> 校验 cookie 是否有效
  • 使用 sau xiaohongshu upload-video ... 上传小红书视频
  • 使用 sau xiaohongshu upload-note ... 上传小红书图文

命令选择建议

  • 当用户需要新的 cookie，或现有 cookie 已失效时，使用 login
  • 当用户只需要确认 cookie 状态时，使用 check
  • 当用户要发布视频时，使用 upload-video
  • 当用户要发布图文时，使用 upload-note

执行前检查

  • 先确认当前 shell 里是否可以调用 sau
  • 如果 sau 不可用，按 references/runtime-requirements.md 里的回退方式处理
  • 当用户明确指定无头或有头模式时，显式传 --headless 或 --headed
  • 只有用户明确要求定时发布时，才使用 --schedule
  • 如果登录流程生成了本地二维码图片，不要只把图片路径告诉用户
  • 二维码图片本身就是给用户扫码的，优先直接把本地图片展示/发送给用户

参考文档

  • 运行前提：references/runtime-requirements.md
  • CLI 契约：references/cli-contract.md
  • 故障排查：references/troubleshooting.md

Comments

Markdown supported