Skip to main content
Notion 是一个支持修改版 Markdown 的协作平台，集成了看板、任务、维基和数据库。它是一个集笔记、知识与数据管理、项目与任务管理于一体的全能工作空间。
NotionDBLoader 是一个用于从 Notion 数据库加载内容的 Python 类。它从数据库中检索页面，读取其内容，并返回一个 Document 对象列表。NotionDirectoryLoader 用于从 Notion 数据库转储中加载数据。

​
要求

  • 一个 Notion 数据库
  • Notion 集成令牌

​
设置

​
1. 创建一个 Notion 表格数据库

在 Notion 中创建一个新的表格数据库。你可以向数据库添加任何列，它们将被视为元数据。例如，你可以添加以下列：
  • 标题：将“标题”设置为默认属性。
  • 分类：一个多选属性，用于存储与页面关联的分类。
  • 关键词：一个多选属性，用于存储与页面关联的关键词。
将你的内容添加到数据库中每个页面的正文中。NotionDBLoader 将从这些页面中提取内容和元数据。

​
2. 创建一个 Notion 集成

要创建 Notion 集成，请按照以下步骤操作：
  1. 访问 Notion 开发者 页面，并使用你的 Notion 帐户登录。
  2. 点击“+ New integration”按钮。
  3. 为你的集成命名，并选择你的数据库所在的工作区。
  4. 选择所需的能力，此扩展仅需要“读取内容”能力。
  5. 点击“Submit”按钮以创建集成。 集成创建后，你将获得一个 集成令牌 (API key)。复制此令牌并妥善保管，因为你需要它来使用 NotionDBLoader。

​
3. 将集成连接到数据库

要将你的集成连接到数据库，请按照以下步骤操作：
  1. 在 Notion 中打开你的数据库。
  2. 点击数据库视图右上角的三点菜单图标。
  3. 点击“+ New integration”按钮。
  4. 找到你的集成，你可能需要在搜索框中开始输入其名称。
  5. 点击“Connect”按钮将集成连接到数据库。

​
4. 获取数据库 ID

要获取数据库 ID，请按照以下步骤操作：
  1. 在 Notion 中打开你的数据库。
  2. 点击数据库视图右上角的三点菜单图标。
  3. 从菜单中选择“Copy link”以将数据库 URL 复制到剪贴板。
  4. 数据库 ID 是 URL 中找到的一长串字母数字字符。它通常看起来像这样：www.notion.so/username/8935f9d140a04f95a872520c4f123456?v=… 在此示例中，数据库 ID 是 8935f9d140a04f95a872520c4f123456。
数据库设置正确并拥有集成令牌和数据库 ID 后，你现在可以使用 NotionDBLoader 代码从你的 Notion 数据库加载内容和元数据。

​
5. 安装

安装 langchain-community 集成包。 
pip install -qU langchain-community

​
Notion 数据库加载器

NotionDBLoader 是 langchain 包文档加载器的一部分。你可以按如下方式使用它： 
from getpass import getpass

NOTION_TOKEN = getpass()
DATABASE_ID = getpass()

········
········

from langchain_community.document_loaders import NotionDBLoader

loader = NotionDBLoader(
    integration_token=NOTION_TOKEN,
    database_id=DATABASE_ID,
    request_timeout_sec=30,  # 可选，默认为 10
)

docs = loader.load()

print(docs)

​
Notion 目录加载器

​
设置

从 Notion 导出你的数据集。你可以通过点击右上角的三个点，然后点击 Export 来完成此操作。 导出时，请确保选择 Markdown & CSV 格式选项。 这将在你的下载文件夹中生成一个 .zip 文件。将 .zip 文件移动到此仓库中。 运行以下命令解压缩 zip 文件（根据需要将 Export... 替换为你自己的文件名）。 
unzip Export-d3adfe0f-3131-4bf3-8987-a52017fc1bae.zip -d Notion_DB

​
用法

运行以下命令以摄取你刚刚下载的数据。 
from langchain_community.document_loaders import NotionDirectoryLoader

loader = NotionDirectoryLoader("Notion_DB")

docs = loader.load()
将这些文档连接到 Claude、VSCode 等，通过 MCP 获取实时答案。
在 GitHub 上编辑此页面 或 提交问题。