Notion数据管理

技能简介

better-notion 提供对 Notion 页面、数据库和区块的完整增删改查能力，支持搜索、查询、更新及删除恢复等操作。

能做什么

• 创建、读取、更新、删除 Notion 页面与数据库条目
• 搜索工作区内的页面和数据源
• 按条件过滤查询数据库内容
• 添加或修改页面区块（段落、列表等）
• 将页面移入回收站或从中恢复

使用说明

1. 安装配置

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

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

2. 获取 API 密钥

NOTION_KEY=$(cat ~/.config/notion/api_key)

3. 常用操作示例

搜索内容：

curl -X POST "https://api.notion.com/v1/search" -d '{"query": "标题关键词"}'

查询数据库：

curl -X POST "https://api.notion.com/v1/data_sources/{id}/query" -d '{"filter": {"property": "状态", "select": {"equals": "进行中"}}}'

创建页面：

curl -X POST "https://api.notion.com/v1/pages" -d '{
  "parent": {"data_source_id": "数据库ID"},
  "properties": {"名称": {"title": [{"text": {"content": "新条目"}}]}}
}'

更新页面属性：

curl -X PATCH "https://api.notion.com/v1/pages/{page_id}" -d '{
  "properties": {"状态": {"select": {"name": "已完成"}}}
}'

添加区块内容：

curl -X PATCH "https://api.notion.com/v1/blocks/{page_id}/children" -d '{
  "children": [{"type": "paragraph", "paragraph": {"rich_text": [{"text": {"content": "补充说明"}}]}}]
}'

删除与恢复：

# 移入回收站
curl -X DELETE "https://api.notion.com/v1/blocks/{block_id}"
# 从回收站恢复
curl -X PATCH "https://api.notion.com/v1/blocks/{block_id}" -d '{"archived": false}'

4. 注意事项

API 中数据库称为 “data source”，创建页面和查询时均使用 data_source_id；速率限制约为每秒 3 次请求。

输入与输出

见下方输入与输出表格。

项目	内容
输入	Notion API 密钥、页面/数据库 ID、查询条件、属性值、区块内容
输出	页面详情、数据库条目列表、搜索结果、操作状态、区块数据
适用人群	技术团队、开发人员、运营人员、需要自动化 Notion 数据的用户
不包含	成员管理、文件上传、样式自定义、实时协作、Webhook 订阅

 

风险提示

• 删除操作会将内容移至回收站，非永久删除，但恢复前不可见
• API 密钥需妥善保管，避免泄露导致数据被篡改
• 高频调用可能触发速率限制，建议控制请求频率
• 共享权限设置错误会导致操作失败，需确认集成已获授权

来源信息

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