详细教程 -> https://zhuzi.dev/posts/2021-06-05-douban-backup-sync-notion/
.
├── archive # 不再使用的实验时的爬虫脚本
├── cols.json # 可修改自定义的 Notion 表格列名
├── .env # 如果需要在本地 debug，可以添加这个文件
├── scripts # 长期不需要使用的脚本，但未来有可能需要使用
├── src # 会保持更新正在使用的脚本👩🏻💻👈
└── userscript # 导出时可使用的油猴脚本
使用油猴脚本 export.user.js导出的 CSV 数据样例（one row）
{
'标题': '无间双龙：这份爱，才是正义 / ウロボロス～この愛こそ正 義。',
'个人评分': '5',
'打分日期': '2015/03/21',
'我的短评': '5星打的绝对不是剧情！为建国，为toma，为一众cast就 是如此任性ˊ_>ˋ(1 有用)',
'上映日期': '2015/01/16',
'制片国家': '日本',
'条目链接': 'https://movie.douban.com/subject/25953663/'
}
Notion 数据库 properties 样例数据
{
'条目链接': {
id: '=jBf',
type: 'url',
url: 'https://movie.douban.com/subject/26277363/'
},
'IMDb 链接': {
id: '@ME}',
type: 'url',
url: 'https://www.imdb.com/title/tt5419278'
},
'主演': { id: 'X{lL', type: 'rich_text', rich_text: [[Object]] },
'个人评分': {
id: 'Z^ph',
type: 'multi_select',
multi_select: [ { id: 'FRXk', name: '5', color: 'pink' } ]
// multi_select: [], // empty array if no value for rating
},
'打分日期': {
id: 'e\\{[',
type: 'date',
date: { start: '2021-01-19', end: null }
},
'类型': {
id: 'pzY>',
type: 'multi_select',
multi_select: [[Object], [Object]]
},
'海报': {
id: 't@Fv',
type: 'files',
files: [
{
name: 'https://img3.doubanio.com/view/photo/s_ratio_poster/public/p2524998570.jpg'
}
]
},
'我的短评': { id: 'wG?R', type: 'rich_text', rich_text: [[Object]] },
'上映年份': { id: 'xghA', type: 'number', number: 2016 },
'导演': { id: 'y]UL', type: 'rich_text', rich_text: [[Object]] },
'标题': { id: 'title', type: 'title', title: [[Object]] }
}
豆瓣RSS 数据解析之后的例子
#竹子哟竹子#✨ 的收藏
{
creator: '#竹子哟竹子#✨',
title: '想看白蛇传·情',
link: 'http://movie.douban.com/subject/34825976/',
pubDate: 'Mon, 31 May 2021 15:14:58 GMT',
'dc:creator': '#竹子哟竹子#✨',
content:
` 
推荐: 很差/较差/还行/推荐/力荐
\n' +
' 
\n' +
'推荐: 还行
备注: 测试
短评第 2 行
'
'
RSS 的好处一个是轻量，但又包含了个人标记的最重要的几个数据：名字、条目链接、时间、评分、短评。 所以需求可以转换为，定时获取 RSS 更新，并对新的条目进行抓取信息并同步到 notion database。
但需要注意的是，豆瓣的 RSS 数据每次都只保留 10 个，并且包括想看、想听、想读。本人的脚本同步到 Notion 的部分仅处理看过、听过、读过的条目，如果某一天集中标记数量过多，可能使 RSS 数据并未全部被 workflow 获取。 这种情况的时候请自己手动触发脚本的运行，或者将脚本运行间隔时间改短，比如每个小时或者每两个小时。
GitHub 免费用户的开源仓库，actions 暂时是完全免费，也不计时间。
每条链路可独立开关（环境变量 / GitHub Actions repository variables）。未设置时的默认值如下：
| Variable | 默认 | 说明 |
|---|---|---|
SYNC_DOUBAN_NOTION |
0 |
豆瓣 RSS → Notion |
SYNC_DOUBAN_NEODB |
1 |
豆瓣 RSS → NeoDB |
SYNC_DOUBAN_BANGUMI |
1 |
豆瓣 RSS → Bangumi |
SYNC_BANGUMI_NEODB |
1 |
Bangumi 收藏 → NeoDB |
取值为 1 / true / on 启用，0 / false / off 关闭。关闭全部 Douban→* 时会跳过拉取豆瓣 RSS。
本地示例（只开你需要的三条）：
SYNC_DOUBAN_NOTION=0
SYNC_DOUBAN_NEODB=1
SYNC_DOUBAN_BANGUMI=1
SYNC_BANGUMI_NEODB=1若 GitHub Actions 拉豆瓣 RSS 出现超时 / 403 / 401，多半是豆瓣拦截机房 IP 或缺浏览器 UA。脚本已带浏览器 UA，并对超时与部分 5xx/403 做有限重试；若仍失败，可设 DOUBAN_RSS_USER_AGENT，或暂时只开 SYNC_BANGUMI_NEODB（豆瓣失败时 Bangumi→NeoDB 仍会继续跑，但 workflow 会以非 0 退出提示 Douban 段失败）。
在文档页面先生成一个 Token，然后给 repo 添加一个 secret 叫 NEODB_API_TOKEN。
可选：添加 NEODB_VISIBILITY（本地 .env 或 GitHub Actions repository variable）控制同步到 NeoDB 时标记的可见性。对应标记弹窗里的三个单选：
| 值 | 含义 |
|---|---|
0 |
公开 |
1 |
仅关注者 |
2 |
自己和提到的人（默认） |
Douban→NeoDB 与 Bangumi→NeoDB 写入 mark 时都会带上该值；若与 NeoDB 上已有可见性不同，同步会更新（不会因「状态/评论/评分相同」而跳过）。
需同时开启 SYNC_DOUBAN_NEODB=1（默认已开）才会走豆瓣这条；Bangumi→NeoDB 另见下方。
- 打开 个人令牌页面（需先在 next.bgm.tv 登录），创建一个 Access Token。
- 创建时尽量选择最长有效期（常见约 1 年；官方没有永久选项）。
- 给 repo 添加 secret：
BANGUMI_ACCESS_TOKEN。 - 保持
SYNC_DOUBAN_BANGUMI=1（默认已开）。
可选 repository variables：
| Variable | 默认 | 说明 |
|---|---|---|
BANGUMI_PRIVATE |
false |
是否将收藏设为仅自己可见 |
BANGUMI_USER_AGENT |
douban-backup/1.0 (...) |
Bangumi 要求带 User-Agent |
BANGUMI_COLLECTION_LIMIT |
50 |
Bangumi→NeoDB 每次增量条数（最大 50） |
Token 会过期：个人令牌没有 refresh，到期后需自行回页面重新生成，并更新 BANGUMI_ACCESS_TOKEN。若 workflow 日志出现 401 /「token 可能已过期」提示，就是这个原因。详见 个人令牌说明。
匹配策略：优先通过 NeoDB 的 external_resources 找到 Bangumi 条目；找不到再用标题精确搜索。豆瓣「话剧」仅在 NeoDB 已挂 Bangumi 链接时同步。Bangumi 无法写入标记时间，豆瓣打分日期会丢失。
冲突处理：豆瓣 RSS 没有「搁置 / 抛弃」。若 Bangumi 已是搁置/抛弃，或 NeoDB 已是 dropped，Douban→* 不会覆盖，以免冲掉目标端独有状态。
Bangumi→NeoDB 状态映射：想看→wishlist，在看→progress，看过→complete，搁置→progress（在玩），抛弃→dropped。
重复条目：NeoDB 可能对同一作品有豆瓣源 / Bangumi 源两个 catalog。Bangumi→NeoDB 会优先写到带豆瓣外链的那条（与 Douban→NeoDB 共用 uuid）：先看 Bangumi 条目的 external_resources，没有则按标题精确搜索带豆瓣链接的 twin。若仍对不上，仍可能各标一条，需等 NeoDB 目录合并或补全外链。已出现的重复可手动删掉 Bangumi 源那条标记，再同步即可落到豆瓣源。
覆盖类型：书籍、动画/三次元影视、音乐、游戏。
同时配置了 BANGUMI_ACCESS_TOKEN 与 NEODB_API_TOKEN，且 SYNC_BANGUMI_NEODB=1（默认已开）时，定时任务会额外拉取最近一批 Bangumi 收藏（默认 50 条）并同步到 NeoDB。标记未变时仍会写入进度。进度来自收藏里的 ep_status / vol_status（不再请求 Bangumi 章节接口）：动画/三次元剧集用 ep_status→episode（NeoDB 分类为 movie 的电影/剧场版不写进度，避免 API 400），书籍优先 vol_status 否则 ep_status→chapter，音乐用 ep_status→track；游戏不同步进度。数值为 0 时不写、也不删除 NeoDB 上已有进度。豆瓣没有进度，Douban→NeoDB 不写、不删 progress。
首次全量迁移，或需要把历史条目的可见性等按当前配置刷一遍时，请手动运行（不要放进默认 cron）：
npm run sync:bangumi-full这只会跑 Bangumi→NeoDB（分页拉完你的 Bangumi 收藏），不会跑豆瓣 RSS，也不会改 Bangumi 上的收藏。对已在 NeoDB 上的同一 uuid，会按 Bangumi 的状态/评分/评论/NEODB_VISIBILITY 更新 mark，并尽量同步进度；与豆瓣先前写入冲突时，以这次 Bangumi→NeoDB 写到的字段为准（同一条 uuid 上后写覆盖先写的对应字段）。
也可以在本地 / Actions 设 BANGUMI_FULL_SYNC=1 后执行 npm run sync（会先跑已开启的 Douban→*，再全量 Bangumi→NeoDB）。
-
补全 notion 中的海报- 同步时会正常插入海报信息，海报图片是豆瓣上的图片的 URL，所以在 notion 中显示不稳定。但因为 notion API 不支持上传文件，所以也无法直接插入图片。暂时不做任何优化。
-
userscript 添加导出 在* 和 想* 的功能- 想* 的部分已更新
- 在* 的部分感觉个人需求实在不太大，已搁置
- 豆瓣的标记同步更新到 NeoDB
- 豆瓣的标记同步更新到 Bangumi
- Bangumi 的标记同步更新到 NeoDB
- 添加 在* 或者 想* 列表，考虑一下如何显示？
- 从别处更新条目，比如 NeoDB，因为部分条目在豆瓣被删除或未创建