词元广场TOKPUB.COM - 欢迎您，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
"Notion — Notion API + ntn CLI：页面、数据库、Markdown、Workers"
Notion
Skill 元数据
| 来源 | 内置（默认安装） |
| 路径 | skills/productivity/notion |
| 版本 | 2.0.0 |
| 作者 | community |
| 许可证 | MIT |
| 平台 | linux, macos, windows |
| 标签 | Notion, Productivity, Notes, Database, API, CLI, Workers |
参考：完整 SKILL.md
信息
Notion
ntn CLI — Notion 官方 CLI。语法更简洁，支持单行文件上传，Workers 必须使用此方式。截至 2026 年 5 月仅支持 macOS + Linux（Windows 支持"即将推出"）。已安装时为默认方式。◆ HTTP + curl — 全平台可用，包括 Windows。
ntn 未安装时的默认回退方式。配置
1. 获取集成 token（两种方式均需要）
1.
2.
ntn_ 或 secret_ 开头）3.
~/.hermes/.env ：NOTION_API_KEY=ntn_your_key_here4.
... → Connect to → 你的集成名称。若未执行此步骤，即使页面存在，API 也会返回 404。2. 安装 ntn（macOS / Linux 上的首选方式）
ntn login——改用集成 token。 此方式支持无头运行，无需浏览器：~/.hermes/.env），使每个会话都能继承这些变量。3. 运行时选择路径
ntn 发布之前完全跳过第 2 步——Path B 可正常使用。如果现在就想要 CLI 体验，可在 WSL2 中安装 ntn。API 基础
Notion-Version: 2025-09-03。ntn 会自动处理此项。在此版本中，用户所称的"数据库"在 API 中称为 data sources（数据源）。Path A — ntn CLI（首选，macOS / Linux）
原始 API 调用（curl 的简写）
key=value — 字符串字段key[nested]=value — 嵌套对象字段key:=value — 类型赋值（布尔值、数字、null、数组）搜索
读取页面元数据
以 Markdown 格式读取页面（适合 agent 使用）
以块（block）形式读取页面内容
从 Markdown 创建页面
用 Markdown 更新页面
查询数据库（data source）
sorts、多个过滤条件或复合逻辑的复杂查询，通过管道传入 JSON：文件上传（单行命令——CLI 最大优势）
常用环境变量
| 变量 | 作用 |
|---|---|
NOTION_API_TOKEN | 认证 token（覆盖密钥链）——设置为你的集成 token |
NOTION_KEYRING=0 | 使用 ~/.config/notion/auth.json 存储凭据，而非系统密钥链 |
NOTION_WORKSPACE_ID | 跳过工作区选择提示 |
Path B — HTTP + curl（跨平台，Windows 默认方式）
curl 可直接使用。PowerShell 用户也可使用 Invoke-RestMethod。搜索
读取页面元数据
以 Markdown 格式读取页面（适合 agent 使用）
以块形式读取页面内容（需要结构化数据时使用）
从 Markdown 创建页面
POST /v1/pages 接受 markdown 请求体参数。用 Markdown 更新页面
在数据库中创建页面（带类型属性）
查询数据库（data source）
创建数据库
更新页面属性
向页面追加块
文件上传（三步流程）
属性类型
{"title": [{"text": {"content": "..."}}]}{"rich_text": [{"text": {"content": "..."}}]}{"select": {"name": "Option"}}{"multi_select": [{"name": "A"}, {"name": "B"}]}{"date": {"start": "2026-01-15", "end": "2026-01-16"}}{"checkbox": true}{"number": 42}{"url": "https://..."}{"email": "user@example.com"}{"relation": [{"id": "page_id"}]}API 版本 2025-09-03 — 数据库与 Data Sources
/data_sources/ 端点。database_id 和 data_source_id。database_id：parent: {"database_id": "..."}data_source_id：POST /v1/data_sources/{id}/query"object": "data_source"，包含 data_source_id 字段。Notion Workers（高级功能，需要 ntn）
ntn 仅支持 macOS/Linux。Windows 用户需使用 WSL2 或等待原生支持。最简 Worker
src/index.ts：Webhook 能力
ntn workers webhooks list 显示 Notion 生成的 URL。将该 URL 视为机密——除非添加签名验证，否则任何人都可以向其 POST 事件。Worker 生命周期命令
ntn workers new 创建脚手架，在 src/index.ts 中编写代码，通过 ntn workers env set 设置密钥，然后部署。Notion 文档 https://developers.notion.com/workers 涵盖完整 API 接口。Notion 风格 Markdown（用于 /markdown 端点）
<callout icon="🎯" color="blue_bg">
Ship the MVP by **Friday**.
</callout>
<details color="gray">
<summary>Toggle title</summary>
Children indented one tab
</details>
<columns>
<column>Left side</column>
<column>Right side</column>
</columns>
<table_of_contents color="gray"/><mention-user url="..."/>、<mention-page url="...">Title</mention-page>、<mention-date start="2026-05-15"/><span underline="true">text</span><span color="blue">text</span>，或块级别在第一行使用 {color="blue"}$x^2$，块级 $$ ... $$[^https://example.com]gray brown orange yellow green blue purple pink red，以及带 *_bg 后缀的背景色变体。> 行渲染为独立引用块——在单个 > 内使用 <br/> 实现多行引用。选择合适的路径
| 任务 | macOS / Linux | Windows |
|---|---|---|
| 读写页面、搜索、查询数据库 | ntn api ... | curl |
| 读取页面供 agent 摘要 | ntn api v1/pages/{id}/markdown | curl /markdown 端点 |
| 上传文件 | ntn files create < file | 三步 HTTP 流程 |
| 一次性 API 探索 | ntn api ... | curl |
| 构建由 Notion 托管的同步/webhook/agent 工具 | ntn workers ... | WSL2 + ntn workers ... |
注意事项
"is_inline": true 可将其嵌入页面。-s 以抑制进度条（使 agent 输出更整洁）。jq 管道处理：... | jq '.results[0].properties'。Notion MCP，在数据库操作上比上一版本的 token 效率提升约 91%）——如需在会话中进行流式 Notion 访问，可通过 Hermes 的 MCP 支持接入，但上述路径已足以应对大多数一次性任务。