用途：通过 Notion API 以命令行方式创建、读取和更新页面、数据源（数据库）及内容块，适合脚本化或自动化操作 Notion 工作区。
配置：先在 https://notion.so/my-integrations 创建集成并复制 API key（以 ntn_ 或 secret_ 开头），保存到本地： 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，其中 Notion-Version 为必需头。该版本中数据库在 API 中被称为 data sources。
主要能力：可搜索页面与数据源、获取页面、获取页面内容块、在数据源中创建页面、查询数据源、创建数据源、更新页面属性和向页面追加块。
关键版本差异：查询和获取数据库使用 /data_sources/ 端点；每个数据库同时有 database_id 和 data_source_id，创建页面时用 database_id 作为 parent，查询时用 data_source_id；搜索结果中数据库返回为 object: data_source。
属性格式：支持 title、rich_text、select、multi_select、date、checkbox、number、url、email、relation 等常见类型。
限制：页面和数据库 ID 为 UUID；API 无法设置数据库视图筛选（仅界面可操作）；速率约每秒 3 次请求，超限返回 429 与 Retry-After；单次追加块的 children 最多 100 个、最多两级嵌套；负载上限为 1000 个块元素和 500KB；创建数据源时可用 is_inline: true 将其嵌入页面。