用途：面向 OpenHands 的 Notion 扩展，用于通过 Notion API 创建、搜索、更新页面与数据库，适合文档记录、生成 runbook、自动化知识库更新。优先使用 MCP；仅在 MCP 不可用或需要原始 API/curl 访问时走直连 REST API。
主要能力：搜索页面、在父页面下创建页面、向已有页面追加块。使用直连 API 前先检查环境变量： [ -n "$NOTION_INTEGRATION_KEY" ] && echo "NOTION_INTEGRATION_KEY is set" || echo "NOTION_INTEGRATION_KEY is NOT set" 缺失时需用户提供（集成密钥以 ntn_ 开头）或连接 Notion 集成。无论用 MCP 还是直连 API，都需确认集成已与目标页面/数据库共享。
必要请求头：
-H "Authorization: Bearer ${NOTION_INTEGRATION_KEY}"
-H "Notion-Version: 2022-06-28"
-H "Content-Type: application/json"
用法要点：搜索用 POST https://api.notion.com/v1/search；创建页面用 POST https://api.notion.com/v1/pages，需指定 parent、properties.title 和 children；追加块用 PATCH https://api.notion.com/v1/blocks/${PAGE_ID}/children。Windows PowerShell 等价示例见 references/windows.md。
限制：集成必须先在 Notion UI 中被共享到目标页面/数据库，否则即使密钥有效也无法访问；注意速率限制，大页面建议先创建再分批追加块；ID 带不带短横线通常都可用。API 文档：https://developers.notion.com/reference/intro。