Notion Skill

Notion Skill 是什么？

Notion Skill 通过 Notion API 创建、读取和更新页面、数据源与内容块。它适合搜索知识库、维护项目数据库、添加页面内容和自动更新属性。使用前需要创建 Notion integration，并把目标页面或数据库明确共享给该 integration。

主要能力

• 搜索页面和数据源。
• 读取页面信息及其子内容块。
• 在数据库中创建页面并设置属性。
• 筛选、排序和查询数据源。
• 更新页面属性并追加新的内容块。

授权与版本

用户需要保存 integration API Key，并在 Notion 中连接目标页面。每个请求还要携带 Notion API 版本。原始 Skill 使用一个明确的版本日期，并说明该版本将数据库接口称为 data sources；未来接口变化时应以当前官方文档为准。

数据库标识

目录说明数据库可能同时包含 database_id 和 data_source_id。创建页面时使用父级 database_id，查询数据源时使用 data_source_id。混用两者会造成请求失败，因此自动化前要先通过搜索或读取接口确认标识。

限制与安全

Notion API 不能设置数据库视图筛选器，且有请求速率限制。创建、更新和追加内容都会改变云端数据，操作前应确认目标页面和属性。API Key 不应保存在公开仓库或输出日志中。

许可证

ClawHub 当前版本没有声明许可证。Notion API、工作区数据和 Skill 文件有各自的使用条款。

常见问题 FAQ

1. 使用前需要什么？

需要 Notion integration、API Key，并把目标页面或数据库共享给它。

2. 能搜索工作区所有页面吗？

只能访问 integration 已获授权的内容。

3. 可以新建数据库记录吗？

可以在数据源中创建页面并填写属性。

4. database_id 和 data_source_id 有什么区别？

前者常用于创建页面的父级，后者用于查询数据源，具体以当前 API 版本为准。

5. 能添加页面正文吗？

可以通过追加内容块写入段落等内容。

6. 可以设置 Notion 视图筛选器吗？

目录说明 API 不能设置界面中的数据库视图筛选器。

7. 如何保护 API Key？

放入安全凭据存储或受控配置文件，不要提交到公开仓库。

8. 为什么请求可能失败？

常见原因包括未共享页面、ID 使用错误、版本头缺失、权限不足或触发限流。

来源与核验说明

本条目根据 ClawHub 上 steipete 发布的 Notion 1.0.0 内容整理，易变化的 API 版本信息需在使用时再次核对。