Notion API命令行工具

技能简介

基于Node.js的NotionAPI命令行工具，支持搜索、查询数据库和创建页面。采用环境变量或配置文件管理密钥，避免硬编码敏感信息。

能做什么

• 搜索Notion工作区中的页面和数据库
• 按条件查询数据库内容，支持自定义过滤和排序
• 在指定数据库中创建新页面
• 以JSON格式输出结果，便于脚本集成

使用说明

安装准备

1. 确保已安装Node.js运行环境
2. 克隆或下载技能代码到本地目录
3. 执行 npm install 安装依赖包

配置认证

选择以下任一方式提供Notion集成令牌：

• 设置环境变量：export NOTION_KEY="your_integration_token"
• 创建配置文件：~/.config/notion/api_key（第一行写入令牌）

同时在Notion网页端将目标页面/数据库共享给该集成。

常用命令

# 搜索内容
node scripts/notion-api.mjs search "关键词" --page-size 10

# 查询数据库
node scripts/notion-api.mjs query --data-source-id <数据库ID> --page-size 10

# 带过滤条件查询
node scripts/notion-api.mjs query --data-source-id <ID> --body '{"filter": {...}, "sorts": [...]}'

# 创建页面
node scripts/notion-api.mjs create-page --database-id <ID> --title "标题" --title-prop Name

输入与输出

见下方输入与输出表格。

风险提示

• 需妥善保管NOTION_KEY，避免泄露
• 受Notion API速率限制，建议控制page_size和调用频率
• 数据库ID等参数需从Notion界面获取，无法自动枚举
• API版本默认为2025-09-03，可通过NOTION_VERSION覆盖

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/timenotspace/notion-api/SKILL.md
来源类型：GitHub仓库