名称: tiktok-android-bot
描述: 使用 ADB 在 Android 设备上自动化 TikTok 互动。搜索话题、使用 AI 或模板评论,包含设置向导。适用于 TikTok 自动化运营和通过策略性评论建立社交影响力。
使用 ADB 在 Android 设备上自动化 TikTok 互动。无需网页抓取,无验证码,成功率 100%。
技能包含一个自动运行的交互式设置向导:
python3 tiktok_bot.py search --topics fitness --videos 5
或手动运行设置:
python3 setup.py
向导会询问:
设置将保存到 config.py 和 .env(两者默认被 git 忽略)。
搜索话题并对相关视频进行评论:
# 单个话题,5 个视频
python3 tiktok_bot.py search --topics fitness --videos 5
# 多个话题,每个话题 3 个视频
python3 tiktok_bot.py search --topics "fitness,cooking,travel" --videos 3
# 指定设备(可选)
python3 tiktok_bot.py search --topics gaming --videos 5 --device 001431538002547
流程:
1. 搜索每个话题
2. 从搜索结果网格(2x2 布局)中打开视频
3. 生成评论(AI 分析或使用模板)
4. 发布评论
5. 返回搜索结果以处理下一个视频
对“为你推荐”流中的随机视频进行评论:
# 对 10 个随机视频评论
python3 tiktok_bot.py explore --videos 10
流程:
1. 从“为你推荐”流开始
2. 分析当前视频(如果使用 AI)或使用通用评论
3. 发布评论
4. 滚动到下一个视频
快速、可靠、无 API 成本。用户为每个话题提供 6-8 条变体。
配置示例:
COMMENT_STYLE = "static"
COMMENTS_BY_TOPIC = {
"fitness": [
"动作看起来真标准!你的训练计划是怎样的?",
"进步惊人!训练多久了?",
# ... 更多变体
]
}
Claude Vision 或 GPT-4 Vision 分析视频截图并生成上下文相关的评论。
配置示例:
COMMENT_STYLE = "ai"
AI_PROVIDER = "anthropic"
AI_MODEL = "claude-3-5-sonnet-20241022"
API 密钥在 .env 文件中:
ANTHROPIC_API_KEY=sk-ant-...
成本: 每条评论 $0.01-0.05,具体取决于提供商。
设置完成后,您将拥有:
config.py - 话题、评论风格、模板/AI 设置.env - API 密钥(AI 模式下).bot_settings.json - 偏好设置所有文件默认被 git 忽略。
设置 → 关于手机 → 点击“版本号”7 次
设置 → 开发者选项 → 启用“USB 调试”
通过 USB 连接设备并授权计算机。
adb devices
# 应显示:<设备ID> device
adb shell wm size
# 记下屏幕分辨率(例如:1080x2392)
adb kill-server
adb start-server
adb devices
如有需要,请在设备上重新授权。
坐标针对 1080x2392 屏幕进行了优化。对于其他尺寸:
adb shell screencap -p /sdcard/screen.png && adb pull /sdcard/screen.pngsrc/bot/android/tiktok_navigation.py 中更新:python
search_icon_x = 995 # 你的 X 坐标
search_icon_y = 205 # 你的 Y 坐标详细坐标指南请参阅 references/COORDINATES.md。
检查:
1. .env 文件中的 API 密钥
2. API 密钥是否有效且有余额
3. 模型名称是否正确
4. 程序会自动回退到通用评论
确保点击“发布”前键盘已收起。机器人会自动使用 KEYCODE_BACK 实现此功能。
✅ 推荐:
- 具体的观察或提问
- 10-25 个词
- 真诚的热情
- 不使用表情符号(听起来更真实)
❌ 避免:
- 通用赞美(“视频不错!”)
- 垃圾信息或自我推广
- 太简短(“第一!”)
- 低价值内容(“🔥🔥🔥”)
openclaw cron add \
--name "每日 TikTok" \
--schedule "0 10 * * *" \
--tz "您的/时区" \
--payload '{"kind":"agentTurn","message":"cd /path/to/skill && python3 tiktok_bot.py search --topics fitness,gaming --videos 5"}'
编辑 config.py:
AI_COMMENT_PROMPT = """
分析此视频并生成一条评论。
话题:{topic}
你的自定义指导原则...
- 保持热情
- 提出具体问题
- 参考可见元素
"""
设置 ANDROID_DEVICE_ID 环境变量:
ANDROID_DEVICE_ID=device1 python3 tiktok_bot.py search --topics fitness --videos 5
或使用 --device 标志:
python3 tiktok_bot.py search --topics fitness --videos 5 --device device1
tiktok-android-bot/
├── SKILL.md # 本文件
├── README.md # 完整文档
├── setup.py # 交互式设置向导
├── tiktok_bot.py # 主脚本 (CLI)
├── config.example.py # 配置示例
├── requirements.txt # Python 依赖
├── scripts/
│ ├── run_full_campaign.py # 旧版:25 视频活动
│ └── run_complete_session.py # 旧版:3 视频会话
├── src/
│ ├── bot/android/
│ │ ├── tiktok_android_bot.py # 核心自动化
│ │ └── tiktok_navigation.py # 导航流程
│ ├── ai_comments.py # AI 评论生成
│ └── logger.py # 日志工具
└── references/
└── COORDINATES.md # 点击坐标指南
loguru>=0.7.0
anthropic>=0.18.0 # 如果使用 AI 模式
openai>=1.12.0 # 如果使用 AI 模式
ADB 必须已安装并在 PATH 中。
MIT - 请负责任地使用。自动化评论可能违反 TikTok 服务条款。
README.md - 完整文档references/COORDINATES.md - 坐标自定义指南