Notion Publisher

v1.0.0

使用目标数据库默认 Notion 模板的本地缓存副本，将文章发布到 Notion。当用户输入 /not... 时使用此技能。

0· 0·0 当前·0 累计

by @miraclemin

数据分析内容创作笔记工具数据库

下载技能包

安全扫描

VirusTotal

无害

查看报告

OpenClaw

可疑

medium confidence

该技能看似合法的 Notion 发布工具，但其注册元数据未提及 NOTION_TOKEN 要求，且运行时会读写本地 config/.env 文件——这些不一致及本地凭据存储值得在安装前谨慎对待。

评估建议

This 技能 mostly does what it clAIms: it bundles a Python 命令行工具 that talks to https://API.notion.com and uses local templates and a config directory (~/.notion_publish). Before 安装ing or 运行ning it: 1) Be aware you'll need to provide a Notion integration 令牌 (NOTION_令牌) — the registry metadata does not declare this, so assume it's required. 2) The 命令行工具 will 创建 ~/.notion_publish, write a JSON config, and can read/write ~/.notion_publish/.env — avoid storing secrets in plAIntext there unless you accep...

详细分析 ▾

ℹ 用途与能力

The name/description (publish articles to Notion) matches the included 命令行工具 and templates. However, the 技能.md and bundled 命令行工具 explicitly require a NOTION_令牌 for API calls while the 技能 registry metadata 列出s no required 环境 variables or primary 凭证 — that is an inconsistency and should be declared.

ℹ 指令范围

运行time instructions stay within the publishing 工作流: choose a database, fetch 模式, render templates, and call Notion接口s (or use MCP if avAIlable). The instructions do ask the 代理 to 运行 shell commands (which is expected for a bundled 命令行工具) and to read/write ~/.notion_publish config and ~/.notion_publish/.env. Those file operations are within the 技能's 状态d purpose but broaden its 访问 to the user's home directory.

✓ 安装机制

No 安装 spec — the 技能 is instruction + bundled Python script. The 命令行工具 is dependency-free and 运行s via python3; there are no 下载s or external 安装 URLs in the package, which keeps 安装 risk low.

⚠ 凭证需求

The 技能.md and scripts expect NOTION_令牌 (and read a ~/.notion_publish/.env), yet the registry clAIms no required env vars or primary 凭证. Requiring a Notion integration 令牌 is reasonable for this functionality, but the omission from metadata is a mismatch that could mislead users about 凭证 needs. The 技能 also writes files under ~/.notion_publish (config, optional 缓存d templates, and .env), so users should be aware 凭证s may be stored locally if they follow the 命令行工具图形界面dance.

ℹ 持久化与权限

The 技能创建s and 更新s ~/.notion_publish/notion-publisher-config.json and may write ~/.notion_publish/.env and 缓存d templates. always:false (not force-安装ed) and no cross-技能 config changes are 请求ed. Local persistence is expected for a publisher but the user should review what is stored (especially .env) before use.

安全有层次，运行前请审查代码。

运行时依赖

无特殊依赖

安装命令

点击复制

官方npx clawhub@latest install notion-publisher

镜像加速npx clawhub@latest install notion-publisher --registry https://cn.longxiaskill.com 镜像可用

需要定制？告诉我你的需求 →

技能文档

Notion Publisher 技能触发当用户输入 /notion-publisher 或要求“发布、起草、在 Notion 数据库创建文章/页面”时调用。

共享配置路径 ~/.notion_publish/notion-publisher-config.json 仅保存可复用的发布偏好： { "default_status": "Draft", "template_strategy": "ask_each_time" } 禁止保存：数据库 ID、数据源 ID、标签、分类、封面、文章内容、Notion token、私有工作区 URL。

每次询问目标数据库。

检测平台选择运行前，先检测客户端是否为 OpenClaw： which openclaw 2>/dev/null && echo "PLATFORM=openclaw" || echo "PLATFORM=other" PLATFORM=openclaw：假设 Notion MCP 不可用，优先用内置 CLI。 PLATFORM=other：有 MCP 用 MCP，无 MCP 退回到 CLI。

Notion 运行选项支持 MCP 与纯命令行客户端（如 OpenClaw）。优先级：

有 Notion MCP 工具 → 用 MCP。
无 MCP 但可执行 shell → 用内置 CLI：scripts/notion_publisher.py
两者皆无 → 生成 Markdown 并提示用户手动发布。

CLI 依赖使用官方 Notion API，需环境变量 NOTION_TOKEN 或文件 ~/.notion_publish/.env 示例：NOTION_TOKEN=secret_xxx 目标数据库须与集成共享。获取 token：

打开 Notion integrations/creator dashboard → 新建内部集成 → 复制 Internal Integration Secret。
在 Content access 共享数据库。
将 secret 保存到 ~/.notion_publish/.env，勿提交到仓库。

MCP 工具名视客户端可用工具而定： Codex：mcp__notion__notion_search / fetch / create_pages / update_page Claude Code / Claude plugin：mcp__plugin_Notion_notion__notion-search 等若无 MCP 工具，不自动停止；可执行 shell 时转 CLI。

CLI 示例发布： python3 scripts/notion_publisher.py publish \ --database-id "NOTION_DATABASE_ID_OR_URL" \ --title "Article title" \ --body-file article.md \ --status Draft \ --type Post

或直接用数据源： --data-source-id "collection://DATA_SOURCE_ID"

省略 ID 时 CLI 会交互询问；默认不保存，仅当用户显式加 --save-database 才记录。

更新： python3 scripts/notion_publisher.py update \ --page-id "NOTION_PAGE_ID_OR_URL" \ --mode replace|append \ --body-file article.md

搜索： python3 scripts/notion_publisher.py search \ --data-source-id "collection://DATA_SOURCE_ID" \ --query "keyword" \ --limit 10 返回 JSON 含 id, title, status, type, category, slug, date, url。 MCP 搜索为语义级；CLI 搜索为 API 查询+本地关键字过滤。

工作流

读配置：cat ~/.notion_publish/notion-publisher-config.json

不存在则立即创建默认文件。确认文章时向用户展示 default_status 与 template_strategy，允许单次覆盖。封面每次重选。

每次询问目标数据库：

请选择目标 Notion 数据库： 1. 粘贴数据库 URL 2. 输入数据库 ID 3. 输入关键词搜索 4. 回车搜索可能的文章数据库

运行时依赖

安装命令

技能文档

相关技能推荐