用途：notion-cli（命令为 ntn）用于与 Notion API 交互、管理 Notion workers 以及上传文件，适合在需要调用 Notion API、部署 worker 或读写页面内容的场景中使用，尤其便于智能体在执行任务时直接操作 Notion。
主要能力与用法：该 CLI 具有自文档化特性，建议先查询而非凭记忆编写语法。使用 ntn api ls 可列出所有公开 API 端点；ntn api <path> --help 显示某端点的方法、文档链接与用法；ntn api <path> --docs 打印完整官方文档；ntn api <path> --spec 输出精简的 OpenAPI 片段以了解请求与响应结构；ntn <command> --help 可获取任意命令或子命令帮助。调用 API 时可带查询参数（如 ntn api v1/users page_size==100）、内联正文（如 ntn api v1/pages parent[page_id]=abc123）或 JSON 正文（如 ntn api v1/pages -d '{"parent":{"page_id":"abc123"}}'），方法默认 GET，有正文时推断为 POST，可用 -X METHOD 覆盖。页面与评论支持 Markdown：优先使用 ntn pages create / ntn pages update 处理页面内容；评论可通过 ntn api 的 markdown 字段创建或更新（如 ntn api v1/comments -d '{"parent":{"page_id":"abc123"},"markdown":"..."}'）；页面正文可用 ntn pages create --parent page:abc123 --content '...'。markdown 字段支持粗体、斜体、代码、链接等内联格式，仅在需要提及、自定义 emoji 或颜色等 Markdown 无法表达的特性时才回退到 rich_text。ntn pages get <page-id> 可将页面以 Markdown 形式读取。文件方面，ntn files 是 File Uploads API 的便捷封装，支持 ntn files create < image.png、ntn files create --external-url https://example.com/photo.png、ntn files list、ntn files get <upload-id>。Workers 方面支持 ntn workers new my-worker 脚手架项目、ntn workers deploy 从当前目录部署、ntn workers ls 列出、ntn workers exec <capability> 执行能力，更多子命令可通过 ntn workers --help 查看。
认证方式：安装命令为 curl -fsSL https://ntn.dev | bash。认证时 CLI 会自动使用已设置的 NOTION_API_TOKEN，应优先检查该变量是否已存在，若已设置则优先使用而非让用户运行 ntn login；ntn login / ntn logout 用于登录或登出，仅在未使用 NOTION_API_TOKEN 时使用，且 ntn login 需要用户在浏览器中访问 URL 完成。
限制：资料未提供收费、价格、平台支持范围、速率限制与权限细节，暂未提供相关信息。