6.5 KiB
6.5 KiB
小红书笔记发布脚本使用说明
功能介绍
xhs_publish.py 是一个用于自动发布小红书笔记的 Python 脚本，支持通过 Cookie 认证，自动完成图文笔记发布。
环境准备
1. 安装依赖
cd backend
pip install -r requirements.txt
主要依赖：
- playwright (浏览器自动化)
- asyncio (异步处理)
2. 安装浏览器驱动
playwright install chromium
使用方式
方式一：使用配置文件（推荐）
1. 准备配置文件
复制 publish_config_example.json 并修改为实际参数：
{
"cookies": [
{
"name": "a1",
"value": "your_cookie_value_here",
"domain": ".xiaohongshu.com",
"path": "/",
"expires": -1,
"httpOnly": false,
"secure": false,
"sameSite": "Lax"
}
],
"title": "笔记标题",
"content": "笔记内容",
"images": [
"D:/path/to/image1.jpg",
"D:/path/to/image2.jpg"
],
"tags": [
"标签1",
"标签2"
]
}
2. 执行发布
python xhs_publish.py --config publish_config.json
方式二：命令行参数
python xhs_publish.py \
--cookies '[{"name":"a1","value":"xxx","domain":".xiaohongshu.com"}]' \
--title "笔记标题" \
--content "笔记内容" \
--images '["D:/image1.jpg","D:/image2.jpg"]' \
--tags '["标签1","标签2"]'
参数说明
cookies (必需)
Cookie 数组，每个 Cookie 对象包含以下字段：
name: Cookie 名称value: Cookie 值domain: 域名（通常为.xiaohongshu.com）path: 路径（通常为/）expires: 过期时间（-1 表示会话 Cookie）httpOnly: 是否仅 HTTPsecure: 是否安全sameSite: 同站策略（Lax/Strict/None）
重要 Cookie（必需）：
a1: 用户身份认证webId: 设备标识web_session: 会话信息
title (必需)
笔记标题，字符串类型。
示例：
"💧夏日必备！2元一杯的柠檬水竟然这么好喝？"
content (必需)
笔记正文内容，字符串类型，支持换行符 \n。
示例：
"今天给大家分享一个超级实惠的夏日饮品！\n\n蜜雪冰城的柠檬水只要2元一杯，性价比真的太高了！"
images (可选)
图片文件路径数组，支持本地绝对路径。
要求：
- 图片必须是本地文件
- 支持 jpg、png、gif 等格式
- 最多上传 9 张图片
- 建议尺寸：800x600 或更高
示例：
[
"D:/project/Work/ai_xhs/backend/temp_uploads/image1.jpg",
"D:/project/Work/ai_xhs/backend/temp_uploads/image2.jpg"
]
tags (可选)
标签数组，会自动添加 # 前缀。
示例：
["夏日清爽", "饮品", "柠檬水"]
获取 Cookie 的方法
方法一：使用登录脚本
python xhs_cli.py login <手机号> <验证码>
登录成功后会自动保存 Cookie 到 cookies.json 文件。
方法二：浏览器手动获取
- 在浏览器中登录小红书网页版
- 打开开发者工具（F12）
- 切换到 Network（网络）标签
- 刷新页面
- 找到任意请求，查看 Request Headers
- 复制 Cookie 字段内容
- 使用在线工具或脚本转换为 JSON 格式
方法三：使用 Cookie 注入验证
python xhs_cli.py inject_cookies '<cookies_json>'
返回结果
成功示例
{
"success": true,
"message": "笔记发布成功",
"url": "https://www.xiaohongshu.com/explore/xxxx"
}
失败示例
{
"success": false,
"error": "Cookie已失效或未登录"
}
注意事项
1. Cookie 有效期
- Cookie 会在一段时间后失效
- 需要定期重新登录获取新 Cookie
- 建议使用 Cookie 注入验证接口检查状态
2. 图片上传
- 确保图片文件存在且可访问
- 图片路径使用绝对路径
- Windows 系统路径使用
/或\\分隔符
3. 发布限制
- 小红书可能有发布频率限制
- 建议控制发布间隔，避免被限流
- 内容需符合小红书社区规范
4. 错误处理
常见错误及解决方法：
- "Cookie已失效": 重新登录获取新 Cookie
- "图片文件不存在": 检查图片路径是否正确
- "未找到发布按钮": 小红书页面结构可能变化，需要更新选择器
- "输入内容失败": 等待时间不足，增加延迟时间
与 Go 后端集成
在 Go 后端中调用此脚本：
import (
"os/exec"
"encoding/json"
)
// 发布笔记
func PublishNote(cookies []Cookie, title, content string, images, tags []string) error {
// 构造配置文件
config := map[string]interface{}{
"cookies": cookies,
"title": title,
"content": content,
"images": images,
"tags": tags,
}
// 保存到临时文件
configFile := "temp_publish_config.json"
data, _ := json.Marshal(config)
ioutil.WriteFile(configFile, data, 0644)
// 调用 Python 脚本
cmd := exec.Command("python", "backend/xhs_publish.py", "--config", configFile)
output, err := cmd.CombinedOutput()
if err != nil {
return err
}
// 解析结果
var result map[string]interface{}
json.Unmarshal(output, &result)
if !result["success"].(bool) {
return errors.New(result["error"].(string))
}
return nil
}
开发调试
启用浏览器可视模式
修改 xhs_login.py 中的 headless 参数：
self.browser = await self.playwright.chromium.launch(
headless=False, # 改为 False 可以看到浏览器操作过程
args=['--disable-blink-features=AutomationControlled']
)
查看详细日志
脚本会在控制台输出详细的执行日志，包括：
- 浏览器初始化
- 登录状态验证
- 图片上传进度
- 内容输入状态
- 发布结果
常见问题
Q: 为什么上传图片后没有显示？
A: 可能是图片上传时间较长，脚本已经增加了等待时间。如果仍有问题，可以调整 xhs_login.py 中的等待时间。
Q: 如何批量发布多条笔记？
A: 准备多个配置文件，使用循环调用脚本：
for config in publish_config_*.json; do
python xhs_publish.py --config "$config"
sleep 60 # 间隔60秒
done
Q: Cookie 多久失效？
A: 小红书 Cookie 通常在 7-30 天后失效，具体取决于 Cookie 的过期时间设置。
技术支持
如有问题，请查看：
- 脚本执行日志
- 小红书页面结构是否变化
- Cookie 是否有效
- 图片文件是否存在