Notion 剪藏挂了?我修了个 Web Clipper 修复版
最近打开浏览器想剪藏网页到 Notion,结果发现 Web Clipper 扩展完全挂了——点击保存按钮后一直转圈,最后报 401 授权错误。
排查了一番发现,原来是 Notion 私有 v3 接口做了变更,加上安全策略收紧,之前依赖的 Cookie 认证方式已经彻底失效。
【问题根因】
Web Clipper 原作者使用的是 Notion 内部私有 v3 API,这种接口没有公开文档,随时可能变更;依赖 Cookie/Session 认证,Notion 正在逐步收紧。
【我的修复方案】
既然私有 API 不稳定,不如拥抱官方路线。我把扩展改造成了 Notion 官方 v1 REST API + PAT(个人访问令牌)模式。
1. 用户在 Notion 后台创建 Integration,获取 PAT Token
2. 在扩展设置中填入 Token
3. 通过官方 REST API 进行所有操作
【主要改动】
重写了核心逻辑,从私有 API 迁移到官方 REST API;新增 PAT 配置表单,支持 Token 验证;兼容 Notion 最新的 page、database、data_source 类型;更新了多语言文件。
【如何使用】
GitHub 仓库:zq7969/web-clipper-notion-pat-fixed
下载 Release 中的 Chrome/Edge MV3 扩展包
在浏览器扩展管理中加载解压后的扩展
按指引在 Notion 中创建 Integration 并生成 PAT
在扩展设置中填入 PAT,选择知识库即可开始剪藏

【总结】
这次折腾最大的体会是:依赖私有 API 的工具注定不稳定。Web Clipper 是一个很好用的开源工具,但在 Notion 接口变更面前也显得脆弱。迁移到官方 REST API 虽然需要一些工程投入,但换来的是长期的稳定性。
如果你也在受 Notion 剪藏困扰,不妨试试这个修复版。GitHub 上有完整的 Release Notes 和安装指南。
作者提示含AI生成内容。作者声明本文无利益相关,欢迎值友理性交流,和谐讨论~
