Transcript Search

Overview

Quick Decision Tree

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

Environment Setup

# For Fireflies
FIREFLIES_API_KEY=your_api_key

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

Common Usage

Search Fireflies by Company

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

Get Full Transcript

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

Save Formatted Transcript

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

Search Drive Transcripts

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

Output Formats

Search Results

• Transcript ID, title, date, duration
• AI-generated summary, keywords, action items
• Speaker list with names

Full Transcript

• Complete text with speaker labels
• Timestamps for each sentence
• Formatted markdown output

Cost

Security Notes

Credential Handling

• Store

  FIREFLIES_API_KEY

  in

  .env

  file (never commit to git)
• Google OAuth credentials for Drive (see google-workspace skill)
• Regenerate Fireflies API key via Custom Integrations if compromised
• Never log or print API keys in script output

Data Privacy

• Transcripts contain verbatim meeting conversations
• Speaker names and voices are identifiable
• Business discussions may include confidential information
• Action items and summaries capture sensitive decisions
• Avoid sharing full transcripts without authorization

Access Scopes

• Fireflies API: Full access to transcripts user has access to
• Google Drive: Access to uploaded transcript files
• Transcripts inherit meeting participants' access permissions

Compliance Considerations

• Recording Consent: Ensure all meeting participants consent to recording
• Speaker Privacy: Transcripts identify speakers by name
• Confidential Meetings: Some meetings should not be transcribed
• GDPR: Meeting recordings containing EU participants require consent
• Data Retention: Follow policies for transcript retention/deletion
• Legal Holds: Transcripts may be subject to legal discovery
• Client Confidentiality: Client meeting content is sensitive
• Internal Use Only: Mark transcripts as confidential where appropriate

Troubleshooting

Common Issues

Issue: Transcript not found

• Verify transcript ID from Fireflies dashboard
• Check if recording is still processing (wait and retry)
• Ensure API key has access to the transcript
• Confirm meeting was actually recorded and transcribed

Issue: API unauthorized

• Regenerate API key at https://app.fireflies.ai/integrations
• Verify

  FIREFLIES_API_KEY

  is set correctly in

  .env

• Check for leading/trailing whitespace in key
• Ensure Custom Integration is enabled in Fireflies

Issue: Empty search results

• Broaden search query (fewer keywords)
• Expand date range with

  --days-back

  parameter
• Check if transcripts are shared with your account
• Verify search is using correct field (title, participants, content)

Issue: Missing transcript content

• Wait for transcript processing to complete (check Fireflies dashboard)
• Use

  --content

  flag explicitly to request full transcript
• Verify subscription tier includes API content access
• Check if transcript has processing errors

Issue: Speaker attribution missing

• Speaker identification depends on audio quality
• Enroll frequent speakers in Fireflies for better recognition
• This is a Fireflies processing issue, not API issue
• Re-upload recording if possible with better audio

Issue: Google Drive transcript search fails

• Verify Google OAuth is working (see google-workspace skill)
• Check transcripts are in searchable folder
• Ensure transcripts are in readable format (txt, md, docx)
• Search by exact filename if full-text search fails

Resources

• references/fireflies.md - Fireflies.ai API guide
• references/drive-transcripts.md - Drive transcript search

Integration Patterns

Transcript to Summary

1. Retrieve full transcript from Fireflies
2. Extract key discussion points and decisions
3. Generate formatted summary document via content-generation

Transcript to Voice Agent

1. Search for past meetings with client
2. Extract relationship history and previous discussions
3. Include context in voice agent prompt for personalized calls

Transcript to CRM

1. Search transcripts for client meetings
2. Extract summary, action items, and key quotes
3. Create note on Attio company record with meeting details