用途:读取和查询 Notion 数据库与页面,支持多个工作区,适合数据迁移与导出。当用户要求从 Notion 拉取数据、列出数据库、查询数据库条目或导出内容时使用。
首次设置(每个工作区约3分钟):在 Notion Integrations 新建内部集成,选择目标工作区,确保启用 Read content,提交后复制以 ntn_ 或 secret_ 开头的内部集成密钥;每个工作区需单独创建集成。集成只能访问被显式共享的页面:打开数据库或页面,点击右上角 ... 菜单,选择 Add connections,搜索并选中集成,对所需页面重复操作。然后创建 ~/.claude/skills/notion-skill/config.json 配置账户,含 default_account 与 accounts(如 personal、work 的 email、workspace、token)。
命令:accounts 列出账户;databases [-a ACCOUNT] 列出已共享的数据库;query DATABASE_ID [-a ACCOUNT] [--limit N] [--filter PROPERTY:VALUE] 查询数据库;page PAGE_ID [-a ACCOUNT] 获取页面属性与内容;search "query" [-a ACCOUNT] [--type database|page] 搜索;export DATABASE_ID [-a ACCOUNT] [--output FILE] 导出数据库为 JSON。
输出为 JSON,条目含 id、url、created_time、last_edited_time、properties 等;支持 title、rich_text、number、select、multi_select、status、date、people、email、phone_number、url、checkbox、relation、rollup、formula、files、时间戳和用户等属性类型。数据库 ID 可从 URL 或 databases 命令获取。
限制:仅使用 Python 标准库,无外部依赖;集成令牌不过期但可撤销,令牌存于本地 config.json 且被 gitignore;撤销访问需在 Notion Integrations 删除集成。其余细节暂未提供。