mcpField
F
fireflies-transcript

fireflies-transcript

github.com/davidondrej生产力4.2k121 次安装今天更新
代码仓库

关于 fireflies-transcript

fireflies-transcript 是只读技能，可从 Fireflies.ai 获取带说话人标记的原始会议记录文本，适用于处理会议记录请求的 Agent，并提供查找、提取和核验步骤。

主要功能

  1. 01列出并查找会议记录
  2. 02获取句子文本与说话人
  3. 03读取可选摘要和参与者
  4. 04报告前核验记录内容

适用场景

  1. 01按日期或标题查找会议
  2. 02将带说话人标记的记录保存到文件
  3. 03核对记录中的说话人和主题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/davidondrej/skills --skill fireflies-transcript

安装后在 Claude Code 中输入/fireflies-transcript确认已加载。

附带文件agents/openai.yaml

详细介绍

Fireflies Transcript

通过 GraphQL 将 Fireflies.ai 中的任意会议转录内容作为原始文本获取。只读。

身份验证（先检查状态）

从本地环境文件加载 API 密钥（权限设为 600，绝不提交或打印）：

source "$SERVICE_ENV_FILE"   # exports API_KEY
[ -n "$API_KEY" ] || echo "MISSING KEY - stop and tell the user"

每次调用都是向 https://api.fireflies.ai/graphql 发送 POST 请求，包含 Authorization: Bearer <API_KEY> 和 JSON 请求体 {"query": "..."}。

第 1 步——查找会议 ID

curl -sS -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API_KEY>" \
  -d '{"query":"{ transcripts(limit: 25) { id title date duration } }"}' \
  | jq -r '.data.transcripts[] | "\(.id) | \(.title) | \(.date)"'
  • date 是以毫秒为单位的 epoch 时间戳。在 macOS 上转换：date -r $((1784127600000/1000))。
  • transcripts(title:) 筛选条件为精确匹配——部分名称不会返回结果（[]）。 请列出最近的会议，然后在本地使用 grep 搜索。
  • 临时会议没有正式标题（例如 Untitled - Wed, 15 Jul 2026 17:00:55 CEST）。 根据日期和时间识别这些会议，然后通过内容或发言者确认，而不是依赖标题。
  • 使用 skip: 翻页获取较早的会议（例如 transcripts(limit: 50, skip: 25)）。

第 2 步——拉取原始转录内容

QUERY='{ transcript(id: "MEETING_ID") { title sentences { speaker_name text } } }'
curl -sS -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API_KEY>" \
  -d "$(jq -nc --arg query "$QUERY" '{query: $query}')" \
  > /tmp/ff.json

# speaker-labeled raw text (usual deliverable)
jq -r '.data.transcript.sentences[] | "\(.speaker_name): \(.text)"' /tmp/ff.json

# bare text only
jq -r '.data.transcript.sentences[].text' /tmp/ff.json

转录内容通常有数百句话——请保存到文件中，绝不要输出到标准输出或聊天中。

可在同一个 transcript(id:) 查询中添加：summary { overview short_summary keywords }、 participants、duration、meeting_link。

故障模式

  • sentences: null——录音仍在处理中，或未采集到音频；没有内容可拉取。
  • 响应中出现 errors[] 而不是 data——通常是字段名称错误；请修正查询。
  • 401/密钥无效——密钥已轮换；请向用户索取新密钥（Fireflies 控制面板： Settings -> Developer settings），并更新本地环境文件。

报告完成前的验证

只有当句子数量大于 0，且发言者和主题与用户询问的会议相符时，拉取才算成功——请检查开头几行，不要只相信标题。

评论

支持 Markdown