介绍
# notion-api (generic)
该技能提供了一个基于 Node 的小型 Notion API CLI。其设计旨在可共享：**仓库中没有硬编码的数据库 ID，也没有密钥**。
## Auth（授权）
通过以下任一方式提供 Notion 集成令牌（integration token）：
- `NOTION_KEY` 环境变量，或 - `~/.config/notion/api_key`（第一行）
同时，请确保目标页面/数据库已在 Notion 中与您的集成共享。
## Commands (CLI)（命令）
运行方式：
- `node scripts/notion-api.mjs <command> ...`
### Search（搜索）
```bash node scripts/notion-api.mjs search "query" --page-size 10 ```
### Query a data source (database query)（查询数据源/数据库查询）
```bash 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}' ```
### Create a page in a database（在数据库中创建页面）
```bash node scripts/notion-api.mjs create-page --database-id <DATABASE_ID> --title "My item" --title-prop Name ```
## Output（输出）
所有命令均将 JSON 打印到 stdout。
## Notes（备注）
- Notion API 版本标头默认为 `2025-09-03`（可通过 `NOTION_VERSION` 覆盖）。 - 适用速率限制；建议使用 `page_size` 并尽量减少调用次数。