介绍
# Fathom Skill
连接到 [Fathom AI](https://fathom.video) 以获取通话录音、转录文本和摘要。
## 设置
### 1. 获取您的 API 密钥 1. 访问 [developers.fathom.ai](https://developers.fathom.ai) 2. 创建一个 API 密钥 3. 复制该密钥（格式：`v1XDx...`）
### 2. 配置 ```bash # Option A: Store in file (recommended) echo "YOUR_API_KEY" > ~/.fathom_api_key chmod 600 ~/.fathom_api_key
# Option B: Environment variable export FATHOM_API_KEY="YOUR_API_KEY" ```
### 3. 测试连接 ```bash ./scripts/setup.sh ```
---
## 命令
### 列出最近的通话 ```bash ./scripts/list-calls.sh # Last 10 calls ./scripts/list-calls.sh --limit 20 # Last 20 calls ./scripts/list-calls.sh --after 2026-01-01 # Calls after date ./scripts/list-calls.sh --json # Raw JSON output ```
### 获取转录文本 ```bash ./scripts/get-transcript.sh 123456789 # By recording ID ./scripts/get-transcript.sh 123456789 --json ./scripts/get-transcript.sh 123456789 --text-only ```
### 获取摘要 ```bash ./scripts/get-summary.sh 123456789 # By recording ID ./scripts/get-summary.sh 123456789 --json ```
### 搜索通话 ```bash ./scripts/search-calls.sh "product launch" # Search transcripts ./scripts/search-calls.sh --speaker "Lucas" ./scripts/search-calls.sh --after 2026-01-01 --before 2026-01-15 ```
---
## API 参考
| 端点 | 方法 | 描述 | |----------|--------|-------------| | `/meetings` | GET | 列出带有筛选条件的会议 | | `/recordings/{id}/transcript` | GET | 包含演讲者的完整转录文本 | | `/recordings/{id}/summary` | GET | AI 摘要 + 行动项 | | `/webhooks` | POST | 注册 Webhook 以便自动同步 |
**Base URL:** `https://api.fathom.ai/external/v1` **认证:** `X-API-Key` 请求头
---
## list-calls 的筛选条件
| 筛选器 | 描述 | 示例 | |--------|-------------|---------| | `--limit N` | 结果数量 | `--limit 20` | | `--after DATE` | 该日期之后的通话 | `--after 2026-01-01` | | `--before DATE` | 该日期之前的通话 | `--before 2026-01-15` | | `--cursor TOKEN` | 分页游标 | `--cursor eyJo...` |
---
## 输出格式
| 标志 | 描述 | |------|-------------| | `--json` | 来自 API 的原始 JSON | | `--table` | 格式化表格（列表默认格式） | | `--text-only` | 纯文本（仅限转录文本） |
---
## 示例
### 获取您最后一次通话的摘要 ```bash # Get latest call ID CALL_ID=$(./scripts/list-calls.sh --limit 1 --json | jq -r '.[0].recording_id')
# Get summary ./scripts/get-summary.sh $CALL_ID ```
### 导出上周的所有通话 ```bash ./scripts/list-calls.sh --after $(date -d '7 days ago' +%Y-%m-%d) --json > last_week_calls.json ```
### 查找提及特定主题的通话 ```bash ./scripts/search-calls.sh "quarterly review" ```
---
## 故障排除
| 错误 | 解决方案 | |-------|----------| | "No API key found" | 运行设置命令或设置 `FATHOM_API_KEY` | | "401 Unauthorized" | 检查 API 密钥是否有效 | | "429 Rate Limited" | 等待后重试 | | "Recording not found" | 验证录音 ID 是否存在 |
---
## Webhook 设置（高级）
如需自动接收转录文本，请参阅 Webhook 设置指南： ```bash ./scripts/setup-webhook.sh --url https://your-endpoint.com/webhook ```
需要一个公开可访问的 HTTPS 端点。