用途：通过 Notion API 管理页面、数据源（即数据库）与块内容，适合把 Notion 接入自动化流程或脚本。
设置：在 https://notion.so/my-integrations 创建集成，复制以 ntn_ 或 secret_ 开头的 API key，存放为本地文件：mkdir -p ~/.config/notion 后 echo "ntn_your_key_here" > ~/.config/notion/api_key。还需在目标页面/数据库上点击“...”→“Connect to”→选择集成名称进行授权。
请求要求：所有请求需带 Authorization: Bearer $NOTION_KEY、Notion-Version: 2025-09-03 和 Content-Type: application/json，其中版本头必填。该版本中数据库在 API 里称为 data sources。
主要能力：搜索页面与数据源（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 关键差异：数据库改称 data sources，查询走 /data_sources/ 端点；每个数据库同时有 database_id 和 data_source_id，建页用 database_id，查询用 data_source_id；搜索结果中数据库以 object: data_source 返回。查找 data_source_id 可搜索数据库或调用 GET /v1/data_sources/{data_source_id}。
限制：API 无法设置数据库视图过滤器（仅限界面操作）；速率限制约每秒 3 次请求；创建数据源时可使用 is_inline: true 将其嵌入页面。页面/数据库 ID 为 UUID，可带或不带连字符。其余细节资料暂未提供。