tool-save-to-notion（tool save TO Notion 搜索）

tool-save-to-notion

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

何时使用

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

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

工具箱数据库

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

数据库字段

执行流程

步骤 1: 接收 URL

用户可能这样说：

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

步骤 2: 提取页面信息

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

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

WebFetch 示例：

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

步骤 3: 构建结构化数据

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

步骤 4: 调用 Notion API 保存

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

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。

### 步骤 5: 返回结果

保存成功后，告诉用户：

✅ 已保存到 Notion 工具箱

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

🔗 在 Notion 中查看

---

## 类型选择指南

**⚠️ 重要：类型只能从以下 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 工具集 |

### 类型判断逻辑

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

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

---

## 标签提取策略

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

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)** - 首选

<meta property="og:image" content="https://example.com/image.jpg" />

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

2. **Twitter Card Image** - 备选

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

3. **GitHub 仓库特殊处理** - GitHub 专用
   - 使用 GitHub 默认 OG 图片：`https://opengraph.githubassets.com/1/{owner}/{repo}`

4. **无合适图片** - 不设封面
   - 某些网站（如即刻）不提供 og:image 或 twitter:image
   - 跳过封面设置，Notion 页面正常创建但没有封面和正文图片

### 封面图验证

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

### Notion Cover 字段格式

"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 调用失败：
1. 显示错误信息
2. 提供可能的原因
3. 建议用户检查 Notion 设置

❌ 保存失败

错误信息：{error_message}

可能的原因：

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

请检查：

• settings.json 中的 NOTION_API_KEY 是否正确
• 数据库是否已连接到 Integration

---

## 完整示例

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

**用户输入：**

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

**执行步骤：**

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

**返回结果：**

✅ 已保存到 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: 产品官网（软件）

**用户输入：**

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

**返回结果：**

✅ 已保存到 Notion 工具箱

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

🔗 在 Notion 中查看

### 示例 3: Chrome 插件

**用户输入：**

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

**返回结果：**

✅ 已保存到 Notion 工具箱

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

🔗 在 Notion 中查看

### 示例 4: Prompt 模板网站

**用户输入：**

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

**返回结果：**

✅ 已保存到 Notion 工具箱

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

辅助脚本

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

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

环境变量

确保 settings.json 中配置了：

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

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

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

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

或者：

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

快速参考

API 调用模板

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 | 工具包