Yht20927 /douyin-cli

基于 Bridge Framework 的抖音全自动评论管理工具。搜索视频、爬取全量评论(含嵌套回复)、AI 智能回复、运营仪表盘。

★ 299⑂ 57👁 0⑃ 0● 0▤ 1
JavaScriptMITCreated 2026-06-01
Download: 基于CDP的方案basecdp ↓basecdp2026-06-05
+1
Daily
299
stars
57
forks
0
watchers
0
prs
0
issues
1
releases

README

🎵 Douyin Comment CLI




 适用版本: v4 · 最后更新: 2026-08-27 · 维护者: Yht20927

 抖音评论运营 CLI 工具。基于 Bridge Framework(Bridge Server + 油猴脚本),支持视频搜索、评论获取、AI 人格化回复、ReplyEngine 独立生成、草稿管理、运营仪表盘。

核心亮点:ReplyEngine 评论生成引擎(generateComment / generateReply / generateReplies)+ A-F 六类回复策略 + Anthropic & OpenAI 双 Provider 支持 + Token 用量追踪,让代管自有账号的评论运营全流程自动化。

---

 🌐 同系列项目(Bridge Framework 全家桶)

同一套 Bridge Server + 油猴脚本架构的姊妹项目,欢迎 Star 与交流:

| 项目 | 一句话简介 |
|------|-----------|
| BossZhipin-cli | BOSS 直聘命令行工具:搜索职位、智能匹配评分、LLM 批量打招呼 |
| xiaohongshu-cli | 小红书评论 CLI:笔记搜索、评论获取、AI 人格化回复、行为模拟 |
| douyin-living | 抖音直播全自动录制 + AI 智能切片系统(录制 → 弹幕 → 语音识别 → 高光剪辑) |
| tiktok-cli | TikTok 评论 CLI:视频搜索、评论获取、AI 回复(参考 douyin-cli 架构) |
| ths-cli | 同花顺行情命令行工具:实时行情、K 线、多因子技术分析 |

---

 ✨ 核心功能

| 功能 | 说明 |
|------|------|
| 🔍 视频搜索 | 关键词搜索视频 |
| 💬 评论获取 | 获取评论及嵌套回复,--new 增量拉取 |
| 🖼️ 图片评论 | 发表带图评论/回复(ImageX 上传链路,--image 可多张) |
| 🧠 ReplyEngine | 独立评论生成引擎,3 种模式 + 人格绑定 + 上下文隔离 |
| 🤖 AI 人格化回复 | 7 种人格自动轮换,A-F 六类回复策略,避免"AI 味" |
| 📝 草稿管理 | 回复草稿 save/list/show/post/delete 完整生命周期 |
| 🎭 行为模拟 | 模拟真实浏览(搜索→看视频→点赞),穿插在发布流程中 |
| ⏱️ 随机延迟 | 发布间隔 40-55s 随机 + 疲劳累加,模拟真人节奏 |
| 🎲 请求参数随机化 | browser_version 动态获取、paste_edit_method / enter_from 随机切换 |
| 🛡️ 风控断路器 | 10 分钟内 post 失败 ≥3 次自动暂停 |
| 📥 视频下载 | 下载视频+音频(BGM),支持 ffmpeg 截图多模态分析 |
| 📊 运营仪表盘 | 本地 HTML 可视化,含推广活动卡片 |
| 💾 持久化记忆 | SQLite schema v8(events / users / videos / comments / corpus / failures / campaigns / llm_usage / drafts) |

---

 🖼️ 图片评论

发表带图评论或回复。--image 可重复,也可用逗号分隔一次传多张:

bash
 图片评论
node cli.js post  "这个封面做得真好" --image cover.jpg

 图片回复(回复某条评论)
node cli.js post  "看下我的版本" --reply-to  --image v1.png

 多张
node cli.js post  "对比一下" --image a.jpg,b.jpg,c.jpg

 只上传不发(拿 uri 复用 / 调试)
node cli.js upload-image --image cover.jpg


上传链路(scripts/douyin.user.js 内实现,CLI 只负责递数据):

| 步骤 | 接口 | 说明 |
|------|------|------|
| 1 | GET /aweme/v1/web/comment/upload/auth/ | 取 ImageX STS 临时凭证(service_id / upload_domain / 密钥) |
| 2 | GET imagex.bytedanceapi.com/?Action=ApplyImageUpload | AWS SigV4 签名,换上传地址 + StoreUri |
| 3 | PUT https:/// | 传字节,带 Content-CRC32 与 X-Storage-U |
| 4 | POST ?Action=CommitImageUpload | 提交,返回 ImageUri / 宽 / 高 / 格式 |
| 5 | POST /aweme/v1/web/comment/publish/ | 文本 + image_uri_list / image_formats / image_widths / image_heights |

要点与限制:

- 格式:jpg / jpeg / png / webp / gif / bmp / heic(按扩展名校验),单张上限 10MB,超过 4MB 建议先压缩
- 签名:全链路在浏览器页面上下文完成,crypto.subtle 做 SHA-256 / HMAC;签名算法对齐抖音前端内置的 ImageX SDK(region cn-north-1、service imagex)
- base64 分块递送:图片按 512KB 分片经 Bridge 送进页面缓冲,避免单条 eval 表达式塞进数 MB 字符串
- 结果自检:发布后用服务端回包的 image_list 校验图片张数,不符会在结果里给出 warning
- 功能可用性:图片评论是抖音灰度的能力,账号/视频未开放时接口会拒绝;若发布结果出现 image_count: 0 警告,说明图片没挂上

---

 🚀 快速开始

bash
npm install

 1. 复制配置
cp config.example.json config.json
 编辑 config.json:填入 bridge.token 和 llm.api_key
 支持 OpenAI 兼容 API 和 Anthropic 原生 Messages API(自动检测切换)

 2. 启动 Bridge Server
node server.js

 3. Chrome 安装油猴脚本 scripts/douyin.user.js
    ⚠️ Chrome 用户:需先在 Tampermonkey 中启用"允许访问文件网址"
    详见下方「疑难排解」→ Chrome 连接问题
    打开 douyin.com 并登录

 4. 验证连

Latest release

基于CDP的方案 basecdp 2026-06-05
该版本基于谷歌浏览器以及CDP协议,功能良好但是适配度存在局限

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON