最近想剪藏网页到 Notion,结果发现 Web Clipper 扩展点击保存后一直转圈,最后报 401 授权错误。排查后确认是 Notion 私有 v3 接口变更 + 安全策略收紧,原有的 Cookie 认证方式彻底失效了。
考虑到私有 API 维护成本太高(接口没文档,说变就变),我 fork 了原项目 webclipper/web-clipper,改造为 Notion 官方 v1 REST API + PAT(个人访问令牌)认证模式。
已发布版本:
v1.42.0-pat-fixed
主要改动:
核心服务从 Notion 私有 v3 API 迁移到官方 v1 REST API(API 版本 2026-03-11)
移除 Cookie/Session 认证,改用 PAT Token(ntn_ 或 secret_ 开头)
类型兼容:支持 Notion 最新的 page / database / data_source 三种对象类型
新增 PAT 校验表单,输入 Token 后可验证并列出已授权的知识库
使用步骤:
- GitHub Release 下载 web-clipper-chrome.zip 并解压
- 浏览器打开扩展管理页(chrome://extensions),开启开发者模式
- 点击「加载已解压的扩展程序」,选择解压后的文件夹
- 登录 Notion → Settings & Members → Integrations → Develop your own integrations → New integration
- 创建完成后复制 Internal Integration Token(PAT,ntn_ 开头)
- 回到你想剪藏的 Notion 页面/数据库,点击右上角「…」→ Add connections → 选择刚刚创建的 Integration(重要!否则 API 搜不到页面)
- 回到浏览器扩展设置,选择 Notion 服务,粘贴 PAT 并选择默认知识库即可开始剪藏
GitHub 地址:
