拿到手的是什么

TikTok 竞品调研数据工具(快照版)v1 — 预览

单文件小工具:输入 2-3 个竞品 TikTok 账号,单次抓取公开视频数据,输出 CSV + Markdown 报告,自动标出最近爆款。零 pip 依赖(实时抓取需 yt-dlp),--demo 模式无网络也能跑通。

包内文件

scott-tiktok-competitor-snapshot-v1.zip
├── 00-start-here.md          一页快速上手
├── README.md                 完整说明(装/跑/输出/FAQ)
├── AGENTS.md                 AI agent 操作指引
├── CLAUDE.md                 同 AGENTS.md
├── snapshot.py               唯一源码文件
├── competitors.example.csv   CSV 输入示例
└── examples/
    ├── report.md             演示报告(--demo 实跑产出)
    └── report.csv            演示数据表

核心用法

python3 snapshot.py --demo                    # 演示模式,什么都不用装
python3 snapshot.py shopify duolingo          # 抓真实账号(需 pip3 install yt-dlp)
python3 snapshot.py --csv competitors.example.csv --limit 10

demo 输出节选(真实跑通)

终端:

完成:16 条视频,3 条最近爆款 -> output/report.md

output/report.md:

# TikTok 竞品快照报告

> ⚠️ 演示模式:以下为内置虚构数据,账号和数字均为编造,仅用于体验流程。

- 账号数:3 | 视频数:16 | 最近爆款:3 条
- 爆款规则:7 天内发布 + 播放 ≥ 账号中位数 x3 + 播放 ≥ 1,000

## 🔥 最近爆款

| 标题 | 发布时间 | 播放 | 点赞 | 评论 | 分享 | 互动率 | 爆款 |
| --- | --- | ---: | ---: | ---: | ---: | ---: | :---: |
| 3 秒去掉牛油果核的小工具 | 2026-07-05 11:30 | 182,000 | 21,400 | 980 | 3,100 | 14.00% | 🔥 |
| 早上 10 分钟拉伸跟练 | 2026-07-04 11:30 | 96,000 | 12,800 | 640 | 2,400 | 16.50% | 🔥 |
| 理线 3 分钟教程 | 2026-07-01 11:30 | 68,000 | 8,900 | 510 | 1,900 | 16.63% | 🔥 |

output/report.csv(UTF-8 BOM,Excel / 飞书表格直开):

handle,video_id,title,published_at,view_count,like_count,comment_count,share_count,duration,engagement_rate,is_recent_hot,webpage_url
demo_kitchen,7000000000000000000,3 秒去掉牛油果核的小工具,2026-07-05 11:30,182000,21400,980,3100,28,0.14,yes,https://...