xhs-skill-pusher

基于xhs-kit的小红书内容发布技能，提供规范化cookie管理和自动化发布流程。

🎯 核心特性

✅ 规范化Cookie管理

• - 集中存储: 所有cookie保存在 xhscookies/ 目录
• 规范命名: 账号标识描述_日期.json 格式
• 自动转换: 支持原始cookie字符串和JSON格式自动转换
• 状态管理: active.json 软链接指向当前激活cookie

✅ 自动化发布流程

• - 完整验证: 状态检查 → debug验证 → 实际发布
• 错误处理: 清晰的错误提示和恢复建议
• 多账号支持: 一键切换不同账号
• 定时发布: 支持定时发布功能

✅ 简单易用

• - 无环境变量: 完全基于文件路径，避免环境变量混乱
• 统一接口: 一个 --cookie 参数解决所有问题
• 透明操作: 基于实际文件，没有隐藏映射

📦 安装

1. 安装技能

bash clawhub install xhs-skill-pusher cd skills/xhs-skill-pusher npm install

2. 安装Python依赖

bash

创建虚拟环境

python3 -m venv xhs-env source xhs-env/bin/activate

安装xhs-kit

pip install xhs-kit

安装Playwright浏览器

playwright install chromium

安装其他依赖

pip install pillow requests markdown pyyaml

3. 初始化Cookie目录

bash mkdir -p xhs_cookies/archive

🚀 快速开始

1. 保存新Cookie

bash

获取cookie字符串后，规范化保存

./xhssavecookie.sh --name new_main --cookie a1=xxx;webId=yyy;... --set-active

2. 查看所有Cookie

bash ./xhs_final.sh --list-cookies

3. 发布内容

bash ./xhsfinal.sh --cookie xhscookies/active.json --title 标题 --content 内容 --image 图片.jpg

📁 项目结构

xhs-skill-pusher/
├── SKILL.md # 本文档
├── package.json # Node.js依赖
├── bin/
│ └── xhs-pusher.mjs # CLI工具
├── scripts/ # 发布脚本
│ ├── xhssavecookie.sh # 保存cookie脚本
│ ├── xhs_final.sh # 主发布脚本
│ ├── xhs_manage.sh # cookie管理脚本
│ └── xhs_simple.sh # 简单发布脚本
├── xhs_cookies/ # Cookie目录（自动创建）
│ ├── active.json # 当前激活cookie（软链接）
│ ├── newmain20260314.json # 示例cookie文件
│ └── archive/ # 归档目录
└── docs/ # 文档
├── XHSFINALSOLUTION.md # 完整解决方案
└── QUICK_START.md # 快速开始指南

🔧 脚本说明

核心脚本

1. xhssavecookie.sh - 保存Cookie

bash

保存并设置为激活

./scripts/xhssavecookie.sh --name new_main --cookie a1=xxx;... --set-active

从文件保存

./scripts/xhssavecookie.sh --name oldbackup --file rawcookie.txt

2. xhs_final.sh - 主发布脚本

bash

基本发布

./scripts/xhsfinal.sh --cookie xhscookies/active.json --title ... --image ...

查看cookie列表

./scripts/xhs_final.sh --list-cookies

检查状态

./scripts/xhsfinal.sh --cookie xhscookies/active.json --check-status

3. xhs_manage.sh - Cookie管理

bash

查看所有cookie

./scripts/xhs_manage.sh list

查看cookie信息

./scripts/xhsmanage.sh info newmain_20260314

切换到指定cookie

./scripts/xhsmanage.sh use newmain

查看状态

./scripts/xhs_manage.sh status

清理过期cookie

./scripts/xhs_manage.sh clean --keep-days 7

Node.js CLI工具

xhs-pusher - 统一CLI接口

bash

查看帮助

node ./bin/xhs-pusher.mjs --help

管理cookie

node ./bin/xhs-pusher.mjs cookie list node ./bin/xhs-pusher.mjs cookie save --name test --cookie a1=xxx;...

发布内容

node ./bin/xhs-pusher.mjs publish --title ... --content ... --image ...

📋 Cookie命名规范

格式

账号标识描述日期.json

字段说明

• - 账号标识: new(新账号), old(旧账号), test(测试), backup(备份)
• 描述: main(主账号), backup(备份), temp(临时)
• 日期: 20260314(年月日), today(今天), yesterday(昨天)

示例

newmain20260314.json # 新主账号，2026-03-14获取
oldbackuptoday.json # 旧备份账号，今天获取
test_temp.json # 测试临时账号

🎯 工作流程

获取新Cookie后

bash

1. 规范化保存

./scripts/xhssavecookie.sh --name new_main --cookie a1=xxx;webId=yyy;... --set-active

2. 自动成为激活cookie，可以直接使用

./scripts/xhsfinal.sh --cookie xhscookies/active.json --title 测试 --image test.jpg

日常发布

bash

使用当前激活cookie发布

./scripts/xhs_final.sh \ --cookie xhs_cookies/active.json \ --title 每日更新 \ --content 今日内容... \ --image daily_photo.jpg \ --tag 日常 \ --tag 分享

多账号管理

bash

1. 查看可用cookie

./scripts/xhs_final.sh --list-cookies

2. 切换到指定cookie

./scripts/xhsmanage.sh use oldbackup

3. 使用切换后的cookie发布

./scripts/xhsfinal.sh --cookie xhscookies/active.json --title ... --image ...

🔧 高级功能

定时发布

bash ./scripts/xhs_final.sh \ --cookie xhs_cookies/active.json \ --title 定时发布 \ --content 内容 \ --image photo.jpg \ --schedule 2026-03-14T14:00:00+08:00

显示浏览器窗口

bash ./scripts/xhs_final.sh \ --cookie xhs_cookies/active.json \ --title 测试 \ --content 内容 \ --image photo.jpg \ --show-browser

仅验证不发布

bash ./scripts/xhs_final.sh \ --cookie xhs_cookies/active.json \ --title 测试 \ --content 内容 \ --image photo.jpg \ --debug-only

🛠️ 维护命令

初始化

bash

创建cookie目录结构

mkdir -p xhs_cookies/archive

导入现有Cookie

bash

导入工作空间的cookie文件

cp /path/to/cookies.json xhscookies/newmain_$(date +%Y%m%d).json

设置为激活

ln -sf newmain$(date +%Y%m%d).json xhs_cookies/active.json

备份和恢复

bash

备份所有cookie

tar -czf xhscookiesbackup$(date +%Y%m%d).tar.gz xhscookies/

恢复备份

tar -xzf xhscookiesbackup_20260314.tar.gz

⚠️ 注意事项

1. 1. 定期检查: cookie会过期，建议每周检查状态
2. 重要备份: 重要cookie定期备份到安全位置
3. 命名规范: 遵循命名规范，便于管理
4. 权限安全: cookie包含敏感信息，注意文件权限