/wx_video_api

微信视频号 API SDK

Primary LanguagePython

微信视频号助手 (wx_video_sdk) v1.1.0

功能介绍

微信视频号助手是一个自动化工具，可以帮助视频号运营者自动执行以下任务：

  1. 数据统计与导出：自动收集视频播放、点赞、评论等数据，并支持CSV格式导出
  2. 视频可见性管理：根据设定的条件（如播放量）自动调整视频可见性
  3. 自动回复评论：自动回复视频下的评论，支持随机回复内容
  4. 自动回复私信：自动回复用户私信，支持文字和图片，支持随机回复内容
  5. 数据报告生成：自动生成视频数据报告

安装方法

打包为可执行文件

pyinstaller -F -i icon.png main.py

运行要求

  • Python 3.6+
  • 所需依赖包已在requirements.txt中列出

使用说明

  1. 修改config.toml配置文件，根据需要调整各项参数
  2. 运行程序：
    • 直接运行Python脚本：python main.py
    • 或者运行打包后的可执行文件

配置文件说明

config.toml配置文件详细说明：

# 脚本配置
[run_config]
# 运行延迟间隔，值越小脚本处理速度越快，不建议小于1，默认4
run_delay = 4
# 设置最近输出几天之内要查看的视频数据(按该视频创建的时间)，默认2，设置成0则不会处理
create_video_report_days = 2
# 心跳检查间隔（秒），默认60秒检查一次会话状态
heartbeat_interval = 60
# 是否开启日志详细模式(0:关闭, 1:开启)，默认0
verbose_logging = 0

# 视频可见性管理配置
[auto_video_visible]
# 是否开启自动修改视频可见功能(0:关闭, 1:开启)，默认1
visible_target = 1
# 设置最近几天之内要处理的视频(按该视频创建的时间)，默认2，设置成0则不会处理
auto_video_visible_days = 2
# 设置当浏览量大于多少要处理的视频(和days配置配合使用)，默认5500
max_video_count = 5500
# 设置当以上两个配置都触发后的视频是否公开或隐藏(1:所有人可见,3:仅自己可见)，默认值3
video_visible_type = 3
# 任务执行间隔（秒），默认300秒执行一次
task_interval = 300

# 评论自动回复配置
[auto_send_comment]
# 是否开启评论自动回复(0:关闭, 1:开启)，默认1
comment_target = 1
# 回复自己的评论(0:关闭, 1:开启)，默认0
self_comment_target = 0
# 设置最近几天之内要处理的评论(按该评论创建的时间)，默认2，设置成0则不会处理
auto_send_comment_days = 2
# 自动回复评论内容
auto_send_comment_text = "感谢您的评论"
# 任务执行间隔（秒），默认120秒执行一次
task_interval = 120
# 多条随机回复文本，用英文分号;分隔，如果不设置则使用auto_send_comment_text
random_replies = "感谢您的评论;谢谢支持;已收到您的评论，感谢反馈"

# 私信自动回复配置
[auto_send_private_msg]
# 是否开启消息发送(0:关闭, 1:开启)，默认1
private_msg_target = 1
# 是否开启图片发送(0:关闭, 1:开启)，默认1
private_img_target = 1
# 设置最近几天之内要处理的私信(按该私信创建的时间)，默认1，设置成0则不会处理
auto_send_msg_days = 1
# 自动回复私信文字内容
auto_send_private_msg = "你好，感谢私信"
# 自动回复私信图片文件路径
auto_send_img_path = "./icon.png"
# 任务执行间隔（秒），默认60秒执行一次
task_interval = 60
# 多条随机回复文本，用英文分号;分隔，如果不设置则使用auto_send_private_msg
random_replies = "您好，感谢私信;已收到您的消息，稍后回复;谢谢您的关注"

# 数据导出配置
[data_export]
# 是否开启数据导出(0:关闭, 1:开启)，默认1
export_target = 1
# 数据导出间隔（秒），默认3600秒(1小时)执行一次
export_interval = 3600
# 数据导出路径，默认./视频数据
export_path = "./视频数据"
# 是否导出CSV格式(0:关闭, 1:开启)，默认1
export_csv = 1

新功能说明

v1.1.0更新内容

  1. 随机回复功能：评论和私信支持设置多条回复内容，随机选择一条回复
  2. 数据导出功能：定期自动导出视频数据为CSV格式，方便后续分析
  3. 任务间隔设置：每种任务可单独设置执行间隔，避免频繁操作
  4. 优化错误处理：更完善的错误处理和日志记录
  5. 优雅退出机制：捕获退出信号，确保程序能够安全退出并保存数据

常见问题

  1. 登录失败：

    • 检查网络连接
    • 清空caches目录后重新登录

  2. API调用失败：

    • 检查日志文件了解详细错误
    • 可能是接口变更，请等待更新

  3. 频繁操作导致账号风险：

    • 适当调大各任务的执行间隔

注意事项

  • 本工具仅用于辅助运营，请勿用于违规内容
  • 避免过于频繁的操作，以免触发微信风控
  • 定期备份导出的数据