狂野飙车6鸿蒙版
471.84M · 2025-10-31
言归正传！今天要分享的是我新折腾的「豆瓣→Notion 同步工具」
先上效果：同步后的 Notion 长这样！✅
我同步了我 “想看” 的书，每一条都带着豆瓣原链接，点进去就能跳转到豆瓣详情页，后续在 Notion 里做读书计划、加笔记都超方便～
没那么复杂，核心就 4 个文件：
| 文件名 | 作用 |
|---|---|
douban.py | 抓取豆瓣数据（带节流、重试、增量早停） |
notion_sync.py | Notion 交互（创建数据库、写入、去重） |
sync.py | 命令行入口（调同步逻辑） |
config.json | 配置文件（填 Cookie、Token、ID） |
我把核心功能拆成了 3 部分代码，每部分都加了详细注释，看不懂的地方可以私聊我哦～
1. 第一步：爬取豆瓣数据（douban.py关键代码）
主要负责从豆瓣抓 “标题、详情链接”，还加了去重和防反爬(比如 User-Agent、超时控制):
import requests
from bs4 import BeautifulSoup
# 防反爬用的请求头，别改！改了可能被豆瓣封
HEADERS = {
"User-Agent": (
"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) "
"AppleWebKit/537.36 (KHTML, like Gecko) "
"Chrome/119.0.0.0 Safari/537.36"
)
}
# 豆瓣书/影/音的基础链接，按类型匹配
HOSTS = {
"book": "<https://book.douban.com>",
"movie": "<https://movie.douban.com>",
"music": "<https://music.douban.com>",
}
# 豆瓣状态对应：done=已看/已读，wish=想看/想读，doing=在看/在读
STATUS = {"done": "collect", "wish": "wish", "doing": "do"}
def fetch_douban_minimal(user_id: str, cookie: str, content_type: str = "movie", status: str = "done"):
"""
抓指定用户的豆瓣数据（一页）
:param user_id: 豆瓣数字ID（不是昵称！）
:param cookie: 豆瓣登录Cookie
:param content_type: 类型：book/movie/music
:param status: 状态：done/wish/doing
:return: 去重后的条目列表（含title和url）
"""
# 拼接请求链接
host = HOSTS.get(content_type, HOSTS["movie"]) # 默认抓电影
seg = STATUS.get(status, "collect") # 默认抓“已看”
url = f"{host}/people/{user_id}/{seg}?mode=grid" # grid模式页面更规整，好爬
# 加Cookie（必须登录才能抓个人收藏）
headers = dict(HEADERS)
headers["Cookie"] = cookie.strip() # 别漏了strip()，避免多余空格
# 发请求（超时15秒，防止卡着）
try:
r = requests.get(url, headers=headers, timeout=15)
r.raise_for_status() # 404/500会直接报错，方便排查
except Exception as e:
print(f"抓豆瓣数据报错：{e}，先检查Cookie对不对！")
return []
# 解析页面，提取标题和链接
soup = BeautifulSoup(r.text, "html.parser")
items = []
for a_tag in soup.select("a"):
href = a_tag.get("href", "")
if "/subject/" in href: # 豆瓣条目链接都带/subject/
title = (a_tag.get("title") or a_tag.text).strip()
if title: # 过滤空标题
# 清理链接（去掉?后面的参数，只留基础链接）
clean_href = href.split("?")[0]
items.append({"title": title, "url": clean_href})
# 去重（按豆瓣链接去重，避免重复抓）
unique_items = {}
for item in items:
unique_items[item["url"]] = item
return list(unique_items.values())
2. 第二步：同步到 Notion（notion_sync.py关键代码）
用Notion官方SDK写的，只需要传Token和数据库ID，就能自动创建条目：
from notion_client import Client
from typing import Dict, List
def create_notion_page_minimal(
token: str,
database_id: str,
douban_item: Dict[str, str]
) -> bool:
"""
往Notion数据库写一条豆瓣条目
:param token: Notion的Internal Integration Token
:param database_id: Notion数据库ID
:param douban_item: 豆瓣条目（含title和url）
:return: 成功返回True，失败返回False
"""
# 初始化Notion客户端
try:
notion = Client(auth=token)
except Exception as e:
print(f"Notion客户端初始化失败：{e}，检查Token是不是secret_开头！")
return False
# 创建页面（注意：Notion数据库字段要和这里的“Name”“URL”对应！）
try:
notion.pages.create(
parent={"database_id": database_id},
properties={
"Name": { # 这个“Name”是Notion数据库的“标题字段名”，要和你的数据库对应
"title": [{"text": {"content": douban_item["title"]}}]
},
"豆瓣链接": { # 这个“豆瓣链接”是我在Notion里建的“URL字段名”，你们可以改
"url": douban_item["url"]
}
}
)
print(f"成功同步：{douban_item['title']}")
return True
except Exception as e:
print(f"同步到Notion失败：{e}，可能是数据库没共享给集成！")
return False
# 批量同步的函数（一次同步多个条目）
def batch_sync_to_notion(
token: str,
database_id: str,
douban_items: List[Dict[str, str]]
) -> None:
for item in douban_items:
create_notion_page_minimal(token, database_id, item)
3.第三步：整合调度（sync.py关键代码）
import json
from douban import fetch_douban_minimal
from notion_sync import batch_sync_to_notion
def main():
# 读配置文件（config.json要自己填哦～）
try:
with open("config.json", "r", encoding="utf-8") as f:
config = json.load(f)
except Exception as e:
print(f"读配置文件报错：{e}，先检查config.json在不在项目文件夹里！")
return
# 从配置里拿参数
douban_user = config.get("douban_user", "") # 豆瓣数字ID
douban_cookie = config.get("douban_cookie", "") # 豆瓣Cookie
notion_token = config.get("notion_token", "") # Notion Token
notion_database_id = config.get("notion_database_id", "") # Notion数据库ID
# 检查必填配置（少一个都不行）
if not all([douban_user, douban_cookie, notion_token, notion_database_id]):
print("⚠️ 配置没填全！douban_user、douban_cookie、notion_token、notion_database_id都要填！")
return
# 这里改同步类型和状态（比如想同步电影“已看”，就把content_type改成movie，status改成done）
douban_items = fetch_douban_minimal(
user_id=douban_user,
cookie=douban_cookie,
content_type="book", # 可选：book/movie/music
status="wish" # 可选：wish（想看/想听）、done（已看/已听）、doing（在看/在听）
)
if not douban_items:
print("没抓到豆瓣数据，先检查Cookie和用户ID对不对！")
return
# 批量同步到Notion
print(f"共抓到{len(douban_items)}条数据，开始同步到Notion...")
batch_sync_to_notion(notion_token, notion_database_id, douban_items)
print("同步完成！去Notion看看吧～")
if __name__ == "__main__":
main()
config.json是唯一要改的文件，里面的 4 个参数，我一步步教你们怎么拿
cookie的话,大家都是程序员,就不用我教了吧?(豆瓣的控制台还有招聘信息呢～
NotionPageId
https://www.notion.so/xxxxxx?v=xxx，中间的 xxxxxx 就是 ID（32/36 位字符）；
Notion Token
点击进入notionAPI后台
如图创建你的集成器
如图给你的集成器添加前面新建的notion页面的访问权限(记得一定要点击保存哦
这个小工具我个人还是挺满意的,就是现在个性化太强,没能达到通用的工具效果,不知道小伙伴们有没有相关需求,如果有的话我就加班加点搞出来,我能想到的优化的地方有:
你们最想要哪个功能？或者有其他需求，评论区告诉我～需求多的话，我这周搞出来，到时候再分享一次！
最后再提醒 2 个小细节：
config.json里的 Cookie 和 Token，千万别提交到 GitHub，也别发给别人（Cookie 能登录你的豆瓣，Token 能操作你的 Notion）；
