← 返回 Skills 市场
9950
总下载
8
收藏
20
当前安装
11
版本数
在 OpenClaw 中安装
/install notion-api-skill
功能描述
Notion API integration with managed OAuth. Query databases, search pages, and read workspace content. Write operations require explicit user confirmation of...
安全使用建议
Install only if you trust Maton to broker Notion access. Use the least-privileged Notion connection available, specify the intended connection when you have multiple workspaces, and approve writes or deletes only after checking the exact page, database, or block ID.
功能分析
Type: OpenClaw Skill
Name: notion-api-skill
Version: 1.0.10
The skill provides a managed OAuth integration for the Notion API through a third-party proxy service (api.maton.ai). The documentation in SKILL.md is comprehensive and includes explicit safety instructions for the AI agent, such as requiring user confirmation for all write operations and verifying connection IDs. No evidence of malicious intent, data exfiltration, or unauthorized execution was found; the code and instructions are consistent with the stated purpose of providing a simplified interface for Notion workspace management.
能力评估
Purpose & Capability
The skill's Notion read, search, database, page, block, and user capabilities match its stated purpose; write and delete operations are high-impact but disclosed and framed as requiring explicit user approval.
Instruction Scope
Instructions include a broad native Notion API proxy path, but they also require confirmation of the exact target resource and connection before create, update, delete, bulk, or destructive actions.
Install Mechanism
The artifact is instruction-only with a single SKILL.md and no executable scripts; it documents optional external installation of the Maton CLI through npm or Homebrew.
Credentials
Network access, a MATON_API_KEY, and delegated Notion OAuth are proportionate for this integration, but users are trusting Maton as a proxy for Notion requests and responses.
Persistence & Privilege
OAuth connections persist through Maton and can grant continuing access to selected Notion content, but the skill documents listing and deleting connections and shows no hidden background persistence.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install notion-api-skill - 安装完成后，直接呼叫该 Skill 的名称或使用
/notion-api-skill触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.10
- Clarified that all write operations (create, update, delete) require explicit user confirmation of the target resource and connection before execution.
- Updated the description and introductory text to emphasize stricter confirmation requirements for write actions.
- Adjusted documentation and usage notes to specify no writing is permitted without prior user approval.
- Reinforced security best practices and scope boundaries regarding resource operations and connection selection.
v1.0.9
Version 1.0.9
- Expanded Security & Permissions section with detailed user safety steps for write operations.
- Added requirements for confirming targets (IDs), verifying connections, and stating if an action is reversible or destructive before any write.
- Listed specific irreversible/high-risk operations that require extra caution.
- Clarified strict scope boundaries and the need for explicit user approval before bulk or batch changes.
- No changes to the skill's functionality or API surface.
v1.0.8
Version 1.0.8
- Added comprehensive CLI usage examples for interacting with Notion via the Maton CLI.
- Expanded installation and authentication instructions, including Homebrew and npm options.
- Provided side-by-side CLI and Python code samples for all major workflows (connections, search, data sources, pages).
- Clarified how to specify and manage multiple Notion connections in both CLI and API workflows.
- Improved documentation structure, making setup and usage clearer for both CLI and API users.
v1.0.7
- Changed all base URLs from gateway.maton.ai and ctrl.maton.ai to api.maton.ai.
- Updated sample code and instructions to use the new api.maton.ai endpoints.
- Added a security & permissions section, clarifying write operation requirements.
- Minor wording and formatting improvements in documentation.
- Removed the LICENSE.txt file.
v1.0.6
- Added homepage field to metadata for better discoverability and navigation to Maton platform.
- Minor metadata improvements; no changes to functionality or API usage.
v1.0.5
- Added a metadata section for clawdbot, specifying an emoji and required environment variable (MATON_API_KEY).
- No functional or API changes; documentation and compatibility remain the same.
v1.0.4
Version 1.0.4
- No file changes detected in this release.
- No updates or modifications to documentation or source code.
v1.0.3
- Added a note recommending the api-gateway skill for third party apps other than Notion.
- Replaced all shell/bash and JavaScript code examples with Python equivalents using `urllib.request` and standard libraries.
- Updated code snippets and quick start instructions to reflect the new Python-based examples for API usage and connection management.
- No changes to the API endpoints or core functionality; documentation updates only.
v1.0.2
- Clarified the gateway base URL pattern: use `/notion/{native-api-path}` instead of `/notion/v1/{endpoint}`.
- Added instructions for specifying the Notion connection via the new `Maton-Connection` header when multiple OAuth connections exist.
- Improved the "Getting Your API Key" section to mention account creation.
- Updated example connection response to include `creation_time`, `last_updated_time`, and `metadata`.
- Improved documentation formatting and consistency, with adjustments to connection management and quick start sections.
v1.0.1
- Clarified the relationship between databases and data sources: `GET /databases/{id}` now returns a `data_sources` array.
- Added an example output for the `GET /databases/{id}` data sources structure for clarity.
- Expanded connection management documentation with both "list connections" and "get single connection" response examples.
- Added example for the "Update Page Icon" endpoint.
- Improved explanations of endpoints and usage throughout for accuracy and consistency.
v1.0.0
- Initial release of Notion API integration with managed OAuth.
- Supports querying databases, creating/updating pages, and managing blocks in Notion workspaces.
- API gateway proxies requests to Notion API and handles OAuth token injection.
- Includes detailed setup instructions, API reference, connection management, and code examples (bash, JavaScript, Python).
- Databases and data sources are clearly separated for querying and schema updates.
- Comprehensive error handling and resource links provided.
元数据
常见问题
Notion 是什么？
Notion API integration with managed OAuth. Query databases, search pages, and read workspace content. Write operations require explicit user confirmation of... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 9950 次。
如何安装 Notion？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install notion-api-skill」即可一键安装，无需额外配置。
Notion 是免费的吗？
是的，Notion 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Notion 支持哪些平台？
Notion 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Notion？
由 byungkyu（@byungkyu）开发并维护，当前版本 v1.0.10。
推荐 Skills