个人开发者 intellectronica 写的 Notion 技能:不走 MCP,让代理用 curl 和 jq 直接调用 Notion REST API,搜索内容、读写页面和块、查询和创建数据库与数据源、读写评论,SKILL.md 里每个端点都给了请求示例。
skills.sh 安装量 98110(+518 / 24h)
安全审计:未审计
- 尚未扫描
理由
- 凭据处理写清:先找环境变量 NOTION_API_TOKEN,其次用用户在对话里给的,都没有就问用户;要求 Token 只放在 Authorization 请求头里,不显示、不写日志
- 改动前先确认:更新页面或块、归档删除、改数据库结构、批量建页都要先问用户,一组相关操作确认一次
- 按 Notion-Version 2025-09-03 编写,覆盖新的数据源(data source)接口;附分页写法、429 限流退避和请求大小上限
- 仓库为 CC0 许可;skills.sh 24 小时安装 518,累计 98110,近 8 周每周安装从 2335 升到 5232(只代表关注度)
用法
- 安装命令待审计通过后显示;让代理“读 / 改 Notion 页面”“查 Notion 数据库”时触发
- 需要 Notion 集成的 API Token(设为环境变量 NOTION_API_TOKEN),本机需要 curl 和 jq
风险
- 本期未审计,固定 C 级、不显示安装命令;SKILL.md 让代理执行 curl 访问 api.notion.com 并读取 NOTION_API_TOKEN,与用途相符;skills.sh 上 Gen Agent Trust Hub 审计为 Pass
- 不是 Notion 官方出品;Token 如果贴在对话里会留在对话记录中,用环境变量更稳妥
- 代理有归档页面、删除块的能力,事前确认靠代理遵守;Notion API 版本更新后示例可能过时