# 社交媒体自动发布器 🚀 一个统一的社交媒体自动化发布平台，支持小红书和抖音的内容自动发布。 ## ✨ 特性 - 🎯 **多平台支持**: 小红书（图文/视频）、抖音（视频） - 🔐 **智能登录**: 扫码登录 + 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 浏览器 ### 安装 ```bash # 克隆项目 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 ``` ### 基本使用 ```python 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()) ``` ### 批量发布 ```python 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 自动管理 - ✅ 上传进度监控 - ⏳ 图文笔记 (规划中) ### 通用功能 - ✅ 人类行为模拟 - ✅ 反自动化检测 - ✅ 批量操作 - ✅ 错误重试机制 - ✅ 详细日志记录 - ✅ 配置管理 - ⏳ 定时发布 (开发中) ## ⚙️ 配置 ### 基础配置 ```python # 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) ``` ### 平台特定配置 ```python # 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/](examples/) 目录： - [小红书图文笔记发布](examples/xiaohongshu_image_note.py) - [小红书视频笔记发布](examples/xiaohongshu_video_note.py) - [抖音视频发布](examples/douyin_video.py) - [批量发布示例](examples/batch_publish.py) - [多账号管理](examples/multi_account.py) ## 🧪 测试 ```bash # 运行所有测试 python -m pytest tests/ # 运行特定平台测试 python -m pytest tests/test_xiaohongshu.py python -m pytest tests/test_douyin.py # 运行测试并查看覆盖率 python -m pytest tests/ --cov=. ``` ## 📊 日志 系统会自动记录详细的操作日志： ```bash logs/ ├── 2024-01-01.log # 按日期分割的日志文件 ├── 2024-01-02.log └── ... ``` 日志级别： - **INFO**: 正常操作信息 - **WARNING**: 警告信息 - **ERROR**: 错误信息 - **DEBUG**: 调试信息（需手动开启） ## 🔧 故障排除 ### 常见问题 **Q: 登录时一直等待扫码？** A: 确保在5分钟内完成扫码，如果超时需要重新开始。 **Q: 发布失败提示元素找不到？** A: 可能是平台页面更新，需要更新选择器配置。 **Q: 文件上传失败？** A: 检查文件格式和大小是否符合平台要求。 **Q: 被平台检测为自动化？** A: 尝试增加操作间隔时间，降低并发数量。 ### 调试模式 ```python # 开启调试模式 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](LICENSE) 文件了解详情。 ## ⚠️ 免责声明 本工具仅供学习和研究使用，请遵守相关平台的使用条款和法律法规。使用本工具产生的任何后果由使用者承担。 ## 🙏 致谢 - 感谢 [Playwright](https://playwright.dev/) 提供强大的浏览器自动化能力 - 感谢 [loguru](https://github.com/Delgan/loguru) 提供优雅的日志管理 - 参考了 [xiaohongshu_note_publisher](https://github.com/your-repo/xiaohongshu_note_publisher) 项目的设计思路 --- 📧 如有问题或建议，欢迎提交 Issue 或联系：your-email@example.com