SuperAPI AI 工具集

notion-cli

编程与开发

查看项目

更新于 10-16 07:57

技能介绍

用途:通过 Notion 官方 CLI(ntn)与 Notion API 交互,管理 workers 并上传文件。适合需要调用 Notion API、部署 workers 或在终端读写 Notion 内容的场景。

主要能力与用法:CLI 自带文档,应优先运行命令而非猜测语法。ntn api ls 列出所有公开 API 端点;ntn api <path> --help 显示方法、文档链接和用法;--docs 打印完整官方文档;--spec 输出精简 OpenAPI 片段以了解请求/响应结构;ntn pages get <page-id> 以 Markdown 读取页面内容;ntn <command> --help 查看任意命令帮助。

安装:curl -fsSL https://ntn.dev | bash

认证:设置 NOTION_API_TOKEN 后 CLI 自动使用;已设置时应优先使用而非提示运行 ntn login。ntn login / ntn logout 用于登录或登出,login 需在浏览器访问 URL,仅在未使用 NOTION_API_TOKEN 时使用。

调用 API:方法默认 GET,存在请求体时为 POST,可用 -X 覆盖。支持查询参数、内联请求体字段和 JSON 请求体,例如 ntn api v1/users page_size==100、ntn api v1/pages parent[page_id]=abc123、ntn api v1/pages -d '{"parent":{"page_id":"abc123"}}'。

页面与评论 Markdown:创建或更新页面内容优先用 ntn pages create / ntn pages update;通过 ntn api 创建或更新评论时使用 markdown 字段,支持粗体、斜体、代码、链接等内联格式;仅在 Markdown 无法表达(如提及、自定义表情或颜色)时才回退到 rich_text。

文件:ntn files 是 File Uploads API 的便捷封装,支持 ntn files create < image.png、ntn files create --external-url、ntn files list、ntn files get <upload-id>。

Workers:管理 Notion workers,可部署、列出和执行。ntn workers new my-worker 新建项目,ntn workers deploy 从当前目录部署,ntn workers ls 列出,ntn workers exec <capability> 执行能力,更多子命令见 ntn workers --help。

限制:资料未提供收费、价格、平台支持范围及配额等细节。