Notion MCP Server Mfy

🚀 Notion API を用いた自動化ワークフロー

Notion は、ノート作成、タスク管理、ナレッジベース構築など、様々な操作をサポートする強力なオンライン協働ツールです。Notion API を統合することで、自動化ワークフローを実現し、作業効率を向上させることができます。この記事では、Python スクリプトを使用して Notion とやり取りする方法を詳しく説明します。これには、インストールと設定、主要機能とその実装が含まれます。

✨ 主な機能

1. コンテンツ作成：ページやブロックの内容を自動生成および更新します。
2. データ検索：特定のデータベース内のレコードを検索します。
3. 属性管理：データベースのフィールドとその値を操作します。
4. ワークフロー自動化：新しいページの作成など、さまざまなイベントを監視して応答します。

📦 インストール

依存関係のインストール

まず、必要な Python ライブラリをインストールします。

pip install notional python-dotenv

環境変数の設定

Notion API トークンを保存するための .env ファイルを作成します。

NOTION_TOKEN=your_token_here
NOTION_SPACE_ID=your_space_id_here

💻 使用例

基本的な使用法

コンテンツ作成

以下のコードを使用して、新しいページの内容を作成できます。

from notional import Notional

# 初始化 Notional 客户端
client = Notional(token='your_token')

# 创建新页面
new_page = {
    'parent': {'database_id': 'your_database_id'},
    'properties': {
        'Name': {
            'title': [
                {
                    'text': {
                        'content': 'New Page'
                    }
                }
            ]
        }
    },
    'children': [
        {
            'object': 'block',
            'type': 'paragraph',
            'paragraph': {
                'rich_text': [
                    {
                        'type': 'text',
                        'text': {'content': 'This is a new page created via Notion API'}
                    }
                ]
            }
        }
    ]
}

response = client.pages.create(
    parent={'database_id': 'your_database_id'},
    properties=new_page['properties'],
    children=new_page['children']
)

データ検索

以下のコードは、データベースのレコードを検索する方法を示しています。

# 获取数据库内容
database = client.databases.retrieve('your_database_id')

# 查询所有记录
results = client.databases.query('your_database_id', {
    'filter': {
        'property': 'Name',
        'contains': True,
        'query': 'Example'
    }
})

# 处理返回结果
for result in results['results']:
    print(result['properties']['Name']['title'][0]['text']['content'])

属性管理

データベースのフィールドを操作する例です。

# 更新页面属性
client.pages.update(
    page_id='your_page_id',
    properties={
        'Status': {
            'select': {
                'name': 'Complete'
            }
        }
    }
)

# 删除指定属性
client.properties.delete('property_id')

高度な使用法

ワークフロー自動化

Webhook を設定してイベントを監視します。

from notional.webhooks import Webhook

# 创建并订阅 webhook
webhook = Webhook(client, secret='your_secret_key', url='https://your_endpoint.com/webhook')

@webhook.listener('page_created')
def handle_page_create(event):
    print(f"New page created: {event['page']['id']}")

webhook.start()

> ⚠️ 重要提示

• API トークンには適切な操作権限があることを確認してください。
• コード内に機密情報を平文で保存しないでください。環境変数または暗号化されたストレージを使用することをおすすめします。
• Notion API から返されるステータスコードとエラーメッセージに対して適切なエラー処理を行ってください。

以上の手順に従うことで、Notion ワークスペースの内容を効果的に自動管理し、作業効率を向上させることができます。