抖音视频爬取工具
这是一个面向 macOS 的抖音视频下载项目。
它当前采用“两步式”方式工作：
- 先启动一个可见的 Chrome 浏览器，让你手动登录抖音并完成验证码
- 再让脚本附着到这个浏览器，抓取博主主页当前已加载的作品视频并下载到本地
这个项目已经完成过真实验证：在本机登录成功后，可以正常下载视频到 video/ 目录。
适合谁使用
适合以下用户：
- 使用 Mac
- 项目已经在本地
- 想快速下载某个抖音博主主页当前可见的作品视频
当前能做什么
- 启动一个带调试端口的 Chrome 浏览器
- 手动登录抖音后附着到浏览器
- 自动识别当前浏览器页面是博主主页还是单视频页
- 抓取某个博主主页当前已加载的作品
- 下载当前单视频页对应的那一条视频
- 下载视频到本地
video/目录 - 支持传入指定博主主页 URL、单视频 URL 或
aweme_id
当前不能做什么
- 不能自动帮你登录抖音
- 不能自动替你过验证码
- 不能默认抓完整个博主的全部历史作品
- 不能抓任意网页
- 不能自动筛选你想要的视频
快速开始
如果你已经把项目下载到本地，最快的使用方式是：
cd /你的项目目录/douyin-crawler-poc
python3 -m venv .venv
source .venv/bin/activate
pip install requests DrissionPage
./.venv/bin/python login_douyin.py
./.venv/bin/python Douyin.py
说明：
- 第一个命令用于创建虚拟环境
- 第二个命令用于进入虚拟环境
- 第三个命令用于安装依赖
- 第四个命令会打开 Chrome，让你登录抖音
- 第五个命令会读取你当前浏览器页面并自动开始抓取或下载
如果自动判断失败，也可以手动传入一个目标：
./.venv/bin/python Douyin.py "https://www.douyin.com/user/你的博主主页"
./.venv/bin/python Douyin.py "https://www.douyin.com/video/某个视频ID"
./.venv/bin/python Douyin.py "7619989983668240802"
下载结果在哪里
抓取成功后，视频会保存到项目根目录下的 video/ 文件夹。
文件名格式一般是：
视频标题-aweme_id.mp4
详细图文说明
详细操作步骤请看这份手册：
如果你完全不会代码，建议直接从这份手册开始照着做。
相关文档
当前验证状态
当前项目已验证：
- 单元测试通过
- 登录浏览器入口可用
- 抖音抓取脚本可附着到浏览器
- 成功下载出 mp4 文件