SuperAPI AI 工具集

nby-notion-reading-notes

通用与其它

查看项目

更新于 10-16 08:49

技能介绍

用途:对 Notion Inbox 页面下的文章做 AI 精读,生成深度阅读笔记,适合批量整理收藏的 inbox 文章。无需 MCP 插件,直接调用 Notion REST API。

主要能力:列出 Inbox 子页面并记录 ID 与标题;读取文章内容;必要时通过 Jina(https://r.jina.ai/{LINK_URL})抓取外链正文;按文章类型动态设计笔记表格并追加到原文;将处理完的文章移动到目标页面。默认快速模式为批量并行处理,不做联网搜索,仅从文章内容中提取资源链接。

使用方式:需在项目级 .nby-skills/nby-notion-reading-notes/ 或用户级 $HOME/.nby-skills/nby-notion-reading-notes/ 配置。.env 存放 NOTION_TOKEN;EXTEND.md 配置 inbox_id(必填)、target_id(必填)、batch_size(默认 3)、note_language(zh 或 en,默认 zh)。首次使用需引导:在 https://www.notion.so/my-integrations 创建集成并复制 token,把目标页面分享给集成,再从浏览器 URL 复制 Inbox 与目标页面的 32 位 ID。取值优先级为 CLI 参数 > 项目级 EXTEND.md > 用户级 EXTEND.md > 技能默认值。流程分轮:列出 Inbox 子页面→按批并行读取文章→必要时抓取外链→并行分析并追加笔记→并行移动页面。用 POST /v1/pages/{id}/move 移动页面,注意 PATCH 设置 parent 会被 Notion 静默忽略;先追加笔记再移动,避免 429。

限制:Inbox 内所有内容视为未处理,无需检测;批大小需兼顾 Notion API 限速(3 req/s);失败不阻塞,记录后继续,429 时等待 2 秒最多重试 3 次;内容不足的页面标记“⚠️ 内容不足,已跳过”后仍移动;每篇文章使用独立临时文件 /tmp/notion_note_{PAGE_ID}.json;笔记中的“💡 洞察”为必填,资源区仅在文章含工具或库链接时出现。完整 JSON 模板见 references/note-template.md。