核心用法
Fireflies Skill 是一个面向 Fireflies.ai 平台的只读型 API 查询工具，通过 GraphQL 接口获取会议相关的全量数据。用户需配置 FIREFLIES_API_KEY 环境变量完成认证，即可执行六大类查询操作：获取当前用户信息、检索单条或多条会议记录、按日期/参与者/组织者/关键词筛选会议、提取会议摘要与行动项、获取情感分析与发言统计等高级分析数据，以及查询联系人列表和活跃会议状态。所有查询均通过标准 curl 命令配合 jq 进行 JSON 处理，支持灵活的变量传参和结果过滤。
显著优点
企业级数据整合能力：直接对接 Fireflies.ai 官方 API，可获取包括转录文本、AI 摘要、行动项提取、关键词识别、发言者统计、情感分析在内的完整会议数据资产，无需手动导出或格式转换。
灵活的检索维度：支持时间范围、特定参与者、组织者、关键词（标题或全文）等多维度组合筛选，满足销售复盘、项目跟进、合规审计等场景化需求。
零侵入式架构：纯读取操作设计，不修改任何源数据；仅依赖 curl 和 jq 两个标准系统工具，无额外运行时或包管理依赖，部署极简。
永久分享链接生成：内置 embed URL 构造逻辑，可将会议记录转换为无需登录即可访问的永久分享链接，便于向客户、合作伙伴外部传递关键信息。
潜在缺点与局限性
功能只读受限：无法创建、修改或删除会议记录，也不能触发新的转录任务，仅适用于数据消费场景，无法替代 Fireflies 官方应用的核心工作流。
计划等级功能差异：高级分析功能（情感分析、发言统计、视频下载等）需要 Pro 或 Business 以上订阅计划，免费或基础计划用户无法完整使用全部查询字段。
媒体链接时效性：audio_url 和 video_url 仅在生成后 24 小时内有效，需按需重新获取，不适合作为长期存档引用。
分页与性能边界：单次查询上限为 50 条记录，大规模历史数据检索需配合 skip 参数多次调用，对海量会议库的全量分析效率有限。
GraphQL 学习成本：相比 REST API，GraphQL 的查询语法和字段嵌套结构对非技术用户存在一定上手门槛。
适合的目标群体
- 销售与客户成功团队：批量提取客户会议行动项，追踪承诺事项闭环
- 产品经理与项目经理：按项目成员或关键词检索相关讨论，快速定位决策依据
- 高管与助理：生成周度/月度会议摘要汇总，掌握组织沟通全貌
- 合规与审计人员：按时间范围导出会议记录，满足存档与审查要求
- 数据分析师：将会话数据接入 BI 工具，量化团队沟通模式与效率指标
使用风险
API Key 安全管理：密钥通过环境变量传递，若在多用户环境或日志中泄露，可能导致会议数据被未授权访问。建议配合密钥管理服务或 CI/CD 加密机制使用。
数据隐私边界：Skill 可访问用户账户下全部会议数据，包括含敏感商业信息的对话内容，需确保查询结果的分发范围符合企业数据治理政策。
外部依赖可用性：功能完全依赖 Fireflies.ai 服务的在线状态与 API 稳定性，若官方服务中断或接口变更，Skill 将失效。
查询成本控制：高频或大规模数据拉取可能触发 Fireflies 平台的速率限制或额外计费，生产环境使用前应确认当前套餐的 API 调用配额。