Back to Details

fathom

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Fathom Meeting Fetcher

Fathom 会议获取工具

Fetches meeting data directly from Fathom API including transcripts, AI summaries, action items, and participant info.
直接从Fathom API获取会议数据，包括转录文本、AI摘要、行动项和参会者信息。

Usage

使用方法

bash
python3 ~/.claude/skills/fathom/scripts/fetch.py [options]
bash
python3 ~/.claude/skills/fathom/scripts/fetch.py [options]

Commands

命令

CommandDescription
--list
List recent meetings with IDs
--id <id>
Fetch specific meeting by recording ID
--today
Fetch all meetings from today
--since <date>
Fetch meetings since date (YYYY-MM-DD)
命令描述
--list
列出带ID的近期会议
--id <id>
根据录制ID获取特定会议
--today
获取今日所有会议
--since <date>
获取指定日期之后的会议（格式：YYYY-MM-DD）

Options

选项

OptionDescription
--analyze
Run transcript-analyzer on fetched meetings
--download-video
Download video recording (requires ffmpeg)
--output <path>
Output directory (default: ~/Brains/brain)
--limit <n>
Max meetings to list (default: 10)
选项描述
--analyze
对获取的会议运行转录文本分析器
--download-video
下载视频录制文件（需要ffmpeg）
--output <path>
输出目录（默认：~/Brains/brain）
--limit <n>
列出会议的最大数量（默认：10）

Examples

示例

List recent meetings

列出近期会议

bash
python3 ~/.claude/skills/fathom/scripts/fetch.py --list
bash
python3 ~/.claude/skills/fathom/scripts/fetch.py --list

Fetch today's meetings

获取今日会议

bash
python3 ~/.claude/skills/fathom/scripts/fetch.py --today
bash
python3 ~/.claude/skills/fathom/scripts/fetch.py --today

Fetch and analyze

获取并分析会议

bash
python3 ~/.claude/skills/fathom/scripts/fetch.py --today --analyze
bash
python3 ~/.claude/skills/fathom/scripts/fetch.py --today --analyze

Fetch since date

获取指定日期后的会议

bash
python3 ~/.claude/skills/fathom/scripts/fetch.py --since 2025-01-01
bash
python3 ~/.claude/skills/fathom/scripts/fetch.py --since 2025-01-01

Fetch specific meeting

获取特定会议

bash
python3 ~/.claude/skills/fathom/scripts/fetch.py --id abc123def456
bash
python3 ~/.claude/skills/fathom/scripts/fetch.py --id abc123def456

Download video with meeting

获取会议并下载视频

bash
python3 ~/.claude/skills/fathom/scripts/fetch.py --id abc123def456 --download-video
bash
python3 ~/.claude/skills/fathom/scripts/fetch.py --id abc123def456 --download-video

Output Format

输出格式

Each meeting is saved as markdown with:
markdown
---
fathom_id: <id>
title: "Meeting Title"
date: YYYY-MM-DD
participants: [list]
duration: HH:MM
fathom_url: <url>
share_url: <url>
---
每个会议会保存为markdown文件，格式如下：
markdown
---
fathom_id: <id>
title: "会议标题"
date: YYYY-MM-DD
participants: [列表]
duration: HH:MM
fathom_url: <链接>
share_url: <链接>
---

Meeting Title

会议标题

Summary

摘要

{AI-generated summary from Fathom}
{来自Fathom的AI生成摘要}

Action Items

行动项

  • Item 1 (@assignee)
  • Item 2
  • 项1 (@负责人)
  • 项2

Transcript

转录文本

Speaker Name: What they said...
undefined
发言者姓名: 发言内容...
undefined

File Naming

文件命名

Files are saved as: 
YYYYMMDD-meeting-title-slug.md
Example: 
20250106-weekly-standup.md
文件命名格式：
YYYYMMDD-meeting-title-slug.md
示例：
20250106-weekly-standup.md

Prerequisites

前置要求

Install dependencies (first time):
bash
pip install requests python-dotenv
For video download (optional):
bash
undefined
安装依赖（首次使用）：
bash
pip install requests python-dotenv
如需下载视频（可选）：
bash
undefined

ffmpeg required for video downloads

视频下载需要ffmpeg

brew install ffmpeg # macOS
brew install ffmpeg # macOS

or apt install ffmpeg (Linux)

或 apt install ffmpeg (Linux)

undefined
undefined

Configuration

配置

API key stored in 
~/.claude/skills/fathom/scripts/.env
:
FATHOM_API_KEY=your-api-key
API密钥存储在
~/.claude/skills/fathom/scripts/.env
中：
FATHOM_API_KEY=your-api-key

Integration

集成

  • transcript-analyzer: Use 
    --analyze
    flag to automatically process transcripts
  • video-downloader: Use 
    --download-video
    flag to download meeting recordings
    • Validates downloaded videos using ffprobe
    • Automatically retries up to 3 times if download fails
    • Videos saved as .mp4 next to meeting markdown files
  • Replaces Dropbox sync workflow (direct API access)
  • transcript-analyzer：使用
    --analyze
    标志自动处理转录文本
  • video-downloader：使用
    --download-video
    标志下载会议录制文件
    • 使用ffprobe验证下载的视频
    • 下载失败时自动重试最多3次
    • 视频保存为.mp4格式，与会议markdown文件放在同一目录
  • 替代Dropbox同步工作流（直接API访问）