用途：notion-cli 是 Notion 的命令行工具，用于创建和管理页面、数据库（数据源）与区块，支持搜索、读取、更新页面内容及查询数据库。
安装与配置：通过 npm 全局安装，命令为 npm install -g @iansinnott/notion-cli。需在 https://notion.so/my-integrations 创建集成，复制以 ntn_ 或 secret_ 开头的 API 密钥，存入 ~/.config/notion/api_key，并将目标页面/数据库共享给该集成（点击“...”→“Connect to”→集成名）。
使用方式：所有命令需设置 NOTION_TOKEN 环境变量，可执行 export NOTION_TOKEN=$(cat ~/.config/notion/api_key)。常用操作包括：搜索页面与数据源 notion-cli search --query "页面标题"；获取页面 notion-cli page retrieve <PAGE_ID>；获取页面内容（区块）notion-cli page retrieve <PAGE_ID> -r；查询数据库 notion-cli db query <DB_ID> -a '{"property":"Status","status":{"equals":"Active"}}'；获取数据库信息 notion-cli db retrieve <DB_ID>。创建与更新页面属性可直接调用 Notion API（curl），需携带 Authorization、Content-Type 与 Notion-Version: 2025-09-03 请求头。
主要能力：支持多种属性类型（title、rich_text、status、select、multi_select、date、checkbox、number、url、email），支持交互模式（不带参数运行 db query）、多种输出格式（默认 table，另有 csv、json、yaml）、--raw 获取完整 API 响应，以及用 -a 传入 AND/OR 复杂过滤条件。
限制与注意：页面/数据库 ID 为 UUID（可带或不带连字符）；CLI 通过 NOTION_TOKEN 自动处理认证并管理速率限制；完整命令参考可运行 notion-cli help；官方文档见 https://developers.notion.com。