pp-fireflies

Fireflies.ai — Printing Press CLI

前提条件：CLI をインストールする

このスキルは fireflies-pp-cli バイナリを使用します。**このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。**見つからない場合は、先にインストールしてください。

1. Printing Press インストーラーを使用してインストールします。バイナリの既定のインストール先は、macOS/Linux では $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin です。

   npx -y @mvanhorn/printing-press-library install fireflies --cli-only
   

2. 確認します：fireflies-pp-cli --version
3. このスキルを実行するエージェント／ランタイムの $PATH に、表示されたインストールディレクトリが含まれていることを確認します。

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go による直接インストールに切り替えてください（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/productivity/fireflies/cmd/fireflies-pp-cli@latest

インストール後に --version で「command not found」と表示される場合、ランタイムからバイナリのディレクトリを $PATH 経由で参照できません。確認が成功するまで、このスキルのコマンドを実行しないでください。

この CLI を使用する場面

会議履歴を大規模に調べる必要がある場合は、fireflies-pp-cli を使用してください。たとえば、対応漏れのアクションアイテムの発見、関係性の全体像を把握してから通話に臨むこと、数週間にわたる感情やトピックの傾向の追跡、数千件の会議発言のオフライン検索などに役立ちます。日々の録音設定やメモ取りには、Fireflies ダッシュボードを使用してください。

独自の機能

この API のほかのツールでは利用できない機能です。

蓄積されていくローカル状態

• transcripts search — API クォータを消費せず、同期済みのすべての会議トランスクリプトを全文検索します。

  レート制限のある API 呼び出しを消費せずに、特定のトピックがすべての会議で言及された箇所を見つける場合に使用します。

  fireflies-pp-cli transcripts search "pricing objection" --agent --select id,title,dateString
  

• action-items list — 期間内のすべての会議からアクションアイテムを集約します。週ごとのコミットメント監査を 1 つのコマンドで実行できます。

  週末に、会議で交わされたすべてのコミットメントを抽出して TODO ファイルに追加する場合に使用します。

  fireflies-pp-cli action-items list --from 7 --agent
  

• transcripts find — 参加者のメールアドレス、チャンネル名、キーワード、日付範囲で会議を検索します。すべてクライアント側で処理されるため、API の日付フィルターの不具合を回避できます。

  特定の人物やチャンネルとの会議が必要な場合に使用します。API のタイトルベース検索では、会議名に参加者名が含まれていないと検索に失敗します。

  fireflies-pp-cli transcripts find --participant [email protected] --from 30 --processed-only --agent
  

• transcripts status — 最近の会議の PROCESSED／PROCESSING／FAILED ステータスを先に表示するため、取得前に状況を把握できます。

  当日や翌朝の会議を取得する場合に使用します。「会議の準備がまだできていない」というエラーを繰り返す事態を避けられます。

  fireflies-pp-cli transcripts status --since 48h --agent
  

• topics list — 期間内のすべての会議で頻出するトピックを表示し、実際に会議時間を費やしている内容を把握できます。

  四半期計画の際に、どこに時間を投資するかを決める前に、繰り返し取り上げられるテーマを特定する場合に使用します。

  fireflies-pp-cli topics list --from 30 --top 15 --agent
  

• digest — 最近のすべての会議について、タイトル、概要、トピック、アクションアイテムを 1 つの構造化された出力にまとめて表示します。

  セッションの開始時や朝の cron ジョブで、行動を起こす前に前日に起きたことを把握する場合に使用します。

  fireflies-pp-cli digest --since 24h --agent
  

• transcripts export — トランスクリプトを Markdown として保管用ディレクトリにエクスポートします。ファイル名は YYYY-MM-DD_title.md の形式で自動生成されます。または、--output（-o）かそのエイリアスである --file を使って、明示的なファイルパスにエクスポートできます。

  クライアントとの会議後に、整形済みのトランスクリプトを適切なプロジェクトフォルダーに直接保存する場合に使用します。

  fireflies-pp-cli transcripts export abc123 --vault ~/vaults/VBT/Projects/1_Active/Ryder/transcripts/ --agent
  fireflies-pp-cli transcripts export abc123 --file /tmp/dennis_1on1.md --agent
  

人物を中心としたインテリジェンス

• person timeline — 特定の人物との会議履歴を時系列で表示します。会議ごとのトピック、アクションアイテム、発話比率を確認できます。

  QBR や更新に関する通話の前に、すべてのトランスクリプトを読むことなく、関係性の全体的な経緯を把握する場合に使用します。

  fireflies-pp-cli person timeline [email protected] --from 90 --agent
  

コマンドリファレンス

sync — API データをローカルの SQLite に同期します

• fireflies-pp-cli sync — 議事録、チャンネル、ユーザーをローカルの SQLite に同期します
• fireflies-pp-cli sync --full — 最初から完全に再同期します
• fireflies-pp-cli sync --resources transcripts,channels — 指定したリソースを同期します

transcripts — 会議の議事録を一覧表示、検索、管理します

• fireflies-pp-cli transcripts list — ローカルストアの議事録を一覧表示します
• fireflies-pp-cli transcripts get <id> — ローカルストア（または --live を指定した場合は API）から議事録を取得します
• fireflies-pp-cli transcripts find — 参加者、チャンネル、キーワード、または日付で検索します
• fireflies-pp-cli transcripts search <query> — オフラインで全文検索します
• fireflies-pp-cli transcripts recent — 最近処理された議事録を表示します
• fireflies-pp-cli transcripts status — PROCESSED / PROCESSING / FAILED のステータスを表示します
• fireflies-pp-cli transcripts pull <id> — API から議事録全文を取得し、ローカルに保存します
• fireflies-pp-cli transcripts export <id> — Markdown としてファイル（--output/-o/--file）または vault パスにエクスポートします
• fireflies-pp-cli transcripts update <id> — タイトルまたはプライバシー設定を更新します
• fireflies-pp-cli transcripts share <id> — 外部のメールアドレスと共有します
• fireflies-pp-cli transcripts delete <id> — 議事録を削除します

summary — AI が生成する会議の要約

• fireflies-pp-cli summary <id> — 要約を取得します（形式：overview、bullets、gist、topics、keywords、actions）

action-items — アクションアイテムを抽出します

• fireflies-pp-cli action-items get <id> — 特定の議事録からアクションアイテムを取得します
• fireflies-pp-cli action-items list — 日付範囲内のアクションアイテムを集約します

topics — トピックを抽出して分析します

• fireflies-pp-cli topics get <id> — 特定の議事録からトピックを取得します
• fireflies-pp-cli topics list — すべての議事録で最も頻出するトピックを表示します

keywords — AI が抽出したキーワード

• fireflies-pp-cli keywords <id> — 議事録のキーワードを取得します

speakers — 話者ごとの分析

• fireflies-pp-cli speakers <id> — 話者ごとの発話時間、単語数、フィラーワード、質問数を表示します

analytics — 会議分析

• fireflies-pp-cli analytics team — チーム全体の分析を行います（Business+ プランが必要です）
• fireflies-pp-cli analytics meeting <id> — 会議ごとの話者分析を行います

person — 人物を中心とした表示

• fireflies-pp-cli person timeline <email-or-name> — 特定の人物との会議履歴を時系列で表示します
• fireflies-pp-cli person complaints <email-or-name> — 会議全体から否定的な感情の言及を抽出します

digest — 会議内容をまとめたブリーフィング

• fireflies-pp-cli digest — 最近のすべての会議の要約をまとめて表示します

channels — チャンネル管理

• fireflies-pp-cli channels <id> — チャンネルを1件取得します

users — ユーザー管理

• fireflies-pp-cli users — ユーザー情報を取得します

適切なコマンドを見つける

実行したいことはわかっていても、どのコマンドを使えばよいかわからない場合は、CLI に直接問い合わせてください。

fireflies-pp-cli which "<capability in your own words>"

which は、自然言語による機能の問い合わせを、この CLI の厳選された機能インデックスから最も適したコマンドに対応付けます。終了コード 0 は少なくとも1件の一致があることを示し、終了コード 2 は確実な一致がないことを示します。その場合は --help を使うか、より絞り込んだ問い合わせをしてください。

レシピ

朝のトリアージ：昨日の会議で何があったか

fireflies-pp-cli transcripts list --from 24h --agent --select id,title,dateString,duration,summary.gist

昨日の会議を1行の AI 要約付きで一覧表示します。すでに同期済みの場合、API 呼び出しはありません。

クライアントが価格について言及した場面をすべて見つける

fireflies-pp-cli search "pricing" --from 90d --agent --select id,title,speaker_name,text

同期済みの発言を全文検索します。--select のドット区切りパスで、ネストされたフィールドを指定できます。

アカウント履歴を確認して QBR の準備をする

fireflies-pp-cli person timeline "Acme" --from 180 --agent

「Acme」が登場したすべての会議を時系列で表示します。トピック、アクションアイテム、発話比率も確認できます。

今週のアクションアイテムを集める

fireflies-pp-cli action-items list --from 7 --append ~/vaults/VBT/TODO.md

過去7日間のすべての会議からアクションアイテムを集約し、Markdown の TODO ファイルに追記します。

今月最も多く取り上げられたトピックを見つける

fireflies-pp-cli topics list --from 30 --top 15 --agent

過去30日間のすべての会議で頻出したトピックを表示します。実際に会議時間を費やしている内容がわかります。

認証の設定

FIREFLIES_API_KEY として設定された Fireflies API キーが必要です。API にアクセスするには、Business プラン以上が必要です。キーは app.fireflies.ai → Settings → Developer で取得してください。

fireflies-pp-cli doctor を実行して、設定を確認します。

エージェントモード

任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ可能 — stdout に JSON、stderr にエラーを出力します

• フィルター可能 — --select でフィールドを絞り込みます。ドット区切りのパスはネストされた構造をたどり、配列は要素ごとにたどります。出力が冗長な API でコンテキストを小さく保つために重要です：

  fireflies-pp-cli transcripts list --agent --select id,title,dateString,summary.gist
  

• プレビュー可能 — --dry-run でリクエストを送信せずに表示します

• オフライン対応 — 同期／検索コマンドでは、利用可能な場合にローカルの SQLite ストアを使用できます

• 非対話型 — プロンプトは表示されず、すべての入力はフラグで指定します

• 明示的な再試行 — 既存の作成が成功として扱われる場合に限り --idempotent を使用し、削除対象が存在しない場合に成功として扱われる場合に限り --ignore-missing を使用します

レスポンスエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力をデータの出所を示すエンベロープで包みます：

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を解析し、ライブデータかローカルデータかを確認するには .meta.source を参照します。人が読みやすい N results (live) の概要は、stdout がターミナルの場合にのみ stderr に出力されます。パイプ／エージェントの利用者には、stdout に純粋な JSON が出力されます。

エージェントからのフィードバック

この CLI で気になる点に気づいた場合は（エージェントが気づいた場合も）、記録してください：

fireflies-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
fireflies-pp-cli feedback --stdin < notes.txt
fireflies-pp-cli feedback list --json --limit 10

エントリーは ~/.fireflies-pp-cli/feedback.jsonl にローカル保存されます。FIREFLIES_FEEDBACK_ENDPOINT が設定され、かつ --send が渡された場合、または FIREFLIES_FEEDBACK_AUTO_SEND=true の場合を除き、POST されることはありません。デフォルトの動作はローカルのみです。

バグ報告ではなく、意外に感じたことを書いてください。簡潔で具体的な一行にします。それが積み重なって役立ちます。

出力の送信先

すべてのコマンドで --deliver <sink> を指定できます。エージェントがコマンド結果を手動でパイプせずに振り分けられるよう、出力は stdout に加えて（または stdout の代わりに）指定された送信先に送られます。対応している送信先は 3 種類です：

送信先	動作
stdout	デフォルト。stdout のみに書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（tmp + rename）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、対応しているスキームの一覧を示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードが返され、URL と HTTP ステータスが stderr に記録されます。

名前付きプロファイル

プロファイルは、保存されたフラグ値のセットで、複数回の実行で再利用できます。スケジュールされたエージェントが同じ設定で毎回同じコマンドを呼び出す場合に使用します。これは HeyGen の「Beacon」パターンです。

fireflies-pp-cli profile save briefing --json
fireflies-pp-cli --profile briefing transcripts list
fireflies-pp-cli profile list --json
fireflies-pp-cli profile show briefing
fireflies-pp-cli profile delete briefing --yes

明示的に指定したフラグは常にプロファイル値より優先され、プロファイル値はデフォルト値より優先されます。agent-context は、利用可能なすべてのプロファイルを available_profiles に一覧表示するため、情報を調べるエージェントは実行時にそれらを検出できます。

終了コード

コード	意味
0	成功
2	使用方法エラー（引数が正しくありません）
3	リソースが見つかりません
4	認証が必要です
5	API エラー（上流の問題）
7	レート制限中（待ってから再試行してください）
10	設定エラー

引数の解析

$ARGUMENTS を解析します：

1. 空、help、または --help → fireflies-pp-cli --help の出力を表示
2. install で始まる → mcp で終わる場合は MCP のインストール。それ以外の場合は上記の前提条件を参照
3. その他すべて → 直接使用（CLI コマンドとして --agent を付けて実行）

MCP サーバーのインストール

1. MCP サーバーをインストールします：

   go install github.com/mvanhorn/printing-press-library/library/productivity/fireflies/cmd/fireflies-pp-mcp@latest
   

2. Claude Code に登録します：

   claude mcp add fireflies-pp-mcp -- fireflies-pp-mcp
   

3. 確認します：claude mcp list

直接使用

1. インストールされているか確認します：which fireflies-pp-cli 見つからない場合は、インストールを提案します（このスキルの冒頭にある前提条件を参照してください）。
2. ユーザーのクエリに最適なコマンドを、上記の独自機能とコマンドリファレンスから選びます。
3. --agent フラグを付けて実行します：

   fireflies-pp-cli <command> [subcommand] [args] --agent
   

4. 曖昧な場合は、サブコマンドのヘルプを確認します：fireflies-pp-cli <command> --help。