./scripts/setup.sh

./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

./scripts/search-calls.sh "quarterly review"

Fathom 技能

连接至 Fathom AI 以获取通话录音、转录文本和摘要。

设置

1. 获取 API 密钥

1. 1. 访问 developers.fathom.ai
2. 创建一个 API 密钥
3. 复制密钥（格式：v1XDx...）

2. 配置

bash

选项 A：存储在文件中（推荐）

echo 你的 API 密钥 > ~/.fathomapikey chmod 600 ~/.fathomapikey

选项 B：环境变量

export FATHOMAPIKEY=你的 API 密钥

3. 测试连接

bash ./scripts/setup.sh

---

命令

列出近期通话

bash ./scripts/list-calls.sh # 最近 10 次通话 ./scripts/list-calls.sh --limit 20 # 最近 20 次通话 ./scripts/list-calls.sh --after 2026-01-01 # 指定日期后的通话 ./scripts/list-calls.sh --json # 原始 JSON 输出

获取转录文本

bash ./scripts/get-transcript.sh 123456789 # 按录音 ID ./scripts/get-transcript.sh 123456789 --json ./scripts/get-transcript.sh 123456789 --text-only

获取摘要

bash ./scripts/get-summary.sh 123456789 # 按录音 ID ./scripts/get-summary.sh 123456789 --json

搜索通话

bash ./scripts/search-calls.sh 产品发布 # 搜索转录文本 ./scripts/search-calls.sh --speaker 卢卡斯 ./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 |

基础 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

获取最新通话 ID

CALLID=$(./scripts/list-calls.sh --limit 1 --json | jq -r .[0].recordingid)

获取摘要

./scripts/get-summary.sh $CALL_ID

导出上周所有通话

bash ./scripts/list-calls.sh --after $(date -d 7 days ago +%Y-%m-%d) --json > lastweekcalls.json

查找提及特定话题的通话

bash ./scripts/search-calls.sh 季度回顾

---

故障排除

错误	解决方案
未找到 API 密钥	运行设置或设置 FATHOMAPIKEY
401 未授权

检查 API 密钥是否有效 | | 429 请求频率限制 | 等待后重试 | | 未找到录音 | 确认录音 ID 存在 |

---

Webhook 设置（高级）

如需自动摄取转录文本，请参阅 Webhook 设置指南：
bash
./scripts/setup-webhook.sh --url https://你的端点.com/webhook

需要一个可公开访问的 HTTPS 端点。