名称： notion-api
描述： 通用的 Notion API 命令行工具（基于 Node.js），支持搜索、查询数据源（数据库）和创建页面。通过 NOTION_KEY 环境变量或 ~/.config/notion/api_key 文件进行配置。

notion-api（通用版）

此技能提供了一个基于 Node.js 的小型 Notion API 命令行工具。它被设计为可共享的：代码库中不包含硬编码的数据库 ID 和任何密钥。

认证

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

• NOTION_KEY 环境变量，或
• ~/.config/notion/api_key 文件（读取第一行）

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

命令（CLI）

运行方式：

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

搜索

node scripts/notion-api.mjs search "查询内容" --page-size 10

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

node scripts/notion-api.mjs query --data-source-id <数据源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 <数据库ID> --title "我的条目" --title-prop Name

输出

所有命令均将 JSON 打印到标准输出（stdout）。

注意事项

• Notion API 版本头默认使用 2025-09-03（可通过 NOTION_VERSION 覆盖）。
• 存在速率限制；建议合理设置 page_size 并尽量减少调用次数。