Notion 页面与数据库 API
用 Notion API(2025-09-03 版)创建和读写页面、数据源(原数据库)与内容块。
功能与用途
需要对 Notion 里的页面和数据库做程序化操作时用这个能力:它按 Notion REST API 的写法给出可直接执行的 curl 请求,覆盖搜索、读页面、读内容块、建页面、查询数据源、建数据源、改属性、追加内容块。它特别说明了 2025-09-03 版的变化——数据库在 API 里已改叫 data source,创建页面用 database_id、查询用 data_source_id,两个 ID 不能混用。使用前要自己建 integration 并把目标页面共享给这个 integration。
适用场景
- 自动化录入数据库条目:通过 API 向指定数据源创建新页面记录,并自动填充标题、状态、日期和关联等多种结构化属性。
- 按条件检索与查询数据源:全局搜索工作区页面与数据源,或结合过滤条件与排序规则精确查询数据库内的目标记录。
- 页面正文读取与内容块追加:获取指定页面的子 Block 内容,或向现有页面尾部动态追加段落等内容块以同步更新文档。
适用人群
- 需要把 Notion 接进内部系统或脚本的后端开发
- 做自动化流程、要按接口读写 Notion 数据的集成工程师
- 想用脚本批量维护 Notion 数据库内容的技术型运营
使用步骤
- 在 Notion 的 my-integrations 页面创建 integration,复制以 ntn_ 或 secret_ 开头的 API Key 并保存到本地文件。
- 把要操作的页面或数据库通过「...」→「连接」共享给这个 integration,否则接口会返回找不到资源。
- 所有请求带上 Authorization、Notion-Version: 2025-09-03 和 Content-Type 三个请求头。
- 先用 /v1/search 找到页面或数据源,按需要区分 database_id(建页面用)和 data_source_id(查询用)。
- 按属性类型规范(title、rich_text、select、multi_select、date、checkbox、number、url、email、relation)拼 body 执行创建或更新。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- 1.0.0
- 最近更新
- 2026-05-11
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Notion API for creating and managing pages, databases, and blocks.
使用前准备
- 需要 Notion integration 的 API Key(存于 ~/.config/notion/api_key)并把目标页面/数据库共享给该 integration,同时能发起 HTTPS 请求调用 api.notion.com。
依赖与权限
- NOTION_KEY
- 读取用户主动提供的内容