mcpField
F
fireflies

fireflies

github.com/magnus919生产力15759 次安装今天更新
代码仓库

关于 fireflies

fireflies 是用于通过 CLI 访问 Fireflies.ai 的技能，面向需要查看会议记录和管理相关数据的用户。它直接调用 Fireflies GraphQL 接口，支持只读查询，并要求变更先预览、确认后执行。

主要功能

  1. 01查询转录文本、摘要和会议数据
  2. 02查看用户、频道、群组及联系人
  3. 03读取分析数据和进行中的会议
  4. 04预览写入请求并要求明确确认
  5. 05验证 Webhooks V2 签名

适用场景

  1. 01搜索并读取会议转录
  2. 02查看会议分析或活动会议
  3. 03创建 AskFred 转录提问
  4. 04经确认后更新会议或用户设置

安装

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

$npx skills add https://github.com/magnus919/agent-skills --skill fireflies

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
evals/
evals.json
references/
api-reference.md
cli-reference.md
source-index.md
troubleshooting.md
webhook-security.md
workflows.md
scripts/
fireflies
tests/
test_fireflies.py

详细介绍

Fireflies.ai

在此技能目录中使用 scripts/fireflies。它直接调用 Fireflies GraphQL 端点， 并将 API 响应以 JSON 格式输出。只读探索是安全的。进行任何状态更改前，请确认 目标、范围和回滚路径；然后通过 CLI 的字面参数 --confirm 执行更改。 --dry-run 只预览负载，绝不授权写入。

首次使用

  1. 检查命令架构：scripts/fireflies --help 以及相关子命令的帮助信息。
  2. 仅在实际 API 请求时设置 FIREFLIES_API_KEY。请勿泄露或持久保存该密钥。
  3. 从只读探索开始，例如 scripts/fireflies transcripts list --limit 10 --json。
  4. 每次变更前都使用 --dry-run --json 检查确切的 GraphQL 负载。

命令一览

需求命令
查找转录元数据scripts/fireflies transcripts list --keyword TEXT --limit 10 --json
读取会议、摘要、句子、分析数据和录音链接scripts/fireflies transcripts get ID --json
人员、频道、群组、联系人、应用users、channels、groups、contacts、apps
会议分析数据或实时会议analytics --start DATE --end DATE、meetings active
提出有关转录的问题askfred create --question TEXT --transcript-id ID --confirm
读取 AskFred 主题串askfred get THREAD_ID
分配管理员/用户角色users set-role --user-id ID --role admin --confirm
将会议移至某个频道meetings update-channel --channel-id ID --transcript-ids A,B,C --confirm
通过链接添加实时会议live add-to --meeting-link URL --confirm
创建简短音频片段live soundbite --meeting-id ID --prompt TEXT --confirm
两阶段文件上传audio create-upload ... --confirm，然后执行 audio confirm-upload --meeting-id ID --confirm
运行当前/未来 API 的精确操作query --document GRAPHQL --variables JSON
在本地验证已送达的 Webhookwebhook verify --secret SECRET --signature sha256=... --body FILE

安全变更工作流

  1. 确定 Fireflies 对象 ID，并说明拟进行的更改。
  2. 与用户确认目标、范围和回滚路径。删除操作可能无法撤销。
  3. 使用 --dry-run 预览确切的文档；这不会发出 HTTP 请求。
  4. 使用 --confirm 执行已获批准的确切变更。
  5. 返回响应，不要打印凭据。

示例：

scripts/fireflies meetings rename transcript-id --title "Weekly product review" --dry-run --json
scripts/fireflies meetings rename transcript-id --title "Weekly product review" --confirm --json
scripts/fireflies transcripts delete transcript-id --confirm --json

参考资料指引

使用边界

CLI 不会启动 Webhook 服务、存储 API 密钥，也不会臆测未记录的 GraphQL 字段。 如果易用命令无法覆盖所需的当前操作，请使用包含已记录 GraphQL 文档的 query 或 mutation。 通用变更命令仍然需要 --confirm。

评论

支持 Markdown