名称： better-notion
描述： 对 Notion 页面、数据库和块进行完整的增删改查操作。支持创建、读取、更新、删除、搜索和查询。
元数据： {"clawdbot":{"emoji":"📝"}}

Notion

使用 Notion API 管理页面、数据源（数据库）和块。

设置

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

在 Notion 界面中，将目标页面或数据库分享给你的集成应用。

API 基础

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

常用操作

# 搜索
curl -X POST "https://api.notion.com/v1/search" -d '{"query": "title"}'

# 获取页面
curl "https://api.notion.com/v1/pages/{page_id}"

# 获取页面块
curl "https://api.notion.com/v1/blocks/{page_id}/children"

# 在数据库中创建页面
curl -X POST "https://api.notion.com/v1/pages" -d '{
  "parent": {"data_source_id": "xxx"},
  "properties": {"Name": {"title": [{"text": {"content": "Item"}}]}}
}'

# 查询数据库
curl -X POST "https://api.notion.com/v1/data_sources/{id}/query" -d '{
  "filter": {"property": "Status", "select": {"equals": "Active"}}
}'

# 更新页面
curl -X PATCH "https://api.notion.com/v1/pages/{page_id}" -d '{
  "properties": {"Status": {"select": {"name": "Done"}}}
}'

# 添加块
curl -X PATCH "https://api.notion.com/v1/blocks/{page_id}/children" -d '{
  "children": [{"type": "paragraph", "paragraph": {"rich_text": [{"text": {"content": "Text"}}]}}]
}'

# 删除页面或块（移至回收站）
curl -X DELETE "https://api.notion.com/v1/blocks/{block_id}"

# 从回收站恢复（将 archived 设为 false）
curl -X PATCH "https://api.notion.com/v1/blocks/{block_id}" -d '{"archived": false}'

属性类型

2025-09-03 API 注意事项

• 数据库在 API 中称为“数据源”
• 创建页面和查询时均使用 data_source_id
• 从搜索结果中的 id 字段获取 data_source_id
• 速率限制：约每秒 3 个请求