notion

用途：借助 Notion REST API 与 curl 直接管理 Notion 的页面、数据库和内容块，无需额外安装独立 CLI。主要能力包括：搜索页面与数据库；读取、创建和更新页面（如修改标题）；读取页面子块与追加段落块；查询数据库并按属性过滤。基础地址为 https://api.notion.com/v1，请求头需带 Authorization: Bearer $NOTION_API_KEY、Notion-Version: 2022-06-28 与 Content-Type: application/json。使用前先导出环境变量：export NOTION_API_KEY="secret_xxxxxxxxxxxx"，密钥可在 https://www.notion.so/my-integrations 创建集成后获取，并把目标页面或数据库分享给该集成。示例：搜索用 POST /v1/search 并传 {"query": "<search term>"}；查询数据库用 POST /v1/databases/<DB_ID>/query，可带 filter；追加块用 PATCH /v1/blocks/<PAGE_ID>/children，传 children 数组。限制与注意：须先检查密钥是否设置；不要把密钥写入内存或工作区文件；页面 ID 为 32 位十六进制字符串；若遇 404，需提醒用户将页面或数据库分享给集成；建议输出经 jq 处理，长内容保存到工作区文件而非直接展示。