xiaohongshu_note_uploader/QUICKSTART.md

快速开始指南

5分钟快速上手小红书笔记发布工具 🚀

第一步：安装依赖

# 安装Python依赖包
pip install playwright loguru

# 安装浏览器驱动（重要！）
playwright install chromium

第二步：运行快速测试

# 直接运行测试脚本
python quick_test.py

测试脚本会：

1. ✅ 检查环境配置
2. 🔐 自动打开浏览器（首次需要扫码登录）
3. 📸 上传测试图片
4. 🎉 发布测试笔记

第三步：发布你的第一篇笔记

图文笔记

创建文件 my_first_note.py：

import asyncio
from publisher import XiaoHongShuImageNote

async def main():
    note = XiaoHongShuImageNote(
        title="我的第一篇笔记 ✨",
        content="Hello 小红书！",
        tags=["#新人报到"],
        image_paths=["my_photo.jpg"],  # 换成你的图片路径
        publish_date=0,
        account_file="cookies/account.json"
    )
    await note.main()

asyncio.run(main())

运行：

python my_first_note.py

常用功能

1. 多图发布

image_paths=["photo1.jpg", "photo2.jpg", "photo3.jpg"]

2. 添加标签

tags=["#美食", "#探店", "#广州"]

3. 定时发布

from datetime import datetime, timedelta

tomorrow = datetime.now() + timedelta(days=1)
tomorrow = tomorrow.replace(hour=15, minute=0)

note = XiaoHongShuImageNote(
    ...,
    publish_date=tomorrow  # 明天下午3点发布
)

4. 添加地理位置

note = XiaoHongShuImageNote(
    ...,
    location="广州塔"
)

常见问题

Q: 提示"Cookie失效"怎么办？

A: 删除Cookie文件重新登录：

rm cookies/account.json
python quick_test.py

Q: 图片上传失败？

A: 检查：

• 图片文件是否存在
• 图片格式是否正确（jpg/png）
• 文件路径是否正确

Q: 如何使用多个账号？

A: 为每个账号准备不同的Cookie文件：

account_file="cookies/account1.json"  # 账号1
account_file="cookies/account2.json"  # 账号2

更多示例

查看项目中的示例文件：

• example_image.py - 图文笔记完整示例
• example_video.py - 视频笔记完整示例

需要帮助？

• 📖 查看完整文档：README.md
• 💬 遇到问题可以提Issue

---

祝你使用愉快！ 🎉