用途:让智能体在 Notion 工作区中查找、读取、创建和编辑内容。基于 Notion API(https://api.notion.com/v1/,API 版本 2025-09-03),采用数据源模型:数据库是容器,包含一个或多个数据源,数据源承载属性结构与行(页面)。
主要能力:24 个脚本覆盖搜索、读取、写入、结构管理、评论与跨工作区复制。搜索页面与数据源(search);读取页面元数据与属性(getPage)、数据库及其数据源列表(getDatabase)、数据源属性结构(getDataSource)、数据源行并支持过滤与排序(queryDataSource)、块子内容(getBlockChildren)、单个块(getBlock)、页面正文 Markdown(getPageAsMarkdown)、单个分页属性值(getPageProperty);列出未解决评论(listComments)、用户(listUsers/getUser/getBotUser);创建页面(createPage,可作为数据源行或子页面)、更新页面属性/图标/封面/父级/回收站状态(updatePage)、追加块(appendBlockChildren)、更新或归档块(updateBlock)、删除块(deleteBlock,可恢复);创建数据库(createDatabase)、更新数据库容器(updateDatabase)、创建数据源(createDataSource)、更新数据源结构(updateDataSource);添加评论或回复(createComment);跨工作区复制页面(copyPage,需 source 与 target 两个连接)。
使用方式:这是 agentskills.io 技能。未安装时先执行 npx skills add zapier/connectors --skill notion,然后运行 npm install --omit=dev。需 Node.js 22.18+。按运行方式加载对应参考:MCP 客户端用 references/use-as-mcp.md,终端用 references/use-as-cli.md,作为依赖导入用 references/use-as-sdk.md,无工具访问时用 references/use-as-recipe.md。认证以连接选择器字符串传入,如 zapier:<connection-id>,而非密钥本身。输出为 { data, meta } 信封,可通过 jq 表达式裁剪结果,也可跳过输出校验获取原始数据。
限制:不支持永久删除(仅回收站/恢复)、删除整个数据库或数据源、管理工作区成员或权限、创建或管理数据库视图。写入前若按名称匹配到多个同名项,应停止并让用户确认。搜索仅匹配标题,结果有截断限制。具体收费、价格与平台支持暂未提供。