首页 注册 登录
OA0 = Omni AI 0
OA0 是一个探索 AI 的论坛
现在注册
已注册用户请  登录
OA0  ›  技能包  ›  fireflies: 访问 Fireflies.ai 会议记录、摘要及待办事项

fireflies: 访问 Fireflies.ai 会议记录、摘要及待办事项

 
  gateway ·  2026-02-01 10:42:19 · 3 次点击  · 0 条评论  

name: fireflies
description: 通过 GraphQL API 访问 Fireflies.ai 的会议转录、摘要、待办事项和分析数据
metadata: {"clawdbot":{"secrets":["FIREFLIES_API_KEY"]}}

Fireflies.ai 技能

查询 Fireflies.ai 中的会议转录、摘要、待办事项和分析数据。

设置

设置您的 Fireflies API 密钥：

FIREFLIES_API_KEY=your_api_key_here

从以下地址获取您的 API 密钥：https://app.fireflies.ai/integrations (滚动到 Fireflies API 部分)

API 基础信息

GraphQL 端点：https://api.fireflies.ai/graphql

授权请求头：Bearer $FIREFLIES_API_KEY

核心查询

获取当前用户信息

curl -s -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FIREFLIES_API_KEY" \
  -d '{"query":"{ user { user_id name email is_admin minutes_consumed num_transcripts recent_meeting } }"}' | jq

获取单条转录记录

curl -s -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FIREFLIES_API_KEY" \
  -d '{"query":"query($id:String!){transcript(id:$id){id title date duration participants fireflies_users summary{keywords action_items overview topics_discussed} speakers{name duration} sentences{speaker_name text start_time}}}","variables":{"id":"TRANSCRIPT_ID"}}' | jq

按日期范围搜索转录记录

# ISO 8601 格式: YYYY-MM-DDTHH:mm:ss.sssZ
curl -s -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FIREFLIES_API_KEY" \
  -d '{"query":"query($from:DateTime,$to:DateTime,$limit:Int){transcripts(fromDate:$from,toDate:$to,limit:$limit){id title date duration organizer_email participants summary{keywords action_items overview}}}","variables":{"from":"2024-01-01T00:00:00.000Z","to":"2024-01-31T23:59:59.999Z","limit":50}}' | jq

按参与者搜索转录记录

# 搜索特定人员参与的会议
curl -s -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FIREFLIES_API_KEY" \
  -d '{"query":"query($participants:[String],$limit:Int){transcripts(participants:$participants,limit:$limit){id title date participants organizer_email summary{action_items}}}","variables":{"participants":["john@example.com","jane@example.com"],"limit":20}}' | jq

按组织者搜索转录记录

curl -s -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FIREFLIES_API_KEY" \
  -d '{"query":"query($organizers:[String],$limit:Int){transcripts(organizers:$organizers,limit:$limit){id title date organizer_email participants}}","variables":{"organizers":["sales@example.com"],"limit":25}}' | jq

按关键词搜索（标题和/或转录内容）

# scope 参数可选: "TITLE", "SENTENCES", 或 "ALL"
curl -s -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FIREFLIES_API_KEY" \
  -d '{"query":"query($keyword:String,$scope:String){transcripts(keyword:$keyword,scope:$scope,limit:10){id title date summary{overview}}}","variables":{"keyword":"pricing","scope":"ALL"}}' | jq

获取我的近期转录记录

curl -s -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FIREFLIES_API_KEY" \
  -d '{"query":"{ transcripts(mine:true,limit:10) { id title date duration summary { action_items keywords } } }"}' | jq

高级查询

获取包含摘要和待办事项的完整转录记录

curl -s -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FIREFLIES_API_KEY" \
  -d '{"query":"query($id:String!){transcript(id:$id){id title date duration organizer_email participants fireflies_users workspace_users meeting_attendees{displayName email} summary{keywords action_items outline overview bullet_gist topics_discussed meeting_type} speakers{name duration word_count} sentences{speaker_name text start_time end_time}}}","variables":{"id":"TRANSCRIPT_ID"}}' | jq

获取包含分析数据的转录记录

# 需要 Pro 或更高版本套餐
curl -s -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FIREFLIES_API_KEY" \
  -d '{"query":"query($id:String!){transcript(id:$id){id title analytics{sentiments{positive_pct neutral_pct negative_pct} speakers{name duration word_count filler_words questions longest_monologue words_per_minute}}}}","variables":{"id":"TRANSCRIPT_ID"}}' | jq

获取联系人

curl -s -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FIREFLIES_API_KEY" \
  -d '{"query":"{ contacts { email name picture last_meeting_date } }"}' | jq

获取进行中的会议

curl -s -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FIREFLIES_API_KEY" \
  -d '{"query":"{ active_meetings { id title organizer_email meeting_link start_time state } }"}' | jq

管道审查示例

获取过去 7 天内包含特定参与者的所有会议：

# 日期命令 (根据您的操作系统选择):
# macOS:
FROM_DATE=$(date -u -v-7d +"%Y-%m-%dT00:00:00.000Z")
# Linux:
# FROM_DATE=$(date -u -d '7 days ago' +"%Y-%m-%dT00:00:00.000Z")

TO_DATE=$(date -u +"%Y-%m-%dT23:59:59.999Z")

curl -s -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FIREFLIES_API_KEY" \
  -d "{\"query\":\"query(\$from:DateTime,\$to:DateTime,\$participants:[String]){transcripts(fromDate:\\\"\$FROM_DATE\\\",toDate:\\\"\$TO_DATE\\\",participants:\$participants,limit:50){id title date duration organizer_email participants summary{keywords action_items topics_discussed meeting_type}}}\",\"variables\":{\"from\":\"$FROM_DATE\",\"to\":\"$TO_DATE\",\"participants\":[\"prospect@company.com\"]}}" | jq

关键模式字段

转录记录字段

  • id - 唯一标识符
  • title - 会议标题
  • date - Unix 时间戳 (毫秒)
  • dateString - ISO 8601 日期时间
  • duration - 时长 (分钟)
  • organizer_email - 会议组织者邮箱
  • participants - 所有参与者邮箱
  • fireflies_users - 参与的 Fireflies 用户
  • workspace_users - 参与的团队成员
  • meeting_attendees - 详细的参会者信息 (displayName, email)
  • transcript_url - 在仪表板中查看的链接
  • audio_url - 音频下载链接 (Pro+ 套餐，24 小时后过期)
  • video_url - 视频下载链接 (Business+ 套餐，24 小时后过期)

摘要字段

  • keywords - 关键主题
  • action_items - 提取的待办事项
  • overview - 会议概览
  • topics_discussed - 主要讨论主题
  • meeting_type - 会议类别
  • outline - 结构化大纲
  • bullet_gist - 要点摘要

句子字段

  • text - 句子文本
  • speaker_name - 发言人
  • start_time - 开始时间戳 (秒)
  • end_time - 结束时间戳
  • ai_filters - AI 过滤器 (任务、问题、定价等)

发言人字段

  • name - 发言人姓名
  • duration - 发言时长
  • word_count - 发言字数
  • filler_words - 填充词数量
  • questions - 提出的问题数量
  • longest_monologue - 最长连续发言时长
  • words_per_minute - 语速 (每分钟字数)

过滤器示例

按日期范围 (ISO 8601)

{
  "fromDate": "2024-01-01T00:00:00.000Z",
  "toDate": "2024-01-31T23:59:59.999Z"
}

按多个参与者

{
  "participants": ["user1@example.com", "user2@example.com"]
}

按频道

{
  "channel_id": "channel_id_here"
}

组合过滤器

{
  "fromDate": "2024-01-01T00:00:00.000Z",
  "toDate": "2024-01-31T23:59:59.999Z",
  "participants": ["sales@example.com"],
  "keyword": "pricing",
  "scope": "ALL",
  "limit": 50
}

PowerShell 示例

$headers = @{
  "Authorization" = "Bearer $env:FIREFLIES_API_KEY"
  "Content-Type" = "application/json"
}

# 获取近期转录记录
$body = @{
  query = "{ transcripts(mine:true,limit:10) { id title date } }"
} | ConvertTo-Json

Invoke-RestMethod -Uri "https://api.fireflies.ai/graphql" -Method POST -Headers $headers -Body $body

可分享的录制链接

API 提供了 transcript_url、video_url 和 audio_url，但若要与外部人员（潜在客户、客户）分享，请使用嵌入 URL 格式：

API transcript_url:  https://app.fireflies.ai/view/{id}           (需要 Fireflies 登录)
嵌入 URL:           https://share.fireflies.ai/embed/meetings/{id}  (无需登录，永久有效)

为何使用嵌入 URL：
- 无需 Fireflies 账户即可查看
- 永久链接 (不像 video_url/audio_url 会过期)
- 更好的观看体验 (嵌入式播放器)

构建方法：

# 从 API 获取会议 ID
MEETING_ID=$(curl -s -X POST https://api.fireflies.ai/graphql \
  -H "Authorization: Bearer $FIREFLIES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"{ transcripts(mine:true,limit:1) { id } }"}' | jq -r '.data.transcripts[0].id')

# 构建嵌入 URL
EMBED_URL="https://share.fireflies.ai/embed/meetings/${MEETING_ID}"
echo "分享此链接: $EMBED_URL"

嵌入 HTML：

<iframe 
  src="https://share.fireflies.ai/embed/meetings/{id}" 
  width="640" 
  height="360" 
  frameborder="0" 
  allow="autoplay; fullscreen; picture-in-picture" 
  allowfullscreen>
</iframe>

注意事项

  • 依赖项：需要 curl 和 jq (安装命令：sudo apt install jq 或 brew install jq)
  • 速率限制：请向 Fireflies 支持咨询当前限制
  • 分页：对于大量结果集，请使用 limit (最大 50) 和 skip 参数
  • 日期格式：始终使用 ISO 8601 格式：YYYY-MM-DDTHH:mm:ss.sssZ
  • 音频/视频 URL：24 小时后过期，需要时可重新生成 (永久分享请使用嵌入 URL)
  • 分析功能：需要 Pro 或更高版本套餐
  • 视频录制：必须在仪表板设置中启用

常见用例

  1. 每周管道审查：按日期和参与者搜索转录记录
  2. 后续任务：从近期会议中提取待办事项
  3. 竞争对手提及：在句子中搜索关键词
  4. 发言分析：分析发言时间、提问次数
  5. 会议洞察：获取摘要和关键主题
技能包地址：https://github.com/openclaw/skills/tree/main/skills/daniil-ctrl/fireflies/SKILL.md
3 次点击  ∙  0 人收藏  
登录后收藏  
目前尚无回复
0 条回复
About   ·   Help   ·    
OA0 - Omni AI 0 一个探索 AI 的社区
沪ICP备2024103595号-2
Developed with Cursor