SuperAPI AI 工具集

notion-automation

办公与效率

查看项目

更新于 10-16 01:09

技能介绍

用途:通过 Rube MCP 调用 Composio 的 Notion 工具集,自动化 Notion 的页面、数据库、区块、评论与用户相关操作。

前提条件:Rube MCP 已连接且 RUBE_SEARCH_TOOLS 可用;需通过 RUBE_MANAGE_CONNECTIONS 使用 notion 工具包建立并确认 ACTIVE 的 Notion 连接;每次操作前先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。

接入方式:在客户端配置中加入 MCP 服务器 https://rube.app/mcp ,无需 API key;确认 RUBE_SEARCH_TOOLS 有响应后,调用 RUBE_MANAGE_CONNECTIONS(toolkit 为 notion),若连接非 ACTIVE,按返回的授权链接完成 Notion OAuth,确认状态为 ACTIVE 后再执行工作流。

主要能力与工具序列:

  1. 页面管理:NOTION_SEARCH_NOTION_PAGE(先查父页面或已有页面)、NOTION_CREATE_NOTION_PAGE、NOTION_RETRIEVE_PAGE、NOTION_UPDATE_PAGE、NOTION_ARCHIVE_NOTION_PAGE、NOTION_DUPLICATE_PAGE。
  2. 数据库查询与管理:NOTION_SEARCH_NOTION_PAGE 定位数据库、NOTION_FETCH_DATABASE 查看 schema、NOTION_QUERY_DATABASE / NOTION_QUERY_DATABASE_WITH_FILTER 查询行、NOTION_INSERT_ROW_DATABASE 新增、NOTION_UPDATE_ROW_DATABASE 更新。
  3. 区块与页面内容:NOTION_FETCH_BLOCK_CONTENTS 读取、NOTION_ADD_MULTIPLE_PAGE_CONTENT 追加、NOTION_APPEND_TEXT_BLOCKS 追加纯文本、NOTION_REPLACE_PAGE_CONTENT 替换、NOTION_DELETE_BLOCK 删除指定区块。
  4. 数据库 schema:NOTION_CREATE_DATABASE、NOTION_UPDATE_SCHEMA_DATABASE。
  5. 用户与评论:NOTION_LIST_USERS、NOTION_GET_ABOUT_ME、NOTION_CREATE_COMMENT、NOTION_FETCH_COMMENTS。

关键参数与模式:常见参数有 query、parent_id、page_id、database_id、block_id、properties、filter、sorts、start_cursor、content_blocks、rich_text。查询结果分页,page_size 最大 100,需根据 has_more/next_cursor 继续翻页。过滤语法支持单条件(如 {"property":"Status","select":{"equals":"Done"}})与复合条件(and/or)。

限制与注意事项:页面和数据库必须共享给 Notion 集成才能访问,标题搜索可能返回 0 条;404 object_not_found 通常意味着 database_id 错误或未共享;属性名区分大小写且必须与 schema 完全一致,schema 不匹配或缺必填属性会报 400 validation_error;公式、rollup、created_time 等只读字段不能写入;UPDATE_SCHEMA_DATABASE 不能更改属性类型,需新建属性并迁移数据;RETRIEVE_PAGE 只返回元数据与属性,正文需用 FETCH_BLOCK_CONTENTS;ARCHIVE_NOTION_PAGE 与 DELETE_BLOCK 均为软删除(archived=true),并非永久删除;追加区块应使用 content_blocks 参数而不是 child_blocks;ADD_MULTIPLE_PAGE_CONTENT 在已归档页面上会失败,需先用 UPDATE_PAGE 取消归档;评论绑定在页面而非单个区块,people 类型属性过滤需使用 LIST_USERS 返回的用户 ID;响应数据可能嵌套在 data_preview 或 data.results 中,需防御式解析。

适用场景:需要以编程或智能体方式批量创建/更新页面、查询与写入数据库行、维护页面内容区块、管理评论与查看用户信息时使用;任务范围不匹配、缺少必需输入、权限、安全边界或成功标准时,应停止并请求澄清。本技能输出不应替代针对具体环境的验证、测试或专家评审。