该技能通过 Notion API 管理页面、数据源(数据库)和块,用于创建/读取/更新 Notion 内容。
配置:在 https://notion.so/my-integrations 创建集成,复制以 ntn_ 或 secret_ 开头的 API key,写入 ~/.config/notion/api_key;并将目标页面/数据库共享给该集成(点击“...”→“Connect to”→集成名称)。
请求基础:所有请求使用 Authorization: Bearer $NOTION_KEY、Notion-Version: 2025-09-03 和 Content-Type: application/json,Notion-Version 头为必需。
常见操作:搜索页面与数据源(POST /v1/search)、获取页面(GET /v1/pages/{page_id})、获取页面块(GET /v1/blocks/{page_id}/children)、在数据源中创建页面(POST /v1/pages)、查询数据源(POST /v1/data_sources/{data_source_id}/query,支持 filter 与 sorts)、创建数据源(POST /v1/data_sources)、更新页面属性(PATCH /v1/pages/{page_id})、向页面添加块(PATCH /v1/blocks/{page_id}/children)。属性格式包括 title、rich_text、select、multi_select、date、checkbox、number、url、email、relation。
版本差异:2025-09-03 中数据库在 API 内称为“data sources”,使用 /data_sources/ 端点查询与获取;数据库同时有 database_id 与 data_source_id,创建页面用 database_id,查询用 data_source_id;搜索结果里数据库以 object: "data_source" 返回,页面响应中 parent 同时带 data_source_id 与 database_id。
限制:页面/数据库 ID 为 UUID;API 不能设置数据库视图过滤器(仅界面可设);速率约 3 请求/秒;创建数据源时如需嵌入页面可使用 is_inline: true。其余信息暂未提供。