transcript-search

文字起こしの検索

概要

Fireflies.ai と Google Drive から、全文と話者情報を含む会議の文字起こしを検索・取得します。

クイック判断ツリー

Where are your transcripts?
│
├── Fireflies.ai (API)
│   └── references/fireflies.md
│   └── Script: scripts/fireflies_transcript_search.py
│
└── Google Drive (uploaded files)
    └── references/drive-transcripts.md
    └── Script: scripts/gdrive_transcript_search.py

環境設定

# For Fireflies
FIREFLIES_API_KEY=your_api_key

# For Google Drive
# OAuth credentials (mycreds.txt) - see google-workspace skill

Fireflies API キーを取得します：https://app.fireflies.ai/integrations（Custom Integrations）

一般的な使い方

会社名で Fireflies を検索

python scripts/fireflies_transcript_search.py "Microsoft" --days-back 30

文字起こし全文を取得

python scripts/fireflies_transcript_search.py --id 01KCM2G0YX1GMPWYQ8GPAABBCK --content

書式付きの文字起こしを保存

python scripts/fireflies_transcript_search.py --id abc123 --content --save transcript.md

Drive の文字起こしを検索

python scripts/gdrive_transcript_search.py "Acme Corp" --days 30

出力形式

検索結果

• 文字起こし ID、タイトル、日付、所要時間
• AI が生成した要約、キーワード、アクションアイテム
• 氏名を含む話者リスト

文字起こし全文

• 話者ラベル付きの全文
• 各文のタイムスタンプ
• 書式設定された Markdown 出力

費用

サービス	費用
Fireflies API	無料（サブスクリプション利用時）
Google Drive	無料

セキュリティに関する注意事項

認証情報の取り扱い

• FIREFLIES_API_KEY は .env ファイルに保存します（Git に絶対にコミットしないでください）
• Drive 用の Google OAuth 認証情報（google-workspace スキルを参照）
• 漏洩した場合は、Custom Integrations から Fireflies API キーを再生成します
• スクリプトの出力に API キーを記録または表示しないでください

データのプライバシー

• 文字起こしには、会議での会話が逐語的に含まれます
• 話者の氏名や声から個人を特定できます
• 業務上の話し合いには、機密情報が含まれる場合があります
• アクションアイテムや要約には、機密性の高い決定事項が記録されます
• 許可なく文字起こし全文を共有しないでください

アクセス範囲

• Fireflies API：ユーザーがアクセスできる文字起こしすべてへのフルアクセス
• Google Drive：アップロードされた文字起こしファイルへのアクセス
• 文字起こしには、会議参加者のアクセス権限が適用されます

コンプライアンスに関する考慮事項

• 録音への同意：会議の参加者全員から録音への同意を得てください
• 話者のプライバシー：文字起こしでは話者が氏名で特定されます
• 機密会議：文字起こしを作成すべきでない会議もあります
• GDPR：EU の参加者を含む会議の録音には同意が必要です
• データ保持：文字起こしの保持・削除に関するポリシーに従ってください
• リーガルホールド：文字起こしが法的開示の対象となる場合があります
• クライアントの機密保持：クライアントとの会議内容は機密情報です
• 社内利用限定：必要に応じて、文字起こしに機密である旨を明記してください

トラブルシューティング

よくある問題

問題：文字起こしが見つからない

症状： 実際に会議があるにもかかわらず、「Transcript not found」エラーが表示される 原因： 文字起こし ID が無効、アクセス権がない、または処理がまだ完了していない 解決方法：

• Fireflies ダッシュボードで文字起こし ID を確認します
• 録音がまだ処理中か確認します（待ってから再試行してください）
• API キーに文字起こしへのアクセス権があることを確認します
• 会議が実際に録音され、文字起こしが作成されたことを確認します

問題：API の認証に失敗する

症状： 401 エラー、または「invalid API key」と表示される 原因： API キーの有効期限切れ、無効、または未設定 解決方法：

• https://app.fireflies.ai/integrations で API キーを再生成します
• .env で FIREFLIES_API_KEY が正しく設定されていることを確認します
• キーの前後に空白がないか確認します
• Fireflies で Custom Integration が有効になっていることを確認します

問題：検索結果が空

症状： 会議が存在するにもかかわらず、検索で文字起こしが見つからない 原因： 検索クエリの範囲が狭すぎる、日付範囲の問題、またはアクセス制限 解決方法：

• 検索クエリの範囲を広げます（キーワードを減らします）
• --days-back パラメーターで日付範囲を広げます
• 文字起こしが自分のアカウントと共有されているか確認します
• 正しいフィールド（タイトル、参加者、内容）を検索していることを確認します

問題：文字起こしの内容が欠落している

症状： メタデータは返されるが、全文が空 原因： 文字起こしの処理中、または内容へのアクセスが制限されている 解決方法：

• 文字起こしの処理が完了するまで待ちます（Fireflies ダッシュボードで確認してください）
• --content フラグを明示的に使用して、文字起こし全文をリクエストします
• サブスクリプションのプランに API 経由のコンテンツアクセスが含まれていることを確認します
• 文字起こしに処理エラーがないか確認します

問題：話者の識別情報が表示されない

症状： 文字起こしテキストはあるものの、話者が識別されていない 原因： 音声品質が低い、または話者が登録されていない 解決策：

• 話者の識別は音声品質に左右されます
• 認識精度を高めるため、よく話す人を Fireflies に登録します
• これは API の問題ではなく、Fireflies の処理に関する問題です
• 可能であれば、音質を改善して録音を再アップロードします

問題：Google Drive の文字起こし検索に失敗する

症状： Drive に保存された文字起こしを見つけられない 原因： OAuth の問題、フォルダー構成、またはファイル形式 解決策：

• Google OAuth が機能していることを確認します（google-workspace スキルを参照）
• 文字起こしが検索可能なフォルダーにあることを確認します
• 文字起こしが読み取り可能な形式（txt、md、docx）であることを確認します
• 全文検索に失敗する場合は、正確なファイル名で検索します

リソース

• references/fireflies.md - Fireflies.ai API ガイド
• references/drive-transcripts.md - Drive の文字起こし検索

連携パターン

文字起こしから要約を作成

スキル： transcript-search → content-generation ユースケース： 会議の要約とアクションアイテムのドキュメントを作成する フロー：

1. Fireflies から文字起こし全体を取得します
2. 重要な議論のポイントと決定事項を抽出します
3. content-generation を使って、書式を整えた要約ドキュメントを作成します

文字起こしから音声エージェントを作成

スキル： transcript-search → voice-agents ユースケース： コンテキストを認識する音声エージェントを構築する フロー：

1. クライアントとの過去の会議を検索します
2. 関係の履歴とこれまでの議論を抽出します
3. パーソナライズされた通話を実現するため、コンテキストを音声エージェントのプロンプトに含めます

文字起こしから CRM に登録

スキル： transcript-search → attio-crm ユースケース： 会議メモを CRM レコードに追加する フロー：

1. クライアントとの会議の文字起こしを検索します
2. 要約、アクションアイテム、重要な引用を抽出します
3. 会議の詳細を記載したメモを Attio の会社レコードに作成します