AI Skill 大全

Notion 托管接入查询与写入

通过 Maton 网关的托管 OAuth 接入 Notion,用 CLI 查询数据源、搜索页面、读取工作区内容,写操作需逐次确认。

功能与用途

不想自己建 Notion integration 和管 API Key,可以用这个能力:所有请求都走 Maton 网关和 maton CLI,用托管 OAuth 登录后由系统凭据库保存并自动续期令牌。它可以列连接、创建连接、查数据源、搜页面、读工作区内容,也能通过 maton api 直通任意 Notion 原生接口。默认只做读和列,任何创建、更新、删除都必须先和你确认目标资源与连接,且不得由 AI 自行发起新的授权连接。

适用场景

  • 工作区页面与数据库检索:通过命令行跨 Notion 工作区快速检索文档标题、读取页面正文与数据源元数据。
  • 数据安全写入与受控更新:在脚本中调用原生接口写入或更新 Notion 块与属性,每次变更均需人工显式授权。
  • 多账号授权连接集中管理:借助 Maton 托管 OAuth 管理多个 Notion 组织授权,避免在本地暴露长期有效令牌。

适用人群

  • 不想自建 Notion 应用和管密钥的独立开发者
  • 要按最小权限安全接入多个 SaaS 的自动化负责人
  • 用 Notion 做客户资料库、需要程序化查询的销售运营

使用步骤

  1. 安装 maton CLI(npm 全局安装或 Homebrew),然后用 maton login --oauth 在浏览器完成一次 OAuth 授权。
  2. 用 maton whoami --json 确认已认证,且认证类型是 oauth 而不是长期 api_key。
  3. 经用户明确同意后执行 maton connection create notion 建立连接,并在返回的 URL 里完成 Notion 授权;有多个连接时用 --connection 指定。
  4. 先用只读命令验证:maton connection list notion --status ACTIVE、maton notion user list,或 maton api '/notion/v1/...' 直通原生接口。
  5. 任何写入(建改删页面、块、数据源)都先确认目标 ID 与可逆性,再执行;批量操作需逐批确认。

开始使用

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

查看 MCP 接入说明

技术信息

分类
AI工作流
适用工具
Codex、Claude Code、OpenClaw、Hermes、国内 Agent
使用难度
进阶
版本
1.2.0
最近更新
2026-09-04
文件数
3
安装包大小
自动生成 ZIP
安全检查
基础检查通过

Notion API integration with managed OAuth. Query databases, search pages, and read workspace content. Write operations require explicit user confirmation of the target resource and connection. Use this skill when users want to interact with Notion workspaces, databases, or pages. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login; default to read and list calls, and confirm every write or new connection with the user.

使用前准备

  • 需要网络访问与一个 Maton 账号,安装 maton CLI 并完成 OAuth 登录
  • 不需要自己申请 Notion API Key。

依赖与权限

  • MATON_API_KEY
  • 读取用户主动提供的内容

同类 Skill