用途:在终端或智能体中日常操作 Notion,完成查找页面、从数据库取答案、经确认后修改页面属性等工作流。它面向 Notion 平台的工具操作,不涉及构建集成或应用开发。
主要能力:通过 notion-cli 完成页面检索、数据库查询、搜索和页面属性更新。读取只读且有限度;创建与更新受 --dry-run 预览和 --yes 确认双重保护,未加这两个参数时脚本拒绝执行且不调用 API。
使用方式示例: notion/scripts/notion-cli --json pages get --page-id <page> notion/scripts/notion-cli --json --limit 10 databases query --database-id <db> notion/scripts/notion-cli --json search query --query "on-call runbook" notion/scripts/notion-cli pages update --page-id <page> --properties props.json --dry-run notion/scripts/notion-cli pages update --page-id <page> --properties props.json --yes
退出码:0 成功,1 API 错误或检查失败,2 用法错误。读取默认 --limit 20,最大 100。
限制:需 bot 令牌(secret_...),集成只能看到显式共享给它的页面,未共享会返回 404 而非页面缺失;令牌存于 NOTION_TOKEN 环境变量,勿入代码或聊天。默认 Notion-Version 为 2022-06-28,可用 NOTION_VERSION 覆盖。不适用于构建 Notion 集成或应用,也不覆盖其他知识库工具及工作区管理。