fathom

用途

Fathom 技能用于连接 Fathom AI 服务，获取通话录音、转写文本和摘要。当用户询问其会议记录、通话历史，或需要搜索过往通话内容时，可以使用该技能。

主要能力

列出近期通话：支持按数量、日期范围筛选。
获取转写文本：通过录音 ID 获取完整转写，支持包含说话人信息。
获取摘要：通过录音 ID 获取 AI 生成的摘要与行动项。
搜索通话：支持按主题内容、发言人、日期范围搜索转写文本。

使用方式

获取 API 密钥

访问 developers.fathom.ai
创建 API 密钥
复制密钥（格式：v1XDx...）

配置

方式 A：存入文件（推荐）

echo "YOUR_API_KEY" > ~/.fathom_api_key
chmod 600 ~/.fathom_api_key

方式 B：环境变量

export FATHOM_API_KEY="YOUR_API_KEY"

测试连接

./scripts/setup.sh

命令

列出近期通话：

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

获取转写文本：

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

获取摘要：

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

搜索通话：

./scripts/search-calls.sh "product launch" # 搜索转写文本
./scripts/search-calls.sh --speaker "Lucas"
./scripts/search-calls.sh --after 2026-01-01 --before 2026-01-15

API 参考

基础 URL：https://api.fathom.ai/external/v1

认证方式：X-API-Key 请求头

端点	方法	说明
/meetings	GET	带筛选条件列出会议
/recordings/{id}/transcript	GET	含说话人的完整转写
/recordings/{id}/summary	GET	AI 摘要 + 行动项
/webhooks	POST	注册 webhook 以自动同步

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	纯文本（仅转写）

示例

获取最近一次通话的摘要：

# 获取最新的通话 ID
CALL_ID=$(./scripts/list-calls.sh --limit 1 --json | jq -r '.[0].recording_id')

# 获取摘要
./scripts/get-summary.sh $CALL_ID

导出上周所有通话：

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

查找提及某主题的通话：

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

故障排查

错误	解决方案
"No API key found"	运行 setup 或设置 FATHOM_API_KEY
"401 Unauthorized"	检查 API 密钥是否有效
"429 Rate Limited"	等待后重试
"Recording not found"	确认录音 ID 存在

Webhook 设置（高级）

如需自动导入转写文本，参见 webhook 设置指南：

./scripts/setup-webhook.sh --url https://your-endpoint.com/webhook

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

适用场景

适用于需要查询、检索或导出 Fathom AI 通话记录的会议与通话历史场景，包括获取单次通话的转写与摘要、批量导出指定时间段内的通话、按主题或发言人检索通话内容。

限制

使用前必须拥有 Fathom AI 账户并获取 API 密钥。Webhook 自动同步需要一个公开可访问的 HTTPS 端点。其他限制暂未提供。