douban-backup 快速上手:5 分钟零配置导出豆瓣书影音 Excel
douban-backup 快速上手:5 分钟零配置导出豆瓣书影音 Excel
douban-backup 是一个命令行豆瓣备份工具:一条命令即可把你在豆瓣的电影 / 音乐 / 图书 / 游戏 / 剧集标记(想看 · 在看 · 看过)全部抓下来,存进 SQLite,并导出为一份 14 个 sheet、结构规范的 Excel 工作簿(douban_interests.xlsx)。整个项目只有一个 Python 脚本 douban_backup.py,uv run 直跑、零配置,适合想给自己的豆瓣账号做数据备份、又讨厌复杂部署的新手。
🎯 为什么需要豆瓣账号备份?
你的豆瓣标记数据散落在网页里,随时可能:
- 换设备、换账号后无法批量查看;
- 想统计"今年读了多少书、评了几星"却没有结构化数据;
- 豆瓣服务策略变化导致数据无法迁移。
douban-backup 把这一切变成可反复运行、可增量更新的本地数据库 + Excel 文件,数据真正握在自己手里。
✅ 准备工作:只需要 2 件事
| 准备项 | 说明 |
|---|---|
| 安装 uv | 快速 Python 包管理器,macOS 执行 brew install uv 即可 |
| 已登录豆瓣 | 在 Chrome / Edge / Brave / Firefox / Safari 任一浏览器中登录 douban.com |
uv 会自动安装脚本所需的全部依赖(requests、beautifulsoup4、lxml、openpyxl 等),不需要你手动 pip install。
拿到代码(仓库地址:git clone https://gitcode.com/gh_mirrors/dou/douban-backup),进入目录即可开始。
🚀 一键运行:1 条命令完成备份
uv run douban_backup.py
就这一条命令。脚本会:
- 自动从浏览器读取豆瓣登录 cookie(默认依次尝试已安装的浏览器);
- 抓取当前账号全部 5 类 × 3 状态的标记数据;
- 写入本地 SQLite 数据库
douban_backup.db; - 导出
douban_interests.xlsx到当前目录。
💡 不想用 uv?也可以
pip install requests beautifulsoup4 lxml browser_cookie3 openpyxl后直接python douban_backup.py。
macOS 用户首次读取 Chrome cookie 时系统会弹钥匙串授权框,点「始终允许」即可。
🔐 Cookie 配置:3 种方式任选
Cookie 是读取豆瓣数据的关键,脚本支持 3 种提供方式(详见 README.md):
| 方式 | 命令 |
|---|---|
| 自动读浏览器(默认,推荐) | uv run douban_backup.py |
| 指定浏览器 | uv run douban_backup.py --browser chrome |
| 手动粘贴 cookie 串 | uv run douban_backup.py --cookie 'ck=xxx; dbcl2="123:abc"; bid=yyy' |
手动获取 cookie 的方法:浏览器打开 douban.com → F12 打开开发者工具 → Network → 点任意请求 → 复制请求头里的 Cookie 整串。
📊 导出的 Excel 长什么样?
导出格式与 Chrome 扩展「豆伴」的结构完全一致,方便无缝迁移。工作簿固定包含 14 个 sheet,按"类型 / 状态"拆分并中文命名(定义见 douban_backup.py):
- 电影:
看过 / 在看 / 想看 - 音乐:
听过 / 在听 / 想听 - 图书:
读过 / 在读 / 想读 - 游戏:
玩过 / 在玩 / 想玩 - 剧集:
看过的舞台剧 / 想看的舞台剧(剧集无「在看」)
每个 sheet 有统一的 9 列固定表头(douban_backup.py):
标题 / 简介 / 豆瓣评分 / 链接 / 创建时间 / 我的评分 / 标签 / 评论 / 可见性
sheet 内按标记 id 倒序排列,打开即可浏览,也方便在 Excel 里筛选、透视分析。
🛠️ 常用参数速查
| 参数 | 作用 |
|---|---|
--user ID |
备份指定用户的数字 ID(默认当前登录账号) |
-o, --output |
指定导出路径,支持 .xlsx 或 .csv |
--interval |
请求间隔秒数(默认 1.0,遇 429 可调大) |
--no-export |
只备份到数据库,不导出文件 |
--export-only |
仅从已有数据库重新导出,不抓取 |
-v, --verbose |
输出调试日志 |
实用示例:
# 只重新导出,不再抓取(最快)
uv run douban_backup.py --export-only -o 我的标记.xlsx
# 备份别人的公开数据(需对方数字 ID)
uv run douban_backup.py --user 12345678
# 放慢请求速度,避免被限流
uv run douban_backup.py --interval 2
🔁 增量备份:放心反复运行
每次运行以时间戳为版本号,只有当某条目的状态 / 短评 / 评分 / 标签发生变化时才会更新数据库(增量逻辑见 douban_backup.py),旧版本归档到 history 字段形成历史轨迹,完全相同的重复标记不会产生冗余数据。也就是说:今天备份一次,下个月再备份一次,变化清晰可追溯,而且不会越跑越大。
⚠️ 注意事项
- 默认请求间隔 1 秒;如遇 429 / 限流,请调大
--interval; - cookie 会过期,出现"未登录"提示时重新获取即可;
- 已删除的豆瓣标记无法通过备份恢复;
- 请仅用于备份自己的或你有权访问的公开数据,遵守豆瓣使用条款。
📁 项目文件一览
| 文件 | 说明 |
|---|---|
| douban_backup.py | 核心脚本:客户端、SQLite 存储、抓取与导出全部在这一个文件里 |
| README.md | 完整文档:特性、参数、导出格式说明 |
| LICENSE | MIT 开源协议 |
5 分钟,一条命令,你的豆瓣书影音标记就有了自己的"离线档案"。建议把 uv run douban_backup.py 加进定期习惯,数据备份这件事,早做一次早安心。
<输出文章结束>