用途：vibe-notionbot 是 vibe-notion 包提供的 TypeScript 命令行工具，让 AI 智能体或人通过 Notion 官方 API 以机器人身份操作 Notion 工作区，覆盖页面、数据库、块、用户、评论和搜索。它与同包的 vibe-notion 不同：后者用非官方私有 API、以用户身份运行、零配置；本 CLI 用官方版本化 API、以机器人身份运行，需手动创建集成。
主要能力：页面获取、创建（可指定父页面或数据库）、更新属性、替换内容、归档、读取属性；数据库获取、查询（过滤、排序、分页）、创建、更新、删除属性、列出；块获取、列出子块、追加（支持 markdown、文件、嵌套列表、按位置插入）、更新、删除、上传文件；用户列表与查询；工作区搜索（可按类型过滤、排序、分页）；评论列出、创建、回复、获取。batch 命令可在一次调用中顺序执行 11 种写操作，支持内联 JSON 或 --file，失败即停止并返回各操作结果。
使用方式：设置环境变量 export NOTION_TOKEN=secret_xxx，再用 vibe-notionbot auth status 检查。常用命令如 vibe-notionbot search "Project Roadmap"、vibe-notionbot page create --parent <parent_id> --title "My New Page"。未安装时可用 npx -y -p vibe-notion vibe-notionbot ... 等包运行器直接执行。输出默认 JSON，加 --pretty 可读。
限制：仅支持 Notion API 版本 2025-09-03；不支持 OAuth，只能用令牌；页面属性更新仅限 --set 的简单键值对；不支持视图管理与工作区列表。官方要求不要直接调用 Notion API 或使用 @notionhq/client，也不要写脚本自动化，批量操作应使用 batch。大批量（30+）可能触发 429，建议每批约 25-30 个操作并分批重试。