Notion 集成

将 Starnion 连接到 Notion，让 AI 智能体能够以自然语言搜索 Notion 页面、创建新页面、读取或追加内容。您可以用它来撰写会议记录、记录想法以及搜索知识库。

概述

通过 Notion 集成，您可以：

  • 搜索：使用自然语言搜索工作区中的页面和数据库
  • 创建页面：创建带有标题和正文内容的新页面
  • 读取内容：通过页面 ID 或 URL 检索并摘要页面内容
  • 追加内容：向现有页面添加新文本块

可选功能： Notion 集成默认禁用。您必须完成以下设置流程并启用技能才能使用。

支持的功能

功能 说明
notion_search 搜索页面和数据库
notion_page_create 创建新页面（可包含正文内容）
notion_page_read 读取页面内容
notion_block_append 向现有页面追加块

前提条件：创建 Notion 集成

Notion 集成使用集成令牌。您需要在 Notion 工作区中创建集成，并单独授予 AI 需要访问的页面权限。

第一步：创建 Notion 集成

  1. 前往 https://www.notion.so/my-integrations。
  2. 点击 + 新建集成。
  3. 输入集成名称（例如：Starnion）。
  4. 选择要连接的工作区。

  5. 在功能标签页下，验证并启用所需权限。

    权限 说明 是否必需
    读取内容 读取页面和数据库 必需
    更新内容 编辑页面内容 推荐
    插入内容 创建新页面和块 推荐
  6. 点击保存。
  7. 复制密钥（内部集成密钥）。
secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

安全提示： 集成令牌相当于密码，请勿公开分享。

第二步：将集成连接到页面

默认情况下，Notion 集成无法访问任何页面。您必须单独授予 AI 需要访问的每个页面或数据库的权限。

  1. 在 Notion 中打开您想要允许访问的页面。
  2. 点击右上角的 …（更多） → 连接（或连接到）。
  3. 搜索并选择您创建的集成名称（例如：Starnion）。
  4. 点击确认。

提示： 将集成连接到父页面会自动授予所有子页面的访问权限。要访问整个工作区，请将其连接到顶级页面。

设置

在网页界面中注册集成令牌

  1. 登录 Starnion 网页界面。
  2. 点击左侧菜单中的设置 → 集成标签页。
  3. 在 Notion 部分找到集成令牌输入字段。
  4. 粘贴您复制的密钥（secret_...）。
  5. 点击保存。
  6. 开启启用 Notion 技能开关。

保存后，令牌将存储在数据库中，并用于所有后续的 Notion 请求。

使用方法

设置好 Notion 集成后，以自然语言向 AI 发出请求。

搜索页面

搜索工作区中的页面和数据库。

我：在 Notion 中查找"Q2 计划"
机器人：关于"Q2 计划"的搜索结果（2个结果）：
    📄 [页面] 2026年第二季度业务计划 | ID：abc123
    📄 [页面] Q2 营销计划             | ID：def456

我：在 Notion 中仅搜索数据库（项目）
机器人：关于"项目"的搜索结果（1个结果）：
    🗄️ [数据库] 项目管理看板 | ID：ghi789

过滤选项：

  • 全部（默认）：同时搜索页面和数据库
  • page 过滤器：仅搜索页面
  • database 过滤器：仅搜索数据库

创建页面

创建带有标题和正文内容的新页面。

我：创建一个名为"2026年3月会议记录"的 Notion 页面
机器人：Notion 页面已创建！
    标题：2026年3月会议记录
    URL：https://notion.so/2026-abc123...

我：创建一个名为"阅读清单"的 Notion 页面，并写入以下内容：
    1. 最重要的事
    2. 原子习惯
机器人：Notion 页面已创建！
    标题：阅读清单
    URL：https://notion.so/def456...

您也可以在指定的父页面下创建子页面。

我：在页面 abc123 下创建"会议记录 2026-03-08"页面
机器人：Notion 页面已创建！
    标题：会议记录 2026-03-08
    URL：https://notion.so/...

读取页面内容

通过页面 ID 或 URL 检索内容。

我：显示 Notion 页面 abc123 的内容
机器人：📄 2026年第二季度业务计划
    URL：https://notion.so/...

    ## 目标
    - 营收增长15%
    - 新增20+客户

我：摘要 https://notion.so/project-plan-abc123 的内容
机器人：（读取并摘要页面内容。）
    本页面是2026年新服务计划...

向现有页面追加内容 

我：向页面 abc123 添加"行动项：下周完成 UI 改进"
机器人：内容已添加到 Notion 页面。

我：将今天的决定添加到会议记录页面：
    - 4月发布已确认
    - 负责人：张三
机器人：内容已添加到 Notion 页面。

使用场景示例

自动整理会议记录 

我：将刚才的会议记录整理到 Notion。
    参与者：张三、李四
    要点：Q2 路线图讨论，4月发布已确认
    行动项：起草提案（张三，3/15前完成）

机器人：Notion 页面已创建！
    标题：2026-03-08 Q2 路线图会议
    URL：https://notion.so/...

保存想法备忘录 

我：将我刚想到的想法保存到 Notion。
    "基于 AI 的日程优化功能——学习用户的精力规律
    以在最佳时间安排重要事件"

机器人：Notion 页面已创建！
    标题：想法备忘录 2026-03-08
    URL：https://notion.so/...

搜索和检索知识库 

我：在 Notion 中找到 API 指南
机器人：关于"API 指南"的搜索结果（2个结果）：
    📄 [页面] 内部 REST API 指南 v2 | ID：...
    📄 [页面] 外部 API 集成清单     | ID：...

我：摘要内部 REST API 指南 v2 的内容
机器人：（读取并摘要内容。）
    本文档描述了如何使用内部 REST API...

注意事项

集成访问范围

Notion 集成只能访问已明确授予访问权限的页面和数据库。查询未连接集成的页面将返回”页面未找到”错误。

页面内容长度限制

notion_page_read 最多返回 3,000 个字符。如果内容更长，只显示开头部分，并提示”内容已被截断”。

创建顶级页面的权限

如果未指定父页面，页面将在工作区顶层创建。这要求集成具有工作区级别的写入权限。

如何断开连接

  1. 设置 → 集成 → Notion 部分。
  2. 点击断开连接。
  3. 已存储的 Notion API 密钥将立即删除。

要同时从 Notion 工作区中删除集成连接：

  1. 前往 my-integrations → 选择集成。
  2. 点击删除集成。

故障排除

“Notion 集成未设置”

检查您是否在 设置 → 集成 → Notion 下注册了集成令牌。令牌以 secret_ 开头。

“Notion API 密钥无效”（401 错误）

  • 验证集成令牌是否正确。
  • 在 my-integrations 检查令牌是否仍然有效。
  • 生成新令牌并在设置中更新。

“页面未找到”（404 错误）

  • 检查集成是否已连接到该页面。
  • 在 Notion 中打开页面 → … → 连接 → 添加集成。

“无权创建页面”（403 错误）

  • 检查集成是否启用了插入内容权限。
  • 在 my-integrations 验证集成的功能设置。

常见问题

Q：我可以向 Notion 数据库添加记录吗？ A：目前支持页面创建、读取内容和追加块。不支持直接操作数据库属性。

Q：我可以连接多个 Notion 工作区吗？ A：目前每个用户只能注册一个集成令牌。作为变通方法，可以将同一集成连接到多个工作区的页面。

Q：集成令牌会过期吗？ A：Notion 内部集成令牌除非您手动重新生成，否则不会过期。但是，如果您从 Notion 删除集成，它将无法再使用。

Q：我可以编辑（覆盖）现有页面内容吗？ A：目前只支持向页面末尾追加新块。不支持编辑现有块内容。

Q：Starnion 如何保护 Notion API 密钥？ A：API 密钥在服务器端存储在数据库中（integration_keys 表），不在界面中显示。仅通过 HTTPS 传输。

Copyright © 2025 StarNion. All rights reserved.  |  v0.1.1