xhs-kit 小红书发布技能
使用 xhs-kit Python库实现高效、稳定的小红书内容发布，无需打开浏览器，支持多账号管理和定时发布。
🎯 核心优势
| 特性 | 传统浏览器方式 | xhs-kit方式 |
|---|---|---|
| 效率 | 低（3-5分钟） | ✅ 高（~60秒） |
| 稳定性 | 低（浏览器崩溃） | ✅ 高 |
| 多账号 | ❌ 不支持 | ✅ 支持 |
| 资源占用 | 高（开浏览器） | ✅ 低 |
| 定时发布 | 需要外部调度 | ✅ 内置支持 |
📦 安装
# 1. 创建虚拟环境
python3 -m venv xhs-env
source xhs-env/bin/activate
# 2. 安装xhs-kit
pip install -U xhs-kit
# 3. 安装Playwright浏览器
playwright install chromium
# 4. 安装其他依赖
pip install pillow requests markdown pyyaml
🔑 快速开始
1. 登录小红书账号
# 终端二维码登录（推荐）
xhs-kit login-qrcode --terminal
# 或保存二维码图片
xhs-kit login-qrcode --save qrcode.png
2. 检查登录状态
xhs-kit status
3. 发布内容
# 基本发布
xhs-kit publish \
--title "标题（不超过20字）" \
--content "正文内容..." \
--image /path/to/image.jpg \
--tag "标签1" \
--tag "标签2"
# 定时发布
xhs-kit publish \
--title "标题" \
--content "内容" \
--schedule-at "2026-03-08T11:00:00+08:00"
📁 项目结构
xhs-kit-publisher/
├── SKILL.md # 本文档
├── publish_xhs.sh # 发布脚本示例
├── xhs_kit_guide.md # 完整使用指南
├── config/
│ ├── account1_cookies.json # 账号1 cookies
│ └── account2_cookies.json # 账号2 cookies
├── scripts/
│ ├── multi_account_publish.sh # 多账号发布脚本
│ └── schedule_publish.py # 定时发布脚本
└── examples/
├── simple_publish.md # 简单发布示例
└── advanced_features.md # 高级功能示例
🚀 核心功能
1. 多账号管理
# 登录不同账号
xhs-kit login-qrcode --terminal --cookies-file config/account1.json
xhs-kit login-qrcode --terminal --cookies-file config/account2.json
# 使用指定账号发布
xhs-kit publish --title "..." --cookies-file config/account1.json
2. 发布前验证
# debug模式验证（不实际发布）
xhs-kit debug-publish \
--title "标题" \
--content "内容" \
--image image.jpg \
--verbose
3. 批量发布
#!/bin/bash
# multi_publish.sh
CONTENT_FILE="content.txt"
IMAGES=("image1.jpg" "image2.jpg" "image3.jpg")
while IFS= read -r line; do
title=$(echo "$line" | cut -d'|' -f1)
content=$(echo "$line" | cut -d'|' -f2)
tags=$(echo "$line" | cut -d'|' -f3)
xhs-kit publish \
--title "$title" \
--content "$content" \
--image "${IMAGES[RANDOM % ${#IMAGES[@]}]}" \
--tag "$tags"
sleep 60 # 避免频繁发布
done < "$CONTENT_FILE"
⚙️ 配置说明
环境变量
# 设置默认cookies文件
export XHS_COOKIES_FILE="~/.config/xhs-kit/cookies.json"
# 设置默认图片目录
export XHS_IMAGE_DIR="~/images/xiaohongshu"
# 设置发布间隔（秒）
export XHS_PUBLISH_INTERVAL=300
配置文件示例
{
"accounts": [
{
"name": "艺术分享账号",
"cookies_file": "config/art_account.json",
"tags": ["#艺术", "#创作", "#手工"],
"publish_schedule": "0 10,15,20 * * *"
},
{
"name": "生活分享账号",
"cookies_file": "config/life_account.json",
"tags": ["#生活", "#日常", "#分享"],
"publish_schedule": "0 12,18 * * *"
}
],
"default_image_size": "1242x1660",
"quality": 95,
"max_tags": 5
}
🔧 故障排除
常见问题
-
登录失败
# 清除旧cookies重新登录 rm -rf ~/.config/xhs-kit/ xhs-kit login-qrcode --terminal -
发布失败
# 先测试debug模式 xhs-kit debug-publish --title "测试" --image test.jpg --verbose # 检查图片格式和大小 file test.jpg ls -lh test.jpg -
Cookies过期
# 检查登录状态 xhs-kit status --verify # 重新登录 xhs-kit logout xhs-kit login-qrcode --terminal
错误代码
ERR_NO_LOGIN: 未登录，需要重新扫码ERR_IMAGE_INVALID: 图片格式或尺寸无效ERR_TITLE_TOO_LONG: 标题超过20字ERR_NETWORK: 网络问题，检查连接
📊 监控和日志
日志配置
# 发布时记录详细日志
xhs-kit publish --title "..." 2>&1 | tee -a publish.log
# 查看发布历史
grep -E "✅|❌|发布" publish.log | tail -20
状态监控
#!/bin/bash
# monitor_xhs.sh
# 检查登录状态
if xhs-kit status; then
echo "✅ 登录状态正常"
else
echo "❌ 需要重新登录"
# 发送通知...
fi
# 检查今日发布次数
TODAY=$(date +%Y-%m-%d)
PUBLISH_COUNT=$(grep -c "$TODAY.*发布成功" publish.log 2>/dev/null || echo 0)
echo "今日已发布: $PUBLISH_COUNT 次"
🎯 最佳实践
1. 内容策略
- 标题：不超过20字，吸引眼球
- 正文：80-1000字，段落清晰
- 图片：1242x1660像素，JPG/PNG格式
- 标签：3-5个相关标签
2. 发布频率
- 新账号：每天1-2篇
- 成熟账号：每天2-3篇
- 多账号：错开发布时间
3. 安全策略
- 避免相同内容重复发布
- 使用不同图片和标题
- 保持自然发布间隔
- 定期更换cookies
📞 支持
常用命令速查
# 登录相关
xhs-kit login-qrcode --terminal # 终端二维码登录
xhs-kit login-qrcode --save qr.png # 保存二维码
xhs-kit status # 检查登录状态
xhs-kit logout # 退出登录
# 发布相关
xhs-kit debug-publish --verbose # 测试发布
xhs-kit publish # 实际发布
xhs-kit publish --schedule-at ... # 定时发布
# 内容管理
xhs-kit search --keyword "关键词" # 搜索内容
资源链接
使用此技能，你可以实现高效、稳定、可扩展的小红书内容发布，告别浏览器自动化的低效和不稳定问题！ 🚀