notion-api (通用)

该技能提供了一个基于Node的Notion API小型CLI工具。其设计旨在易于共享：代码库中不包含硬编码的数据库ID和任何密钥。

认证

通过以下任一方式提供Notion集成令牌：

• NOTION_KEY环境变量，或
• ~/.config/notion/api_key文件（首行）

同时请确保在Notion中将目标页面/数据库与您的集成共享。

命令（CLI）

通过以下方式运行：

• node scripts/notion-api.mjs <命令> ...

搜索

node scripts/notion-api.mjs search "query" --page-size 10

查询数据源（数据库查询）

node scripts/notion-api.mjs query --data-source-id <DATA_SOURCE_ID> --page-size 10
# optionally pass raw JSON body:
node scripts/notion-api.mjs query --data-source-id <ID> --body '{"filter": {...}, "sorts": [...], "page_size": 10}'

在数据库中创建页面

node scripts/notion-api.mjs create-page --database-id <DATABASE_ID> --title "My item" --title-prop Name

输出

所有命令均将JSON打印至标准输出。

备注

• Notion API版本头默认设置为2025-09-03（用 NOTION_VERSION 覆盖）。 适用速率限制；建议使用 page_size 并尽量减少调用次数。NOTION_VERSION).
• Rate limits apply; preferpage_sizeand minimal calls.