tool-save-to-notion

Automatically save any tool URL with extracted name, type, tags, description, and cover image as a structured entry in your Notion Toolbox database.

Alex Redisread@redisread

Install

openclaw skills install @redisread/tool-save-to-notion

tool-save-to-notion

自动将工具链接保存到 Notion 工具箱数据库。

何时使用

当用户提供以下任一链接时立即使用此技能：

GitHub 仓库链接
工具/产品官方网站
AI 工具页面
浏览器插件商店页面
在线服务/网页工具
软件包页面 (npm, PyPI 等)
任何用户说"保存"、"收藏"、"添加到工具箱"的链接

工具箱数据库

Database ID: 6f7bb9cc-ac01-41c5-9856-fb1568d197ae 描述: 所有工具收集地

数据库字段

字段	类型	必填	说明
Name	title	✅	工具名称
类型	multi_select	✅	工具分类（见下方类型选择指南）
标签	multi_select	✅	技术标签（平台、功能、技术栈等）
URL	url	✅	原始链接
简介	rich_text	✅	1-2 句话描述
⭐ 置顶	checkbox	❌	是否置顶（默认 false）
创建时间	created_time	自动	Notion 自动记录
更新时间	last_edited_time	自动	Notion 自动记录

执行流程

步骤 1: 接收 URL

用户可能这样说：

"保存这个工具：https://github.com/user/repo"
"把这个添加到我的工具箱"
"收藏：https://example.com"
"save this: https://..."

步骤 2: 提取页面信息

使用 WebFetch 访问 URL，提取关键信息：

text

需要提取：
1. 工具名称 (Name) - 页面标题或 og:title
2. 描述 (Description) - meta description 或页面简介
3. 关键词 - meta keywords, 页面内容中的技术名词
4. 页面类型 - 根据域名判断类型
5. 封面图 URL (Cover) - og:image 或 twitter:image（可选，用于 Notion 页面封面）

WebFetch 示例：

text

访问 https://github.com/user/repo
提取：
- 标题：仓库名称
- 描述：仓库简介
- 主题：GitHub topics
- 语言：主要编程语言

步骤 3: 构建结构化数据

根据提取的信息构建 Notion API 所需的数据格式。

步骤 4: 调用 Notion API 保存

使用以下 API 调用（一次性创建页面，同时设置封面和正文图片）：

bash

curl -X POST "https://api.notion.com/v1/pages" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2021-05-13" \
  -H "Content-Type: application/json" \
  -d '{
    "parent": {
      "database_id": "6f7bb9cc-ac01-41c5-9856-fb1568d197ae"
    },
    "cover": {
      "type": "external",
      "external": {
        "url": "https://example.com/cover-image.jpg"
      }
    },
    "children": [
      {
        "object": "block",
        "type": "image",
        "image": {
          "type": "external",
          "external": {"url": "https://example.com/cover-image.jpg"}
        }
      }
    ],
    "properties": {
      "Name": {
        "title": [{"text": {"content": "工具名称"}}]
      },
      "类型": {
        "multi_select": [{"name": "类型"}]
      },
      "标签": {
        "multi_select": [{"name": "标签 1"}, {"name": "标签 2"}]
      },
      "URL": {
        "url": "https://example.com"
      },
      "简介": {
        "rich_text": [{"text": {"content": "工具简介..."}}]
      },
      "⭐ 置顶": {
        "checkbox": false
      }
    }
  }'

注意：

cover 字段是可选的。如果提取到封面图，添加该字段；如果没有封面图，省略该字段。
children 字段用于在正文中插入封面图，让数据库列表视图更丰富。
必须在创建页面时使用 children 参数，后续追加 blocks 需要使用不同的 API。

text


### 步骤 5: 返回结果

保存成功后，告诉用户：

✅ 已保存到 Notion 工具箱

📌 名称：{Name} 🔗 URL: {URL} 📁 类型：{类型} 🏷️ 标签：{标签列表} 📝 简介：{简介} 🖼️ 封面：顶部封面 + 正文图片

🔗 在 Notion 中查看

text


---

## 类型选择指南

**⚠️ 重要：类型只能从以下 5 个选项中选择（单选）：**

| 类型 | 适用场景 | 示例 |
|------|----------|------|
| **软件** | 桌面应用、移动应用、独立客户端 | VS Code、Figma 桌面版、Notion App |
| **网站** | 在线服务、Web 应用、SaaS 平台 | claude.ai、notion.so、GitHub |
| **浏览器插件** | Chrome/Edge/Safari 扩展程序 | Chrome Web Store 中的插件 |
| **Prompt** | Prompt 模板、提示词集合、AI 指令 | Prompt 库、提示词工具 |
| **工具包** | SDK、库、框架、CLI 工具、工具集 | npm 包、Python 库、GitHub 工具集 |

### 类型判断逻辑

是浏览器插件吗？ → 浏览器插件
是 Prompt 相关吗？ → Prompt
是库/SDK/框架/CLI 吗？ → 工具包
是独立桌面/移动应用吗？ → 软件
其他所有 Web 服务 → 网站

text


**注意：类型是单选，不是多选！** 每个工具只能选择一个最匹配的类型。

---

## 标签提取策略

从页面内容中提取标签，优先级：

1. **显式标签** - 页面明确标注的 topics/tags
2. **技术栈** - React, Vue, Python, TypeScript, Node.js 等
3. **平台** - Mac, Windows, Chrome, VS Code, iOS 等
4. **功能** - AI, 效率，设计，开发工具，数据分析等
5. **来源** - GitHub, 开源，独立开发，SaaS 等

**标签示例：**
- 技术：`React`, `TypeScript`, `Python`, `Next.js`
- 平台：`Mac`, `Chrome`, `VS Code`, `Web`
- 功能：`AI`, `效率`, `设计`, `开发工具`, `API`
- 来源：`GitHub`, `开源`, `独立开发`, `SaaS`

**提示：** 标签应该简洁，每个标签不超过 10 个字符。

---

## 封面图提取策略

从页面内容中提取封面图，按以下优先级：

### 提取优先级

1. **Open Graph Image (og:image)** - 首选
   ```html
   <meta property="og:image" content="https://example.com/image.jpg" />

质量最高，通常是网站专门准备的分享图片
尺寸一般符合 Notion 封面要求（建议 ≥ 600x300）

Twitter Card Image - 备选

html

<meta name="twitter:image" content="https://example.com/image.jpg" />

GitHub 仓库特殊处理 - GitHub 专用
- 使用 GitHub 默认 OG 图片：https://opengraph.githubassets.com/1/{owner}/{repo}
无合适图片 - 不设封面
- 某些网站（如即刻）不提供 og:image 或 twitter:image
- 跳过封面设置，Notion 页面正常创建但没有封面和正文图片

封面图验证

最小尺寸: 600x300 像素（Notion 推荐）
支持格式: JPEG, PNG, GIF, WebP
协议要求: 必须是 HTTPS 链接
相对路径处理: 如果是相对路径，需要拼接为绝对 URL

Notion Cover 字段格式

json

"cover": {
  "type": "external",
  "external": {
    "url": "https://example.com/cover-image.jpg"
  }
}

注意: cover 字段是可选的。如果提取到合适的封面图则添加，否则省略。

错误处理

常见错误及解决方案

错误	原因	解决方法
401 Unauthorized	API key 无效或过期	检查 settings.json 中的 NOTION_API_KEY
403 Forbidden	Integration 无写入权限	确认数据库已连接 Integration
400 Bad Request	请求格式错误	检查 JSON 格式和字段类型
404 Not Found	数据库 ID 错误	确认 database_id 正确

错误响应处理

如果 API 调用失败：

显示错误信息
提供可能的原因
建议用户检查 Notion 设置

text

❌ 保存失败

错误信息：{error_message}

可能的原因：
1. API key 无效或过期
2. Integration 没有数据库写入权限
3. 数据库 ID 不正确

请检查：
- settings.json 中的 NOTION_API_KEY 是否正确
- 数据库是否已连接到 Integration

完整示例

示例 1: GitHub 仓库（工具包）

用户输入：

text

保存这个工具：https://github.com/nidhinjs/prompt-master

执行步骤：

访问页面 - WebFetch 获取页面信息
提取内容：
- 名称："prompt-master"
- 描述："A Claude skill that writes accurate prompts for any AI tool"
- 类型："工具包"（这是一个 Claude skill 工具集）
- 标签：["GitHub", "AI", "Prompt Engineering", "Claude"]
- 封面图：自动提取 GitHub 仓库的 Open Graph 图片
构建请求
调用 API 保存

返回结果：

text

✅ 已保存到 Notion 工具箱

📌 名称：prompt-master
🔗 URL: https://github.com/nidhinjs/prompt-master
📁 类型：工具包
🏷️ 标签：GitHub, AI, Prompt Engineering, Claude
📝 简介：A Claude skill that writes accurate prompts for any AI tool
🖼️ 封面：顶部封面 + 正文图片

🔗 在 Notion 中查看

示例 2: 产品官网（软件）

用户输入：

text

把这个加到工具箱：https://www.figma.com

返回结果：

text

✅ 已保存到 Notion 工具箱

📌 名称：Figma
🔗 URL: https://www.figma.com
📁 类型：软件
🏷️ 标签：设计，协作，UI/UX, Web, SaaS
📝 简介：Collaborative interface design tool

🔗 在 Notion 中查看

示例 3: Chrome 插件

用户输入：

text

保存这个 Chrome 插件：https://chromewebstore.google.com/detail/xxx

返回结果：

text

✅ 已保存到 Notion 工具箱

📌 名称：xxx
🔗 URL: https://chromewebstore.google.com/detail/xxx
📁 类型：浏览器插件
🏷️ 标签：Chrome, 生产力，AI
📝 简介：xxx 插件描述

🔗 在 Notion 中查看

示例 4: Prompt 模板网站

用户输入：

text

收藏这个 Prompt 网站：https://flowgpt.com

返回结果：

text

✅ 已保存到 Notion 工具箱

📌 名称：FlowGPT
🔗 URL: https://flowgpt.com
📁 类型：Prompt
🏷️ 标签：AI, Prompt, 模板，社区
📝 简介：Share and discover the best prompts for ChatGPT

---

## 辅助脚本

技能包含一个 Python 辅助脚本 `scripts/save-to-notion.py`，可以命令行调用：

```bash
python scripts/save-to-notion.py \
  --url "https://example.com" \
  --name "工具名称" \
  --type 网站 AI 工具 \
  --tags AI 效率 开发工具 \
  --description "工具描述"

环境变量

确保 settings.json 中配置了：

json

{
  "env": {
    "NOTION_API_KEY": "ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

⚠️ 重要：数据库权限设置

在保存工具到 Notion 之前，必须将数据库共享给 integration：

打开 Notion 中的"工具箱"数据库
点击右上角的 "···" (更多按钮)
选择 "Connect to" 或 "Add connections"
选择你的 integration 名称（例如 "openclaw"）
确认连接

或者：

打开 https://www.notion.so/my-integrations
点击你的 integration
点击 "Add to workspace" 或 "Connected workspaces"
确保选择了正确的工作区
然后在 Notion 中打开数据库，点击右上角 "Share"
在 Search people 中搜索你的 integration 名称并添加

快速参考

API 调用模板

bash

curl -X POST "https://api.notion.com/v1/pages" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2021-05-13" \
  -H "Content-Type: application/json" \
  -d '{
    "parent": {"database_id": "6f7bb9cc-ac01-41c5-9856-fb1568d197ae"},
    "cover": {
      "type": "external",
      "external": {"url": "https://.../cover-image.jpg"}
    },
    "children": [
      {
        "object": "block",
        "type": "image",
        "image": {
          "type": "external",
          "external": {"url": "https://.../cover-image.jpg"}
        }
      }
    ],
    "properties": {
      "Name": {"title": [{"text": {"content": "名称"}}]},
      "URL": {"url": "https://..."},
      "简介": {"rich_text": [{"text": {"content": "描述"}}]},
      "类型": {"multi_select": [{"name": "软件"}]},
      "标签": {"multi_select": [{"name": "标签 1"}]},
      "⭐ 置顶": {"checkbox": false}
    }
  }'

注意： API 版本使用 2021-05-13 以支持 children 参数。

类型列表（仅限这 5 个）

软件 | 网站 | 浏览器插件 | Prompt | 工具包

tool-save-to-notion

Install

tool-save-to-notion

何时使用

工具箱数据库

数据库字段

执行流程

步骤 1: 接收 URL

步骤 2: 提取页面信息

步骤 3: 构建结构化数据

步骤 4: 调用 Notion API 保存

封面图验证

Notion Cover 字段格式

错误处理

常见错误及解决方案

错误响应处理

完整示例

示例 1: GitHub 仓库（工具包）

示例 2: 产品官网（软件）

示例 3: Chrome 插件

示例 4: Prompt 模板网站

环境变量

⚠️ 重要：数据库权限设置

快速参考

API 调用模板

类型列表（仅限这 5 个）

Related skills