AI Skill 大全

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 数据库内容的技术型运营

使用步骤

  1. 在 Notion 的 my-integrations 页面创建 integration,复制以 ntn_ 或 secret_ 开头的 API Key 并保存到本地文件。
  2. 把要操作的页面或数据库通过「...」→「连接」共享给这个 integration,否则接口会返回找不到资源。
  3. 所有请求带上 Authorization、Notion-Version: 2025-09-03 和 Content-Type 三个请求头。
  4. 先用 /v1/search 找到页面或数据源,按需要区分 database_id(建页面用)和 data_source_id(查询用)。
  5. 按属性类型规范(title、rich_text、select、multi_select、date、checkbox、number、url、email、relation)拼 body 执行创建或更新。

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
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
  • 读取用户主动提供的内容

同类 Skill