SuperAPI AI 工具集

granola

办公与效率

查看项目

更新于 10-16 05:49

技能介绍

用途:该技能用于导入、列出和导出 Granola 会议录音与转录,通过 Granola Personal API 查询笔记、查看转录,并按 Fathom 技能相同格式导出到 Obsidian 仓库。

前提条件:需要 Granola Business 或 Enterprise 套餐(Personal API 必需);API Key 存放于 sops 加密的 ~/Brains/brain/.env.granola,格式为 GRANOLA_API_KEY=grn_...;无额外依赖,仅使用标准库。

使用方式:运行 python3 ~/.claude/skills/granola/scripts/granola.py <command> [options]。命令包括 list(列出笔记)、show <note_id>(显示摘要、参会者,可选转录)、export <note_id>(导出为 Obsidian Markdown)。选项有 --format text|json、--after <ISO date>、--all、--transcript、--vault <path>(默认 ~/Brains/brain)、--output <path>。

导出格式:frontmatter 含 granola_id、title、date、participants、duration、source: granola,正文含 Summary 与 Transcript,文件保存为 Sessions/YYYYMMDD-meeting-title-slug.md。

API 细节:Base URL 为 https://public-api.granola.ai/v1,使用 Bearer token(Personal API Key,永不过期),速率限制为 25 请求突发 / 5 请求每秒持续。API 仅返回已生成摘要的笔记,进行中的会议不会出现。

已知限制:无实时/进行中访问;无逐句说话人姓名,仅提供来源(麦克风 vs 扬声器)和可选 diarization_label,导出时将会议所有者分配给麦克风语句;需先用 list 获取 not_xxxx ID 再 show/export。

集成:导出后可对输出文件运行 transcript-analyzer 做深入分析;Granola 导出与 Fathom 导出使用相同 frontmatter 和转录格式,下游工具可通用。