核心用法
ffcli 是一款第三方命令行工具,用于直接与 Fireflies.ai 平台交互,无需打开网页即可检索会议数据。主要功能包括:
- 会议列表查询:按时间范围、参与者、关键词筛选会议,支持
--md输出可读格式 - 详情查看:获取单次会议的完整信息、AI 生成的摘要或完整转录文本
- 脚本自动化:通过 JSON 输出配合
jq提取 action items、批量导出会议 ID 等 - 身份认证:支持本地存储 API Key 或环境变量
FIREFLIES_API_KEY
显著优点
1. 效率提升:相比网页操作,CLI 更适合快速查询和批量处理
2. 脚本友好:JSON 输出便于与其他工具链集成,适合构建自动化工作流
3. 多安装渠道:同时支持 Homebrew 和 npm,覆盖不同技术栈用户
4. 输出灵活:提供 Markdown 和 JSON 两种格式,兼顾可读性和机器处理
潜在缺点与局限性
- 第三方工具:非 Fireflies.ai 官方出品,由个人开发者 @ruigomeseu 维护,长期支持和更新存在不确定性
- 功能边界:仅支持读取操作,无法创建会议、修改记录或管理账户设置
- API 依赖:完全依赖 Fireflies.ai 的 API 可用性和速率限制
- 认证管理:API Key 存储在本地
~/.config/ffcli/,需用户自行确保文件权限安全
适合人群
- 需要频繁查询会议记录的技术团队负责人
- 希望将会议数据整合到内部工具链的工程师
- 习惯命令行操作、追求效率的高级用户
- 需要批量导出会议摘要进行归档或分析的场景
常规风险
- API Key 泄露风险:Key 存储于本地文件或环境变量,共享设备时需注意权限设置
- 数据隐私:会议转录内容通过第三方 CLI 传输,虽直接调用官方 API,但用户需信任该 CLI 未植入恶意代码
- 供应链安全:建议安装前审查 npm 包或 Homebrew tap 的源码,确认发布者身份
- 服务中断:个人维护项目可能因开发者精力或平台 API 变更而停止更新