会议转录本搜索工具 - 支持Fireflies.ai与Google Drive全文检索，带发言人归属

transcript-search by casper-studios/casper-marketplace

139 周安装量

10 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/casper-studios/casper-marketplace --skill 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 (自定义集成)

常用用法

按公司搜索 Fireflies

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

获取完整转录本

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

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

保存格式化转录本

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)
Google Drive 的 OAuth 凭据 (参见 google-workspace 技能)
如果 Fireflies API 密钥泄露，请通过自定义集成重新生成
切勿在脚本输出中记录或打印 API 密钥

转录本包含逐字记录的会议对话
发言人姓名和声音是可识别的
业务讨论可能包含机密信息
行动项和摘要可能包含敏感决策
未经授权，避免共享完整转录本

Fireflies API: 对用户有权访问的转录本拥有完全访问权限
Google Drive: 访问已上传的转录本文件
转录本继承会议参与者的访问权限

录音同意 : 确保所有会议参与者同意录音
发言人隐私 : 转录本通过姓名识别发言人
机密会议 : 某些会议不应被转录
GDPR : 包含欧盟参与者的会议录音需要获得同意
数据保留 : 遵循转录本保留/删除政策
法律保留 : 转录本可能受法律取证约束
客户机密性 : 客户会议内容是敏感的
仅限内部使用 : 在适当时将转录本标记为机密

问题：未找到转录本

症状: 已知会议出现 "Transcript not found" 错误 原因: 无效的转录本 ID、无访问权限或尚未处理 解决方案:

从 Fireflies 仪表板验证转录本 ID
检查录音是否仍在处理中 (等待并重试)
确保 API 密钥有权访问该转录本
确认会议确实被录制和转录

问题：API 未授权

症状: 401 错误或 "invalid API key" 原因: API 密钥过期、无效或未设置 解决方案:

在 https://app.fireflies.ai/integrations 重新生成 API 密钥
验证 .env 文件中 FIREFLIES_API_KEY 设置正确
检查密钥中是否有前导/尾随空格
确保 Fireflies 中已启用自定义集成

问题：搜索结果为空

症状: 尽管存在会议，但搜索未返回任何转录本 原因: 搜索查询过窄、日期范围问题或访问限制 解决方案:

扩大搜索查询范围 (减少关键词)
使用 --days-back 参数扩大日期范围
检查转录本是否已与您的账户共享
验证搜索使用的是正确的字段 (标题、参与者、内容)

问题：缺少转录本内容

症状: 返回元数据但完整内容为空 原因: 转录本仍在处理中或内容访问受限 解决方案:

等待转录本处理完成 (检查 Fireflies 仪表板)
明确使用 --content 标志请求完整转录本
验证订阅级别是否包含 API 内容访问权限
检查转录本是否存在处理错误

问题：缺少发言人归属

症状: 存在转录文本但未识别发言人 原因: 音频质量差或发言人未注册 解决方案:

发言人识别取决于音频质量
在 Fireflies 中注册常用发言人以提高识别率
这是 Fireflies 处理问题，而非 API 问题
如果可能，使用更好的音频重新上传录音

问题：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 用例: 创建会议摘要和行动项文档 流程:

从 Fireflies 检索完整转录本
提取关键讨论点和决策
通过 content-generation 生成格式化的摘要文档

转录本转语音助手

技能: transcript-search → voice-agents 用例: 构建上下文感知的语音助手 流程:

搜索与客户的过往会议
提取关系历史和先前讨论内容
将上下文包含在语音助手提示中，以实现个性化通话

技能: transcript-search → attio-crm 用例: 将会议记录添加到 CRM 记录中 流程:

搜索客户会议的转录本
提取摘要、行动项和关键引述
在 Attio 公司记录上创建包含会议详情的备注

🇺🇸English

Transcript Search

Overview

Search and retrieve meeting transcripts from Fireflies.ai and Google Drive with full text and speaker attribution.

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

Get Fireflies API key: https://app.fireflies.ai/integrations (Custom Integrations)

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

Service	Cost
Fireflies API	Free (with subscription)
Google Drive	Free

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

Symptoms: "Transcript not found" error with known meeting Cause: Invalid transcript ID, no access, or not yet processed Solution:

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

Symptoms: 401 error or "invalid API key" Cause: API key expired, invalid, or not set Solution:

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

Symptoms: Search returns no transcripts despite existing meetings Cause: Search query too narrow, date range issue, or access restrictions Solution:

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

Symptoms: Metadata returned but full content is empty Cause: Transcript still processing or content access restricted Solution:

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

Symptoms: Transcript text present but speakers not identified Cause: Low audio quality or speakers not enrolled Solution:

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

Symptoms: Can't find transcripts stored in Drive Cause: OAuth issue, folder structure, or file format Solution:

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

Skills: transcript-search → content-generation Use case: Create meeting summaries and action item docs Flow:

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

Transcript to Voice Agent

Skills: transcript-search → voice-agents Use case: Build context-aware voice agents Flow:

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

Transcript to CRM

Skills: transcript-search → attio-crm Use case: Add meeting notes to CRM records Flow:

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

Weekly Installs

Repository

casper-studios/…ketplace

GitHub Stars

First Seen

Feb 24, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

cline97

github-copilot97

codex97

kimi-cli97

gemini-cli97

cursor97

Python PDF处理教程：合并拆分、提取文本表格、创建PDF文件

61,100 周安装