SkillsScout
INTEGRATION-WORKFLOW ／ 集成与工作流自动化

notion-cli-makenotion-skills

收录日期 2026-07-22·来源仓库 ↗
受欢迎程度
9
可用程度与相关性
8
安全性
8
8.3SCOUT SCORE

1. 基本信息

项目 内容 数据来源
名称 notion-cli-makenotion-skills 见下方命名说明
项目自述名称 仓库标题为「Notion Skills」，技能本身命名为 notion-cli README
作者/维护者 Notion Labs, Inc.（GitHub 官方组织 makenotion） GitHub API + LICENSE 署名
来源链接 https://github.com/makenotion/skills/tree/main/skills/notion-cli —
许可证 MIT（LICENSE.md，Copyright (c) 2026 Notion Labs, Inc.） 仓库文件实测
GitHub Stars / Forks 141 / 6 GitHub API
最新版本 底层 ntn CLI 在 npm 上为 0.19.2；本技能文件本身无独立版本号 npm registry + GitHub API
安装方式 见第十章 仓库 README

仓库根目录名为通用词「skills」，仓库内目前只有 notion-cli 这一个技能。

2. 功能介绍与亮点

notion-cli 教会编程 Agent 使用 Notion 官方命令行工具 ntn，把 Notion 的公开 API 直接暴露给终端/Agent 会话：

亮点：Notion 官方亲自编写与维护；认证优先读取 NOTION_API_TOKEN 环境变量，其次才提示浏览器 OAuth 登录；CLI 自带 --help 自解释，Agent 可现查现用而不必死记语法。

3. 适用场景

固定分类：集成与工作流自动化。

适合日常用编程 Agent 处理事务、又把 Notion 当知识库或任务系统的初中级开发者：让 Agent 直接读取/创建 Notion 页面与数据库记录、把文件上传进 Notion、或调用 Notion 公开 API 完成特定自动化任务。相比图形化的高层工作流插件，它更贴近“我要精确调用某个 Notion API 端点”或“我要给 Notion 部署一段自定义同步代码”的开发者场景。

4. 跨 Agent 兼容性

Agent 结论 依据
Claude Code 原生支持 SKILL.md 遵循标准 Agent Skills 格式；官方安装方式 npx skills add 依赖的 skills CLI（vercel-labs/skills）明确将 Claude Code 列为受支持目标之一
Codex 支持 同一 skills CLI 明确列出 Codex 为受支持目标；一条提交记录本身也带有 [codex] 标记，显示作者在为 Codex 场景验证过该技能
OpenClaw 支持 同一 skills CLI 的受支持列表中明确包含 OpenClaw
Hermes Agent 需说明——非直接安装本仓库，但有等价能力 skills CLI 的受支持列表中列出了 Hermes Agent；同时 Hermes Agent 官方文档显示其默认捆绑一个基于同一款官方 ntn CLI 构建的 Notion 技能，但那是 Hermes 自带的独立实现，并非直接安装 makenotion/skills 这个仓库

5. 推荐理由

Notion 官方亲自出品的命令行技能，把完整的 Notion 公开 API（含页面、文件、自定义 Workers 代码部署）直接交给 Agent 使用，且经第三方安装器验证可跨 Claude Code/Codex/OpenClaw 使用。

6. 评分

维度 分数 说明
受欢迎程度 9 Notion 是知识管理/协作赛道的一线 SaaS 厂商，本技能为其官方账号亲自出品；独立佐证包括：底层 ntn CLI 在 npm 上近 30 天下载量 3.3 万次，被第三方技能目录 mcpservers.org 收录，且 Hermes Agent 官方文档确认其内置了基于同一 ntn CLI 的默认能力
可用性 8 一条 curl 命令或 npx skills add 即可安装；CLI 自带 --help 自文档化，认证优先读取环境变量、其次走浏览器 OAuth，无需手动申请繁琐凭据；仓库内该技能对应目录最近一次改动约 2 个半月前，维护尚属活跃但非高频
安全性 8 见下方安全检查清单
综合 8.3 ≥ 7.0 达标，安全性未触发一票否决

安全检查清单： ① Shell 执行——安装脚本为官方 curl \| bash，日常使用是本地调用 ntn 二进制发起 API 请求，范围明确；workers deploy 会把用户提供的代码部署到 Notion 官方托管运行时，属于按用户指令执行的预期功能，非隐蔽提权 ② 联网外发——目标是 Notion 官方 API 域名，与技能声明用途完全一致，未见其他外联 ③ API Key/凭据——需要 NOTION_API_TOKEN 或走 ntn login 的浏览器 OAuth 流程，存储与读取优先级在 SKILL.md 中写明 ④ 可疑指令——通读 SKILL.md 全文，均为常规命令说明，未发现诱导执行额外操作或外发数据的文字 ⑤ 作者信誉——makenotion 为 Notion 官方账号（2013 年创建，54 个公开仓库），非匿名或临时账号 ⑥ License——MIT，条款清晰 ⑦ 维护时间——仓库最近提交约 5 周前，该技能对应目录最近改动约 2 个半月前，无弃置迹象

7. 跟同类 Skills 相比的优势

方案 核心定位 认证方式 与本技能的差异
notion-cli（本次推荐） Notion 官方 CLI 全量 API 直通 + 自定义 Workers 代码部署 API Token 或 OAuth 登录 覆盖面最全（任意 API 端点 + 文件 + 自定义代码部署），面向“精确调用/自定义集成”的开发者场景，且跨 Claude Code/Codex/OpenClaw 验证可用
claude-code-notion-plugin（Notion 官方，Claude Code 插件） 打包好的 4 个高层技能（知识沉淀、会议纪要、调研文档、规格转任务）+ MCP + 斜杠命令 OAuth，免 API Key 面向“开箱即用的工作流”而非底层 API，深度绑定 Claude Code 插件市场机制，未提供 Codex/OpenClaw 官方方案
notion-openai-plugins（OpenAI 官方，走 Notion 远程 MCP） 4 个高层技能（需求转任务、研究简报、会议材料、知识沉淀） 走 Notion 官方远程 MCP 服务器 同样是高层工作流封装而非原始 API 访问，原生面向 Codex，Claude Code 需自行接入同一 MCP 服务器

notion-cli 与上述两者互补而非直接替代：后两者提供“开箱即用”的高层工作流技能，notion-cli 提供的是可组合的底层 API 能力，适合需要自定义集成或调用未被高层技能覆盖的 Notion 功能的场景。

8. 用户评价

该技能目前在第三方平台尚无经核实的具名用户评价。底层 ntn CLI 被第三方技能目录 mcpservers.org 收录展示，近 30 天 npm 下载量约 3.3 万次，可作为社区实际使用规模的旁证。

9. 其他补充

Notion 官方账号名下还维护 claude-code-notion-plugin 等其他独立的 Notion 集成仓库；ntn CLI 本身作为 Notion 官方开发者平台的一部分独立发布于 npm（包名 ntn）。

10. 安装使用方式

  1. 安装 ntn CLI：curl -fsSL https://ntn.dev | bash
  2. 安装技能定义：npx skills add makenotion/skills --skill notion-cli（skills CLI 会自动识别本机已安装的 Agent 并写入对应目录）
  3. 首次使用前设置 NOTION_API_TOKEN 环境变量，或运行 ntn login 走浏览器 OAuth 登录
  4. 安装后无需重启，后续对话中提及“调用 Notion API”“创建/查询 Notion 页面”“上传文件到 Notion”“部署 Notion Worker”等意图会触发该技能

11. 注意事项