用途：面向 Notion 工作区自动化，用官方 REST API 和 Python SDK 构建集成。适用场景包括自动化数据库条目与更新、从 Notion 数据构建自定义看板、在 Notion 与外部系统间同步数据、按模板以编程方式创建页面、用复杂过滤器查询数据库、与其他效率工具集成、从数据库生成报告、实现工作流自动化。
主要能力：数据库的搜索、创建、读取、更新与查询（含过滤、排序、分页）；页面创建、读取、更新、归档与恢复；块操作（段落、标题、列表、待办、折叠、代码块、引用等）。过滤语法覆盖文本、数字、日期（含相对日期）、选择/多选、复选框、关联与汇总，并支持 and/or 嵌套组合。
使用方式：先在 https://www.notion.so/my-integrations 创建集成并复制 Internal Integration Token，再把集成连接到目标页面/数据库。设置环境变量 export NOTION_API_KEY="secret_xxx"，安装 pip install notion-client（或 uv pip install notion-client），并可安装 python-dotenv requests。调用示例：notion = Client(auth=os.environ["NOTION_API_KEY"])，notion.users.me()，notion.search(filter={"property": "object", "value": "database"})，notion.databases.query(database_id=...)。REST 请求需带 Authorization: Bearer $NOTION_API_KEY 与 Notion-Version: 2022-06-28。
限制：资料指出 API 有速率限制，不适合需要实时同步、亚秒级响应或离线优先的场景；聊天/消息功能建议用 Slack API，文件存储建议用专用存储，简单任务管理建议用 Todoist API，离线优先建议用 Obsidian。收费、价格、平台等事实资料未提供。