fathom

Fathom Meeting Fetcher

Fathom API から会議データを直接取得します。トランスクリプト、AI による要約、アクションアイテム、参加者情報が含まれます。

使用方法

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

コマンド

コマンド	説明
--list	最近の会議を ID とともに一覧表示します
--id <id>	録画 ID を指定して特定の会議を取得します
--today	今日の会議をすべて取得します
--since <date>	指定した日付以降の会議を取得します（YYYY-MM-DD）

オプション

オプション	説明
--analyze	取得した会議に対して transcript-analyzer を実行します
--download-video	録画動画をダウンロードします（ffmpeg が必要です）
--output <path>	出力ディレクトリ（デフォルト：~/Brains/brain）
--limit <n>	一覧表示する会議の最大数（デフォルト：10）

使用例

最近の会議を一覧表示する

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

今日の会議を取得する

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

取得して分析する

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

指定した日付以降の会議を取得する

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

特定の会議を取得する

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

会議の動画をダウンロードする

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

出力形式

各会議は次の内容を含む Markdown ファイルとして保存されます。

---
fathom_id: <id>
title: "Meeting Title"
date: YYYY-MM-DD
participants: [list]
duration: HH:MM
fathom_url: <url>
share_url: <url>
---

# Meeting Title

## Summary
{AI-generated summary from Fathom}

## Action Items
- [ ] Item 1 (@assignee)
- [ ] Item 2

## Transcript
**Speaker Name**: What they said...

ファイル名

ファイルは次の名前で保存されます：YYYYMMDD-meeting-title-slug.md

例：20250106-weekly-standup.md

前提条件

依存関係をインストールします（初回のみ）。

pip install requests python-dotenv

動画をダウンロードする場合（任意）：

# ffmpeg required for video downloads
brew install ffmpeg  # macOS
# or apt install ffmpeg (Linux)

設定

API キーは ~/.claude/skills/fathom/scripts/.env に保存されています。

FATHOM_API_KEY=your-api-key

連携

• transcript-analyzer：--analyze フラグを使用すると、トランスクリプトを自動的に処理します
• video-downloader：--download-video フラグを使用すると、会議の録画をダウンロードします
  • ダウンロードした動画を ffprobe で検証します
  • ダウンロードに失敗した場合は、最大 3 回まで自動的に再試行します
  • 動画は会議の Markdown ファイルと同じ場所に .mp4 として保存されます
• Dropbox 同期のワークフローを置き換えます（API に直接アクセス）