Fathom Install & Auth
用途 该技能用于设置 Fathom AI API 访问，以便检索会议转录、摘要和行动项。API 地址为 api.fathom.ai/external/v1，使用 X-Api-Key 请求头认证，采用按用户划分的 API Key。
输出
- 面向目标环境的、限定范围的 Fathom 凭据/集成参考，并带有经过验证的低影响连接测试。
- 一套凭据归属、轮换和撤销路径，用于保护会议内容与联系人。
前置条件
- Fathom 账户（免费或 Team 方案）
- 在设置中启用 API 访问
使用方式 步骤 1：生成 API Key
- 登录 https://fathom.video
- 进入 Settings > Integrations > API Access
- 点击 Generate API Key
- 安全地复制并保存该密钥
export FATHOM_API_KEY="your-api-key-here"
验证密钥是否可用
curl -s -H "X-Api-Key: ${FATHOM_API_KEY}"
https://api.fathom.ai/external/v1/meetings?limit=1 | jq .
步骤 2：配置环境
.env -- 切勿提交
FATHOM_API_KEY=your-api-key FATHOM_BASE_URL=https://api.fathom.ai/external/v1
.gitignore
.env .env.local
步骤 3：测试 API 连通性
列出最近会议
curl -s -H "X-Api-Key: ${FATHOM_API_KEY}"
"https://api.fathom.ai/external/v1/meetings?limit=5"
| jq '.meetings[] | {id: .id, title: .title, date: .created_at}'
步骤 4：OAuth 设置（面向公开应用）
若要构建供他人使用的集成，请在 developers.fathom.ai 注册 OAuth 应用，
以便符合应用市场收录资格
OAuth 应用在列表请求中不能使用 include_transcript 或 include_summary，
请改用单个录制端点
错误处理
- 401 Unauthorized：API Key 无效，在 Settings > API Access 中重新生成。
- 403 Forbidden：密钥缺少访问权限，API Key 可访问你的会议及团队共享内容。
- 429 Too Many Requests：速率限制（60/分钟），需实现退避。
- 会议列表为空：尚无录制内容，请先录制一场会议。
适用场景 适用于需要检索会议转录、摘要和行动项的集成配置，尤其是开发环境凭据配置与连通性验证；公开应用集成可考虑 OAuth 方式。
限制
- OAuth 应用在列表请求中不能使用 include_transcript 或 include_summary，需改用单个录制端点。
- 速率限制为 60/分钟。
- 会议列表为空时需先录制会议。
- 本资料未提供具体收费或价格信息。
下一步 继续使用 fathom-hello-world 检索你的第一份会议转录。