用途:这是一个基于 Node 的通用 Notion API 命令行工具(CLI),用于搜索、查询数据源(数据库)以及在数据库中创建页面。设计上便于共享,不硬编码数据库 ID,也不在仓库中存放密钥。
认证:通过 NOTION_KEY 环境变量,或 ~/.config/notion/api_key 文件(取第一行)提供 Notion 集成令牌。同时需在 Notion 中将目标页面或数据库共享给该集成。
主要能力与用法:通过 node scripts/notion-api.mjs <command> ... 运行。搜索: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,也可传入原始 JSON 请求体,如 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 并尽量减少调用次数。其余细节暂未提供。