name	notion
description	通过官方 Notion API 操作 Notion 页面和数据库。
homepage	https://developers.notion.com
metadata	{"clawdbot":{"emoji":"🧠","requires":{"env":["NOTION_API_KEY"]},"install":[{"id":"node","kind":"note","label":"需要 notion-cli (Node.js) 或 notion-cli-py (Python)。详见下方文档。"}]}}

Notion

此技能让智能体能够使用官方 Notion API 操作 Notion 页面和数据库。

这是一个声明式技能：它记录了安全、推荐的操作，并假设有一个本地 CLI（notion-cli）实际执行 API 调用。

export NOTION_API_KEY=secret_xxx

将集成与您想访问的页面或数据库共享。未共享的内容对 API 不可见。

您可以通过环境变量或配置定义多个配置文件（例如：personal、work）。

默认配置文件：personal

通过以下方式覆盖：

export NOTION_PROFILE=work

读取页面：

notion-cli page get <page_id>

追加内容块：

notion-cli block append <page_id> --markdown "..."

优先使用追加而非重写内容。

创建页面：

notion-cli page create --parent <page_id> --title "..."

检查架构：

notion-cli db get <database_id>

查询数据库：

notion-cli db query <database_id> --filter <json> --sort <json>

创建行：

notion-cli page create --database <database_id> --props <json>

更新行：

notion-cli page update <page_id> --props <json>

在应用架构变更前，始终先检查差异。

未经明确确认，切勿修改数据库架构。

推荐流程：

notion-cli db schema diff <database_id> --desired <json>
notion-cli db schema apply <database_id> --desired <json>

notion