mcpField
F
fireflies

fireflies

github.com/magnus919生産性15759 回インストール1 日前に更新
リポジトリ

fireflies について

firefliesは、CLI経由でFireflies.aiにアクセスするスキルです。会議の文字起こし確認や関連データの管理に使え、Fireflies GraphQLエンドポイントを直接呼び出します。読み取り専用の調査に対応し、変更は事前確認と明示的な承認を必要とします。

主な機能

  1. 01文字起こし・要約・会議データの検索
  2. 02ユーザー、チャンネル、グループ、連絡先の確認
  3. 03分析データと進行中の会議の取得
  4. 04書き込み内容のプレビューと明示的な承認
  5. 05Webhooks V2署名の検証

活用シーン

  1. 01会議の文字起こしを検索して読む
  2. 02会議分析や進行中の会議を確認
  3. 03AskFredで文字起こしへの質問を作成
  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 のスレッドを 1 件読み取る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
2 段階のファイルアップロードaudio create-upload ... --confirm の後に audio confirm-upload --meeting-id ID --confirm
現在または将来の API 操作をそのまま実行するquery --document GRAPHQL --variables JSON
配信された Webhook をローカルで検証するwebhook 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

参照先の案内

  • 構文、出力、終了コード、汎用 GraphQL の実行については、references/cli-reference.md を参照してください。
  • API モデル、ドキュメントに記載された操作の種類、制限、権限、ソースリンクについては、references/api-reference.md を参照してください。
  • トランスクリプト、分析データ、アップロード、AskFred、汎用操作のレシピについては、references/workflows.md を参照してください。
  • Webhooks V2 を受信または実装する場合は、references/webhook-security.md を参照してください。
  • 認証、GraphQL、制限、権限、ページネーション、Webhook のエラーが発生した場合は、references/troubleshooting.md を参照してください。
  • ソースの対象範囲やドキュメントの最新性を検証する場合は、references/source-index.md を参照してください。

制約事項

CLI は Webhook サーバーを起動せず、API キーを保存せず、ドキュメントに記載されていない GraphQL フィールドを推測しません。 使いやすいコマンドで現在必要な操作をカバーできない場合は、ドキュメントに記載された GraphQL ドキュメントを使って query または mutation を実行してください。汎用の mutation コマンドにも --confirm が必要です。

コメント

Markdown 対応