SuperAPI AI 工具集

notion-api-automation

编程与开发

查看项目

更新于 10-16 06:15

技能介绍

用途:通过 Notion 官方 REST API 和 SDK 自动化 Notion 工作区操作,提供可复用的请求模式与多步工作流,避免版本、数据模型、分页、限流等常见生产问题。

主要能力:鉴权集成;搜索页面/数据库;查询数据源行;读取页面属性与块内容;创建和更新页面属性;追加/更新/删除块;移动页面(重新指定父级);列出并使用模板;分页遍历;限流退避重试;写入后校验。

必要用法:设置环境变量 NOTION_TOKEN(或 NOTION_API_KEY / NOTION_API_TOKEN),NOTION_VERSION 默认 2025-09-03,可选 NOTION_BASE_URL 默认 https://api.notion.com。请求需带 Authorization: Bearer <token>、Notion-Version、JSON 体带 Content-Type: application/json。冒烟测试:curl https://api.notion.com/v1/users/me -H "Authorization: Bearer $NOTION_TOKEN" -H "Notion-Version: ${NOTION_VERSION:-2025-09-03}";或 python scripts/notion_request.py GET /v1/users/me。Node 可 npm i @notionhq/client 后创建 Client。获取 ID 可用 python scripts/notion_extract_id.py "<notion url or id>"。

核心模型:数据库是容器,行通过 data_source_id 查询与移动;GET 页面只返回属性,正文需读 blocks children;清空字符串用 null 而非空串;列表/查询/搜索必须处理 has_more 与 next_cursor;遇 429 遵循 Retry-After,优先顺序写入。

适用场景:按标题查找页面、批量读取或更新属性、追加块内容、跨父级移动页面、按模板创建页面等。

限制:需显式指定版本;集成须被授权访问资源,否则 403/404;删除块、批量归档、批量移动属危险操作,未明确要求不要执行;写入后应重新读取校验。官方资料未提供具体价格与配额数值。