← 返回 Skills 市场
notion-enhanced-markdown-integration
作者
Fental Huang
· GitHub ↗
· v1.0.0
· MIT-0
83
总下载
1
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install notion-enhanced-markdown
功能描述
Notion API for creating and managing pages, databases, blocks and enhanced markdown.
安全使用建议
This skill appears to do what it says (curl calls to api.notion.com to read/write pages and markdown), but the SKILL.md and registry metadata disagree about how the Notion key is provided: the registry lists NOTION_API_KEY, while the instructions tell you to store the key in ~/.config/notion/api_key and use NOTION_KEY. Before installing, ask the author to clarify/fix: (1) which environment variable name the platform should provide (NOTION_API_KEY vs NOTION_KEY), (2) whether the skill will read ~/.config/notion/api_key — if so, that path should be declared and you should be aware of file permissions (avoid world-readable files), and (3) confirm the skill only contacts api.notion.com. If you proceed, grant the integration the minimum Notion scopes needed (read-only vs insert_content) and avoid storing long-lived keys in unsecured files. If you want higher assurance, request the full (non-truncated) SKILL.md and an explanation of secret-handling behavior so the inconsistencies can be resolved.
功能分析
Type: OpenClaw Skill
Name: notion-enhanced-markdown
Version: 1.0.0
The skill bundle describes a non-existent 'Markdown API' and a future-dated Notion API version (2026-03-11), which will cause the agent to fail when attempting to interact with the real Notion service. Additionally, the documentation in SKILL.md provides curl examples that are vulnerable to shell command injection if the agent populates placeholders (e.g., {page_id} or {data_source_id}) with unsanitized user input. While the behavior is highly unusual and non-functional, there is no clear evidence of intentional data exfiltration or malicious backdoors.
能力评估
Purpose & Capability
The name/description and the SKILL.md consistently implement Notion API operations (pages, databases/data_sources, blocks, markdown). Requiring a Notion API credential is proportionate. However, the registry metadata declares NOTION_API_KEY as the required env var, while the SKILL.md examples use a file (~/.config/notion/api_key) and an environment variable named NOTION_KEY — an inconsistency between claimed and actual usage.
Instruction Scope
The instructions tell the agent/operator to read the API key from ~/.config/notion/api_key (via cat) and set NOTION_KEY, but the skill's declared requirements do not list that config path. The SKILL.md otherwise confines actions to api.notion.com endpoints and curl calls (expected), but the explicit filesystem access to a user key file is not declared and expands the surface area.
Install Mechanism
This is an instruction-only skill with no install spec and no code files. That minimizes install-time risk — nothing is downloaded or written by an installer.
Credentials
Only a single credential (Notion API key) is requested, which is appropriate. But there's inconsistency: registry expects NOTION_API_KEY as primaryEnv, while SKILL.md uses a file and an env var named NOTION_KEY. The skill does not declare the ~/.config/notion/api_key path even though the instructions read it. That mismatch weakens the stated proportionality and could lead to unexpected secret handling.
Persistence & Privilege
always is false and the skill does not request system-wide modifications or persistent presence. Autonomous invocation is allowed (platform default) but not combined with other high-risk flags here.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install notion-enhanced-markdown - 安装完成后,直接呼叫该 Skill 的名称或使用
/notion-enhanced-markdown触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Notion skill 1.0.0 adds support for enhanced Markdown read/write API and updates to the latest Notion API.
- Updated to Notion API version 2026-03-11, with new endpoints and terminology
- Added Markdown API sections for creating, reading, and updating pages as plain Markdown
- Detailed support for Markdown-compatible block types, syntax, and limitations
- Expanded documentation for search/replace, partial updates, and content replacement in Markdown
- Updated environment variable and setup instructions
- Clarified differences and usage of database_id vs. data_source_id
元数据
常见问题
notion-enhanced-markdown-integration 是什么?
Notion API for creating and managing pages, databases, blocks and enhanced markdown. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 83 次。
如何安装 notion-enhanced-markdown-integration?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install notion-enhanced-markdown」即可一键安装,无需额外配置。
notion-enhanced-markdown-integration 是免费的吗?
是的,notion-enhanced-markdown-integration 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
notion-enhanced-markdown-integration 支持哪些平台?
notion-enhanced-markdown-integration 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 notion-enhanced-markdown-integration?
由 Fental Huang(@fental)开发并维护,当前版本 v1.0.0。
推荐 Skills