Scott出海实操

代码包 · SCT AI 超级个体营 · 第一期 · Week 4

Week 4 代码包:TikTok 竞品视频监控系统

盯竞品账号的新视频和数据变化,自动出监控报表

解锁后下载(632 KB)已购买?登录后直接下载

包里有什么

38 个文件 · 解压后 0.8 MB

├── app
│   ├── dashboard-data.json  (46 KB)
│   └── index.html  (74 KB)
├── docs
│   ├── screenshots
│   │   ├── 01-config.png  (10 KB)
│   │   ├── 02-run-success.png  (6 KB)
│   │   ├── 03-assets-proof.png  (6 KB)
│   │   ├── 04-report-proof.png  (8 KB)
│   │   ├── 07-dashboard-v8-new-scan-browser.png  (153 KB)
│   │   ├── 08-dashboard-v8-history-browser.png  (201 KB)
│   │   ├── 09-dashboard-v8-mobile-browser.png  (91 KB)
│   │   ├── 10-week4-ppt-cover-preview.png  (123 KB)
│   │   └── dashboard-v8-browser-checks.json  (2 KB)
│   ├── commercial-ui-upgrade-plan.md  (8 KB)
│   ├── onepage.md  (2 KB)
│   └── week4-courseware.md  (4 KB)
├── ops
│   ├── README.md
│   └── com.scott.week4.tiktok-monitor.plist  (1 KB)
├── prompts
│   └── codex-student-run-card.md  (1 KB)
├── scripts
│   ├── ui
│   │   ├── __init__.py
│   │   ├── copy.py
│   │   ├── server.py  (7 KB)
│   │   ├── state.py  (3 KB)
│   │   └── template.py  (36 KB)
│   ├── tiktok_monitor.py  (12 KB)
│   ├── tiktok_monitor_v2.py
│   ├── tm_assets.py  (7 KB)
│   ├── tm_common.py  (6 KB)
│   ├── tm_core.py  (20 KB)
│   ├── tm_dashboard.py
│   ├── tm_feishu.py  (12 KB)
│   └── tm_reports.py  (4 KB)
├── templates
│   └── 竞品账号清单模板.md
├── .gitignore
├── 00-start-here.md  (2 KB)
├── AGENTS.md
├── PRODUCT.md  (2 KB)
├── README.md  (4 KB)
├── config.example.json  (1 KB)
└── requirements.txt

README

TikTok 竞品视频监控系统 v8

Week4 课堂项目：输入竞品 TikTok 账号，每次采集生成一份可回看的素材快照。前端可以按最近一天 / 7 天 / 1 个月筛选，按账号分组查看视频封面和数据，一键复制文案，单条或批量下载原视频、抽关键帧、提取公开视频脚本，并保存到飞书 Base / 表格 / 文档。

你能用它做什么

竞品账号
-> 最新公开视频数据
-> 条件筛选和发布期限
-> 视频下载
-> 关键帧
-> 字幕 / 脚本
-> 本地 dashboard
-> 飞书素材库
-> 飞书简报

第一次运行

python3 scripts/tiktok_monitor.py setup

如果你希望项目帮你安装 Python 依赖，并在有 Homebrew 的 Mac 上安装 yt-dlp / ffmpeg：

python3 scripts/tiktok_monitor.py setup --install

setup --install 会把 Python 依赖装进项目本地 .venv，不改系统 Python；之后继续使用下面这些 python3 scripts/tiktok_monitor.py ... 命令即可，脚本会自动切到本地环境。

确认环境后跑完整 demo：

python3 scripts/tiktok_monitor.py demo --with-assets

这会跑：

  • 初始化目录和 config.json；
  • 环境检查；
  • 新建一次采集记录；
  • 账号扫描；
  • 素材日报；
  • 命中视频下载；
  • 关键帧抽取；
  • 字幕脚本拉取；
  • 本地截图和 e2e 日志。

打开前端控制台

python3 scripts/tiktok_monitor.py serve

浏览器打开：

http://127.0.0.1:8765

前端分成三个工作区：

  • 新采集：只负责新增账号、设置最近一天 / 7 天 / 1 个月、处理选项、发布期限，然后用右下角 开始采集 新开一次采集。
  • 历史采集：只负责回看往次采集、按账号看横向视频表、一键复制文案、单条 / 批量下载原视频、提取脚本、重试失败项，并用右下角 保存到飞书 保存当前采集。
  • 设置：只负责默认采集、定时、飞书和本机依赖状态。

界面优先使用 Shoelace Web Components；如果课堂网络导致组件 CDN 没加载，会自动降级成样式化的原生控件，仍然可以配置和运行。

飞书保存

你可以直接在前端粘贴以下任意一种链接。采集出结果后，点右下角 保存到飞书：

  • 飞书 Base / 多维表格链接；
  • 飞书电子表格链接；
  • 飞书文档链接。

也可以用命令行：

python3 scripts/tiktok_monitor.py save-feishu --target-url "你的飞书链接"

如果想让系统自动新建一个 Base：

python3 scripts/tiktok_monitor.py setup-base

项目会把本机配置写入 config.json。这个文件不会进入学员 zip。

飞书简报

先在前端或 config.json 配置：

{
  "feishu": {
    "chat_id": "oc_xxx",
    "send_enabled": true,
    "dry_run": false
  }
}

然后运行：

python3 scripts/tiktok_monitor.py send-brief

没有 chat_id 时只会生成：

reports/feishu-brief.md

不会乱发消息。

定时

生成 macOS LaunchAgent 配置：

python3 scripts/tiktok_monitor.py schedule

安装到本机：

python3 scripts/tiktok_monitor.py schedule --install

默认每天运行：

python3 scripts/tiktok_monitor.py daily

daily 会扫描、下载素材、生成 brief，并按配置尝试同步飞书。

输出位置

data/pulls/                  视频元数据快照
data/runs/                   每次采集记录
data/assets/videos/          下载的视频
data/assets/frames/          关键帧和 contact sheet
data/assets/transcripts/     字幕脚本
reports/                     日报和 brief
app/index.html               前端界面
logs/                        e2e、飞书、定时日志

安全边界

项目包不包含：

  • config.json
  • data/monitor.sqlite
  • data/assets/
  • data/pulls/
  • data/runs/
  • reports/
  • logs/
  • .env
  • cookie / token / signed video url

本项目只处理公开视频。没有字幕的视频不会伪造脚本；需要逐字稿时，请安装本地 whisper 或接入 ASR 后重跑 assets。