Notion数据管理

技能简介

该技能通过Notion官方API实现对工作空间内页面、数据源（数据库）及内容块的创建、读取和更新操作，支持将外部数据写入Notion或从中提取结构化信息。

业务背景

团队常将项目资料、任务看板存放在Notion中，但跨系统数据同步依赖人工复制粘贴。通过API直连工作空间，业务人员可将外部系统的客户信息、订单状态自动写入Notion数据库，或将结构化知识提取至分析工具，打通数据孤岛。

落地案例：市场部门每周需汇总多渠道线索到Notion客户库。运营人员配置自动化流程后，新线索从表单系统经API直接写入Notion数据源，并按跟进阶段自动分类；管理层则通过查询接口提取本周新增数据生成报表，避免重复录入与版本混乱。

能做什么

• 搜索并获取页面与数据源列表
• 创建新页面或向现有数据源添加条目
• 查询数据源内容并应用过滤与排序
• 更新页面属性与批量修改内容块
• 新建数据源并定义字段结构

使用说明

第一步：创建集成并获取密钥

1. 访问 https://notion.so/my-integrations 创建新集成
2. 复制生成的API密钥（以ntn_或secret_开头）

第二步：本地配置存储

mkdir -p ~/.config/notion
echo "ntn_your_key_here" > ~/.config/notion/api_key

第三步：授权访问目标资源

在Notion中打开需操作的页面或数据库，点击右上角「⋯」→「Connect to」→ 选择已创建的集成名称。

第四步：发起API请求

NOTION_KEY=$(cat ~/.config/notion/api_key)
curl -X GET "https://api.notion.com/v1/..." \
  -H "Authorization: Bearer $NOTION_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json"

注意：Notion-Version: 2025-09-03为必需头信息，此版本中将数据库称为”data source”，查询时需使用data_source_id而非database_id。

输入与输出

见下方输入与输出表格。

风险提示

• API密钥存储于本地明文文件，多人共用设备存在泄露风险
• 平均速率限制约每秒3次请求，高频调用可能触发限流
• 数据库视图过滤器仅存在于UI层，API无法读取或设置
• 2025-09-03版本存在双ID机制，混淆database_id与data_source_id会导致操作失败

来源信息

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