用途
Notion 工具用于通过 Notion 官方 REST API 管理 Notion 中的页面、数据库与块。它面向希望通过命令行或脚本以编程方式读写 Notion 内容的用户，例如同步资料、批量维护数据库条目、提取页面结构等。
主要能力
工具给出的操作示例覆盖以下能力：
- 搜索：调用
POST https://api.notion.com/v1/search，可传入query与page_size，返回页面或数据库结果，并提取 id、对象类型与标题。 - 获取页面：调用
GET https://api.notion.com/v1/pages/PAGE_ID，输出 id、url、created_time、properties。 - 创建页面：调用
POST https://api.notion.com/v1/pages，以database_id为父级并设置标题属性，返回 id 与 url。 - 更新页面：调用
PATCH https://api.notion.com/v1/pages/PAGE_ID，可更新属性，例如把 Status 设为 Done。 - 查询数据库：调用
POST https://api.notion.com/v1/databases/DATABASE_ID/query，支持 filter 与 page_size，例如筛选 Status 等于 In Progress 的条目。 - 列出数据库：调用
POST https://api.notion.com/v1/search并传入filter为 object 等于 database，返回数据库 id 与标题。 - 创建数据库条目：通过
POST https://api.notion.com/v1/pages以 database_id 为父级创建条目，可同时设置多个属性。 - 获取块子项：调用
GET https://api.notion.com/v1/blocks/BLOCK_ID/children，支持 page_size，并可提取段落文本。
使用方式
使用前需配置环境变量 NOTION_API_KEY，该集成令牌可在 https://www.notion.so/my-integrations 生成。所有请求需携带请求头：
Authorization: Bearer $NOTION_API_KEYNotion-Version: 2022-06-28- 发送 JSON 时还需
Content-Type: application/json
示例均以 curl 发起请求，并通过 jq 精简输出结果，便于在 shell 脚本或自动化流程中集成。
适用场景
- 以脚本批量创建或更新 Notion 数据库条目。
- 按条件查询数据库内容并抽取字段。
- 读取页面属性与块结构，用于同步或备份。
- 在自动化流程中搜索页面与数据库。
限制
资料中未提供关于收费、价格、调用频率限制、权限范围、平台兼容性以及具体错误处理的信息，这些内容暂未提供。使用时应以 Notion 官方 API 的实际行为为准。