LiuFuhua / xj-marketing

Go to a project
Toggle navigation Toggle navigation pinning
liufuhua007
23b3f9e1 1 parent 0d016f9a

add readme

Inline Side-by-side
Showing 1 changed file with 291 additions and 0 deletions
# xj-marketing
social-auto-upload 该项目旨在自动化发布视频到各个社交媒体平台
social-auto-upload This project aims to automate the posting of videos to various social media platforms.
## 💡Feature
- 中国主流社交媒体平台：
- [x] 抖音
- [x] 视频号
- [x] bilibili
- [x] 小红书
- [x] 快手
- [ ] 百家号
- [ ] 网易号
- 部分国外社交媒体：
- [x] tiktok
- [ ] youtube
---
- [ ] 易用版本(支持非开发人员使用)：Gui or Cli
- [ ] API 封装
- [ ] Docker 部署
- [ ] 自动化上传(schedule)
- [x] 定时上传(cron)
- [ ] cookie 管理
- [ ] 国外平台proxy 设置
- [ ] 多线程上传
- [ ] slack 推送
# 💾Installation
```
pip install -r requirements.txt
playwright install chromium firefox
```
# 核心模块解释
### 1. 视频文件准备(video prepare)
filepath 本地视频目录，目录包含(filepath Local video directory containing)
- 视频文件(video files)
- 视频meta信息txt文件(video meta information txt file)
举例(for example)：
file：2023-08-24_16-29-52 - 这位勇敢的男子为了心爱之人每天坚守 .mp4
meta_file:2023-08-24_16-29-52 - 这位勇敢的男子为了心爱之人每天坚守 .txt
meta_file 内容(content)：
```angular2html
这位勇敢的男子为了心爱之人每天坚守 🥺❤️‍🩹
#坚持不懈 #爱情执着 #奋斗使者 #短视频
```
### Usage
1. 设置conf 文件中的 `LOCAL_CHROME_PATH`(在douyin、视频号 tiktok可能出现chromium 不兼容的各种问题，建议设置本地的chrome)
2. 这里分割出来3条路
- 可自行研究源码，免费、任意 穿插在自己的项目中
- 可参考下面的各个平台的使用指南，`examples`文件夹中有各种示例代码
- 使用cli 简易使用(支持tiktok douyin 视频号)
#### cli 用法
```python
python cli_main.py <platform> <account_name> <action: upload, login> [options]
```
查看详细的参数说明使用：
```python
python cli_main.py -h
```
```python
usage: cli_main.py [-h] platform account_name action ...
Upload video to multiple social-media.
positional arguments:
platform Choose social-media platform: douyin tencent tiktok kuaishou
account_name Account name for the platform: xiaoA
action Choose action
upload upload operation
login login operation
watch watch operation
options:
-h, --help show this help message and exit
```
示例
```python
python cli_main.py douyin test login
douyin平台，账号名为test，动作为login
python cli_main.py douyin test upload "C:\Users\duperdog\Videos\2023-11-07_05-27-44 - 这位少女如梦中仙... .mp4" -pt 0
douyin平台, 账号名为test, 动作为upload, 视频文件（需对应的meta文件，详见上）, 发布方式（pt）：0 立即发布
python cli_main.py douyin test upload "C:\Users\superdog\Videos\2023-11-07_05-27-44 - 这位少女如梦中仙... .mp4" -pt 1 -t "2024-6-14 12:00"
douyin平台, 账号名为test, 动作为upload, 视频文件, 发布方式（pt）：1 定时发布, 发布时间(t)： 2024-6-14 12:00
```
---
## 各平台详细说明
### 1. 抖音
<img src="media/show/pdf3.gif" alt="douyin show" width="500"/>
使用playwright模拟浏览器行为
> 抖音前端实现，诸多css class id 均为随机数，故项目中locator多采用相对定位，而非固定定位
1. 准备视频目录结构
2. cookie获取：get_douyin_cookie.py 扫码登录
3. 上传视频：upload_video_to_douyin.py
其他部分解释：
```
douyin_setup handle 参数为True，为手动获取cookie False 则是校验cookie有效性
generate_schedule_time_next_day 默认从第二天开始（此举为避免选择时间的意外错误）
参数解释：
- total_videos 本次上传视频个数
- videos_per_day 每日上传视频数量
- daily_times 视频发布时间 默认6、11、14、16、22点
- start_days 从第N天开始
```
> 2023年12月15日补充：使用chromium可能会出现无法识别视频封面图片的情况
> 解决方案：
> 1. 下载chrome
> 2. 找到chrome的安装目录
> 3. 将本地chrome 路径conf文件中 LOCAL_CHROME_PATH = "xxx/xxx/chrome.exe"
参考项目：
- https://github.com/wanghaisheng/tiktoka-studio-uploader
- https://github.com/Superheroff/douyin_uplod
- https://github.com/lishang520/DouYin-Auto-Upload.git
---
### 2. 视频号
使用playwright模拟浏览器行为
1. 准备视频目录结构
2. cookie获取：get_tencent_cookie.py 扫码登录
3. 上传视频：upload_video_to_tencent.py
其他部分解释：
```
参考上面douyin_setup 配置
```
> 视频号使用chromium会出现不支持上传视频，需要自行指定本地浏览器
> 解决方案：
> 1. 下载chrome
> 2. 找到chrome的安装目录
> 3. 将本地chrome 路径conf文件中 LOCAL_CHROME_PATH = "xxx/xxx/chrome.exe"
---
### 3. 小红书
该实现，借助ReaJason的[xhs](https://github.com/ReaJason/xhs)，再次感谢。
1. 目录结构同上
2. cookie获取，可使用chrome插件：EditThisCookie
- 设置导出格式
![Alt text](media/20231009111131.png)
- 导出
![Alt text](media/20231009111214.png)
3. 黏贴至 uploader/xhs_uploader/accounts.ini文件中
#### 解释与注意事项：
```
xhs签名方式分为两种：
- 本地签名 sign_locl （默认）
- 自建签名服务 sign
测试下来发现本地签名，在实际多账号情况下会存在问题
故如果你有多账号分发，建议采用自建签名服务（todo 上传docker配置）
```
##### 疑难杂症
遇到签名问题，可尝试更新 "utils/stealth.min.js"文件
https://github.com/requireCool/stealth.min.js
24.4.10 大多数人小红书失败的原因在于你的cookie有问题，请参照你cookie是不是如我这样
![正确的cookie](media/xhs_error_cookie.png)
关于xhs部分可参考作者： https://reajason.github.io/xhs/basic
##### todo
- 扫码登录方式（实验下来发现与浏览器获取的存在区别，会有问题，未来再研究）
参考项目：
- https://github.com/ReaJason/xhs
---
### 4. bilibili
该实现，借助biliup的[biliup-rs](https://github.com/biliup/biliup-rs)，再次感谢。
1. 准备视频目录结构
2. cookie获取：`biliup.exe -u account.json login` 选项你喜欢的登录方式
![登录方式](media/get_bili_cookie.png)
3. 上传视频：upload_video_to_bilibili.py
#### 解释与注意事项：
```
bilibili cookie 长期有效（至少我运行2年以来是这样的）
其他平台 诸如linux mac 服务器运行 请自行研究
```
参考项目：
- https://github.com/biliup/biliup-rs
---
### 5. tiktok
使用playwright模拟浏览器行为(Simulating Browser Behavior with playwright)
1. 准备视频目录结构(Prepare the video directory structure)
2. 将本地chrome路径配置到conf文件中 LOCAL_CHROME_PATH = "xxx/xxx/chrome.exe"(Configure the local chrome path to the conf file)
3. cookie获取(generate your cookie)：get_tk_cookie.py
![get tiktok cookie](media/tk_login.png)
4. 上传视频(upload video)：upload_video_to_tiktok.py
24.7.3 update local chrome support:
- you can upload your custom thumbnail(place `png` file at the path of `videos`)
- if not, the system will take the first frame of the video as the thumbnail.
- chrome drive can't login by gmail oauth. the google don't support it. (if you want login by google oauth you can use the `tk_uploader/main.py` old firefox.)
- before the upload process change the language to eng.
其他部分解释：
```
参考上面douyin_setup 配置
```
other part explain(for eng friends)：
```
tiktok_setup handle parameter is True to get cookie manually False to check cookie validity
generate_schedule_time_next_day defaults to start on the next day (this is to avoid accidental time selection errors)
Parameter explanation:
- total_videos Number of videos uploaded this time
- videos_per_day Number of videos uploaded per day
- daily_times The video posting times are 6, 11, 14, 16, 22 by default.
- start_days Starts on the nth day.
```
参考项目：
- https://github.com/wkaisertexas/tiktok-uploader
---
### 其余部分(todo)
整理后上传
---
## 其他优秀项目
- https://github.com/KLordy/auto_publish_videos
- db支持
- 定期自动发布
- cookie db管理
- 视频去重
- 消息推送
## 🐾Communicate
[Donate as u like](https://www.buymeacoffee.com/hysn2001m)
如果你也是`一个人`，喜欢`折腾`， 想要在如此恶劣的大环境寻找突破
希望探索 #技术变现 #AI创业 #跨境航海 #自动化上传 #自动化视频 #技术探讨
可以来群里和大家交流
|![Nas](media/mp.jpg)|![赞赏](media/QR.png)|
|:-:|:-:|
|后台回复 `上传` 加群交流|如果你觉得有用|
## Star History
> 如果这个项目对你有帮助，⭐以表示支持
[![Star History Chart](https://api.star-history.com/svg?repos=dreammis/social-auto-upload&type=Date)](https://star-history.com/#dreammis/social-auto-upload&Date)
\ No newline at end of file