Notion コネクター

Notion コネクターは最も多機能なコネクターの1つで、ワークスペース全体検索、データベースクエリ、親ページツリー走査の3つの同期モードをサポートします。

認証

OAuth — スコープ:

• read:content
• read:database

設定

同期モード

ワークスペース

ワークスペース内の全ページを検索。包括的な同期に最適。

データベース

特定のNotionデータベースをクエリ。各行が1つの文書に。

親ページ

特定ページ配下の全子ページを同期。再帰的ブロック走査を使用。

動作の仕組み

1. モード選択 — モードごとに異なるAPIエンドポイント: 検索、データベースクエリ、ブロック子要素
2. ブロック取得 — 各ページの全ブロックを再帰的に取得
3. リッチテキスト変換 — Notionリッチテキストをプレーンテキストに変換
4. ブロックタイプ処理 — 段落、見出し、コードブロック、数式、ToDo項目などに対応
5. コンテンツ遅延 — 一覧取得時はスタブ、完全なブロック内容は getDocument で取得

文書フォーマット

Notionブロックから変換:

ページタイトル

段落テキスト...

# 見出し 1
段落...

## 見出し 2
その他のテキスト...

```python
コードブロック

• 完了したタスク
• 保留中のタスク

## メタデータタグ
| タグ | タイプ | 説明 |
|-----|------|-------------|
| タグ | テキスト | Notionページタグ/プロパティ |
| 最終更新日 | 日付 | 最終編集日時 |
| 作成日 | 日付 | 作成日時 |