社交媒体自动发布器

🚀 一个统一的社交媒体自动化发布平台，支持小红书和抖音的内容自动发布。

✨ 特性

• 🎯 多平台支持: 小红书（图文/视频）、抖音（视频）
• 🔐 智能登录: 扫码登录 + Cookie持久化管理
• 🛡️ 反检测机制: 模拟人类操作，避免被平台识别
• ⚡ 批量发布: 支持多账号、多内容批量操作
• 📊 任务调度: 定时发布、内容规划
• 📝 详细日志: 完整的操作记录和错误追踪

🏗️ 项目结构

social_media_auto_publisher/
├── core/                   # 核心引擎
│   ├── publisher.py        # 统一发布管理器
│   ├── session_manager.py  # 会话管理
│   └── task_scheduler.py   # 任务调度器
├── platforms/              # 平台适配层
│   ├── xiaohongshu/        # 小红书适配器
│   └── douyin/             # 抖音适配器
├── auth/                   # 认证模块
│   ├── base_auth.py        # 基础认证类
│   ├── xiaohongshu_auth.py # 小红书认证
│   └── douyin_auth.py      # 抖音认证
├── utils/                  # 工具模块
│   ├── browser.py          # 浏览器管理
│   ├── human_behavior.py   # 人类行为模拟
│   ├── media_handler.py    # 媒体文件处理
│   └── logger.py           # 日志管理
├── config/                 # 配置管理
│   ├── settings.py         # 系统配置
│   └── platform_config.py  # 平台配置
├── tests/                  # 测试用例
├── examples/               # 使用示例
├── docs/                   # 文档
└── media/                  # 媒体文件存储

🚀 快速开始

环境要求

• Python >= 3.8
• Playwright >= 1.40.0
• Chrome/Chromium 浏览器

安装

# 克隆项目
git clone https://github.com/your-repo/social_media_auto_publisher.git
cd social_media_auto_publisher

# 安装依赖
pip install -r requirements.txt

# 安装 Playwright 浏览器
playwright install chromium

基本使用

import asyncio
from social_media_auto_publisher import Publisher, ImageNote, VideoContent

async def main():
    # 初始化发布器
    publisher = Publisher(headless=False)

    # 设置小红书账号（首次使用需要扫码登录）
    await publisher.setup_platform("xiaohongshu", "your_account_name")

    # 发布图文笔记
    note = ImageNote(
        title="我的旅行分享",
        description="今天去了很美的地方，分享给大家！",
        images=["path/to/image1.jpg", "path/to/image2.jpg"],
        tags=["旅行", "美景", "分享"]
    )

    result = await publisher.publish("xiaohongshu", note, "your_account_name")
    print(f"发布结果: {result}")

    # 发布视频到抖音
    video = VideoContent(
        title="搞笑视频",
        description="今天拍的搞笑视频，希望大家喜欢！",
        video_path="path/to/video.mp4",
        tags=["搞笑", "日常"]
    )

    result = await publisher.publish("douyin", video, "your_douyin_account")
    print(f"发布结果: {result}")

if __name__ == "__main__":
    asyncio.run(main())

批量发布

from social_media_auto_publisher import Publisher, PublishTask

async def batch_publish():
    publisher = Publisher()

    # 创建批量任务
    tasks = [
        PublishTask(
            platform="xiaohongshu",
            content=image_note,
            account="user1"
        ),
        PublishTask(
            platform="douyin",
            content=video_content,
            account="user2"
        ),
    ]

    # 执行批量发布
    results = await publisher.batch_publish(tasks)

    for result in results:
        print(f"任务 {result.task_id}: {'成功' if result.success else '失败'}")

asyncio.run(batch_publish())

📋 支持的功能

小红书 (XiaoHongShu)

• ✅ 扫码登录
• ✅ 图文笔记发布 (最多9张图片)
• ✅ 视频笔记发布
• ✅ Cookie 自动管理
• ✅ 发布状态检测

抖音 (Douyin)

• ✅ 扫码登录
• ✅ 视频发布
• ✅ Cookie 自动管理
• ✅ 上传进度监控
• ⏳ 图文笔记 (规划中)

通用功能

• ✅ 人类行为模拟
• ✅ 反自动化检测
• ✅ 批量操作
• ✅ 错误重试机制
• ✅ 详细日志记录
• ✅ 配置管理
• ⏳ 定时发布 (开发中)

⚙️ 配置

基础配置

# config/settings.py
class Settings:
    # 浏览器配置
    BROWSER_HEADLESS = False          # 是否无头模式
    BROWSER_TIMEOUT = 30000           # 超时时间（毫秒）

    # 并发配置
    MAX_CONCURRENT_TASKS = 3          # 最大并发任务数
    TASK_RETRY_COUNT = 3              # 任务重试次数

    # 反检测配置
    HUMAN_TYPING_SPEED = (80, 150)    # 打字速度范围（毫秒/字符）
    RANDOM_PAUSE_PROBABILITY = 0.15   # 随机暂停概率
    RANDOM_DELAY_RANGE = (0.3, 0.8)   # 随机延迟范围（秒）

    # 文件限制
    MAX_IMAGE_SIZE = 10 * 1024 * 1024 # 最大图片大小 (10MB)
    MAX_VIDEO_SIZE = 500 * 1024 * 1024 # 最大视频大小 (500MB)

平台特定配置

# config/platform_config.py
XIAOHONGSHU = {
    'login_url': 'https://creator.xiaohongshu.com/',
    'image_note_url': 'https://creator.xiaohongshu.com/publish/publish',
    'video_note_url': 'https://creator.xiaohongshu.com/publish/video',
    'max_images': 9,
    'max_video_duration': 300,  # 5分钟
}

DOUYIN = {
    'login_url': 'https://creator.douyin.com/creator-micro/home',
    'upload_url': 'https://creator.douyin.com/creator-micro/content/upload',
    'max_video_duration': 600,  # 10分钟
    'supported_formats': ['mp4', 'mov', 'avi'],
}

🛡️ 反检测机制

本项目采用多层反检测策略来避免被平台识别为自动化工具：

1. 浏览器指纹伪装

• 使用 stealth.min.js 脚本
• 修改 webdriver、navigator 等属性
• 随机化浏览器版本和插件信息

2. 行为模拟

• 打字模拟: 随机打字速度 (80-150ms/字符)
• 点击模拟: 模拟真实鼠标移动和点击
• 滚动模拟: 随机滚动行为
• 随机暂停: 15% 概率随机暂停 0.3-0.8 秒

3. 操作时间随机化

• 操作间隔随机化 (1-3秒)
• 上传检测等待完成状态
• 智能重试机制

📝 使用示例

更多使用示例请查看 examples/ 目录：

• 小红书图文笔记发布
• 小红书视频笔记发布
• 抖音视频发布
• 批量发布示例
• 多账号管理

🧪 测试

# 运行所有测试
python -m pytest tests/

# 运行特定平台测试
python -m pytest tests/test_xiaohongshu.py
python -m pytest tests/test_douyin.py

# 运行测试并查看覆盖率
python -m pytest tests/ --cov=.

📊 日志

系统会自动记录详细的操作日志：

logs/
├── 2024-01-01.log          # 按日期分割的日志文件
├── 2024-01-02.log
└── ...

日志级别：

• INFO: 正常操作信息
• WARNING: 警告信息
• ERROR: 错误信息
• DEBUG: 调试信息（需手动开启）

🔧 故障排除

常见问题

Q: 登录时一直等待扫码？ A: 确保在5分钟内完成扫码，如果超时需要重新开始。

Q: 发布失败提示元素找不到？ A: 可能是平台页面更新，需要更新选择器配置。

Q: 文件上传失败？ A: 检查文件格式和大小是否符合平台要求。

Q: 被平台检测为自动化？ A: 尝试增加操作间隔时间，降低并发数量。

调试模式

# 开启调试模式
publisher = Publisher(
    headless=False,      # 显示浏览器窗口
    debug=True,          # 开启调试日志
    slow_mode=True       # 慢速模式，增加操作间隔
)

🤝 贡献

欢迎贡献代码！请遵循以下步骤：

1. Fork 本项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

⚠️ 免责声明

本工具仅供学习和研究使用，请遵守相关平台的使用条款和法律法规。使用本工具产生的任何后果由使用者承担。

🙏 致谢

• 感谢 Playwright 提供强大的浏览器自动化能力
• 感谢 loguru 提供优雅的日志管理
• 参考了 xiaohongshu_note_publisher 项目的设计思路

---

📧 如有问题或建议，欢迎提交 Issue 或联系：your-email@example.com