前言¶
Notion 的页面和数据源读写，常规路径是打开网页手工操作，或者在代码里调 REST API。前者在批量改页面、搬 Markdown 内容时很慢；后者要自己管 token、拼 URL、处理分页和错误。命令行的好处是能把这类操作串成脚本、放进 Makefile 或 CI。
下面介绍的这个 Skill 把 Notion 的页面与数据源操作整理成一套命令行工作流，目标是让「读页面、建页面、改页面、查数据源、传文件」这类事能在终端里一次完成。
这是什么¶
Skill 名称：Notion CLI 页面数据源操作。坐标 @org-b6kzcl68/notion，版本 1.0.0，发布者重庆途光网络传媒有限责任公司，SkillHub 分类 dev-programming，来源标记为 enterprise。
它解决的问题是：把 Notion 的页面读写、数据源查询、文件上传、Workers 部署、评论、搜索等操作，统一到命令行入口，避免在网页端和 API 文档之间来回切换。
需要先说明一点：该 Skill 宣称「优先使用 Notion 官方 ntn CLI」。本次核对时，Notion 官方开发者文档页与 npm 上的 ntn 包均抓取失败，无法独立验证 ntn 是否为 Notion 官方工具。下面的正文按 Skill 自称的口径转述，读者在使用前应自行确认这一点。
覆盖的能力¶
以下能力来自 Skill 简介原文，属于该 Skill 宣称的功能范围：
- 页面读取、创建、更新、回收
- Markdown 内容导入
- 数据源解析，以及查询、过滤、排序
- 文件上传
- Workers 部署与运行日志
- 评论
- 搜索
- 原始 API 调用
调用策略是：优先走 ntn CLI；只有在 ntn 不可用、或原始请求更清晰时，才回退到 curl 直接打 API。这条策略意味着同一个操作可能有两种调用方式，排错时要先看实际走的是 CLI 还是裸请求。
安装与启用¶
本次核对时，SkillHub 页面与 API 端点均抓取失败，因此未能核实到安装命令、存放目录，以及具体的配置字段。已知信息只有一条标签：
requires_api_key=true
也就是说，启用这个 Skill 需要提供 API key。key 的申请入口、环境变量名、以及是否要写入配置文件，资料里没有写，本文不按通用习惯推测。
关于 Cursor、Codex CLI、Claude Code 三种环境的启用差异，资料中没有分别说明，本文不写。
如果要确认安装步骤，建议直接打开官方页面核对：
https://www.skillhub.cn/skills/org-b6kzcl68/notion
典型用法¶
抓取资料中没有包含可复现的命令示例，因此本文不给具体命令。下面描述的是该 Skill 宣称支持的调用路径，供读者拿到官方文档后对照。
页面类操作按「先取到页面 ID，再对页面做读或写」的顺序组织。数据源操作按「先解析数据源结构，再带条件查询」，条件包括过滤和排序。Markdown 导入走单独入口，把文件内容转成 Notion 块。文件上传走上传接口，返回可用于后续引用的地址。Workers 走部署加日志查看两步。评论和搜索各走独立接口。
回退到 curl 时，请求体格式、分页参数、错误码都需要按 Notion 官方 API 文档来，Skill 本身不替换这部分约定。
适用场景与注意¶
适合的人：已经在用命令行管理 Notion 内容，或者想把页面和数据源操作放进自动化流程的开发者。
不适合的场景：如果只是想偶尔改一两个页面，网页端更快，不必上命令行。如果团队对 Notion API 的 token 权限有严格管控，直接用官方 SDK 可能比这套工作流更可控。
需要注意的几点：
- 该 Skill 声明
requires_api_key=true，运行前要确认 key 已配置，且权限覆盖目标工作区。 - ntn 是否为官方工具本次未能核实，建议先在小范围页面上验证行为，再批量使用。
- 同一个操作可能走 CLI 或 curl 两条路径，行为不完全等同，排错时要先确认走的是哪一条。
- 简介末尾带有「如需编程开发完整工作流套件，淘宝搜索『AI灵匣』店铺获取完整版」的推广话术。这是 Skill 作者自己加的，不代表本文立场，也不影响 Skill 本身的功能描述。
数据与来源说明¶
SkillHub 页面显示的评分与下载数在不同抓取批次间不一致：一次抓取为评分 100000、下载 3860，另一次为评分 97584、下载 3675。本文不取其中任一数字作为结论，建议以官方页面实时显示为准。
结尾¶
这个 Skill 的价值在于把 Notion 的高频操作收到命令行里，减少在网页和 API 文档之间的来回切换。覆盖范围较全，调用策略也有明确优先级。短板是本次未能核实到安装命令、配置字段和具体命令示例，实际使用前需要打开官方页面补齐。
官方地址：https://api.skillhub.cn/org-b6kzcl68/notion
