SuperAPI AI 工具集

notion-2

办公与效率

查看项目

更新于 10-16 06:15

技能介绍

用途:让智能体通过官方 Notion API 处理 Notion 页面和数据库。该技能为声明式,只记录安全、推荐的操作,实际 API 调用由本地 CLI(notion-cli)完成。

认证:在 https://www.notion.so/my-integrations 创建 Notion 集成,复制 Internal Integration Token,导出为 export NOTION_API_KEY=secret_xxx,并将集成共享给需要访问的页面或数据库;未共享内容对 API 不可见。

配置文件:可通过环境变量或配置定义多个配置文件(如 personal、work),默认 personal,用 export NOTION_PROFILE=work 覆盖。

页面操作:读取页面 notion-cli page get <page_id>;追加块 notion-cli block append <page_id> --markdown "...",优先追加而非重写内容;创建页面 notion-cli page create --parent <page_id> --title "..."。

数据库操作:查看结构 notion-cli db get <database_id>;查询 notion-cli db query <database_id> --filter <json> --sort <json>;创建行 notion-cli page create --database <database_id> --props <json>;更新行 notion-cli page update <page_id> --props <json>。

结构变更(高级):应用前先检查差异,未经明确确认不得修改数据库结构。推荐流程:notion-cli db schema diff <database_id> --desired <json>,再 notion-cli db schema apply <database_id> --desired <json>。

安全与限制:Notion API 有速率限制,需谨慎批量操作;优先追加和更新而非破坏性操作;ID 不透明,应显式存储,不要从 URL 推断。