mcpField
X
xiaohongshu-upload

xiaohongshu-upload

github.com/dreammis营销与增长15.9k137 次安装6 天前更新
代码仓库

关于 xiaohongshu-upload

面向小红书发布任务的 Skill,通过 `sau` 管理账号 Cookie,并上传视频或图文。它按命令契约执行操作,并在失败时转向故障排查文档。

主要功能

  1. 01登录并刷新账号 Cookie
  2. 02检查 Cookie 有效性
  3. 03上传并发布视频
  4. 04上传并发布图文

适用场景

  1. 01为小红书账号获取或更新 Cookie
  2. 02发布带标题、描述和标签的视频
  3. 03发布带标题、正文和标签的图文

安装

复制下面的命令,在终端中运行。

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

安装后在 Claude Code 中输入/xiaohongshu-upload确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

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

详细介绍

来自项目 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

评论

支持 Markdown