Skip to main content
Glama

MCP Podcast Scraper

ポッドキャストのエピソードをスクレイピングおよび文字起こしするMCP(Model Context Protocol)サーバーです。Claude CodeまたはClaude Desktopと連携するように設計されており、ポッドキャストを提供するとMCPが文字起こしを行い、Claudeが要約します。

Walid Koleilatによって作成されました。MCPをエンドツーエンドで学習し、Claudeから離れることなく、数時間のポッドキャスト音声をPM向けの有用な要約に変換するという実際のワークフローを解決するために構築されました。

主な機能

  • 🎙️ YouTube動画やRSSフィードからポッドキャストをスクレイピング

  • 🎯 Deepgramの高速なNova-2モデルを使用して音声を文字起こし

  • 📁 ポッドキャスト名とエピソード日付でファイルを整理

  • 🔄 新着エピソードをポッドキャスト追跡

  • ⏭️ 重複をスキップ - 処理済みエピソードの再スクレイピングを防止

  • 📋 未完了の作業を検索 - 要約が必要なエピソードをリストアップ

  • ✏️ カスタム要約プロンプト - ニーズに合わせてClaudeの要約方法をカスタマイズ

Related MCP server: ytt-mcp

仕組み

You: "Check for new episodes and summarize them"
         ↓
Claude: Calls check_new_episodes() → Finds new episodes
         ↓
Claude: Calls scrape_podcast() → Downloads & transcribes
         ↓
Claude: Calls get_summary_prompt() → Reads your custom instructions
         ↓
Claude: Calls get_transcript() → Reads the transcript
         ↓
Claude: Summarizes following your prompt
         ↓
Claude: Calls save_summary() → Saves the .md file
         ↓
Done! transcript.md + summary.md saved

インストールガイド

ステップ 1: 前提条件

必要なシステムツールをインストールします(macOS):

# Install Homebrew if you don't have it
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install yt-dlp (for YouTube) and ffmpeg (for audio)
brew install yt-dlp ffmpeg

ステップ 2: クローンとビルド

# Clone the repository
git clone https://github.com/walid-koleilat/mcp-podcast-scraper.git
cd mcp-podcast-scraper

# Install dependencies
npm install

# Build
npm run build

ステップ 3: Deepgram APIキーの取得

  1. https://console.deepgram.com/ にアクセスします

  2. サインアップします(無料枠には200ドル分のクレジットが含まれており、約300時間の音声分に相当します)

  3. APIキーを作成します

  4. キーをコピーします

ステップ 4: 設定

設定ファイルのサンプルをコピーし、APIキーを追加します:

# Copy the example config
cp config.example.json config.json

# Edit config.json and add your Deepgram API key

config.json は以下のようになります:

{
  "outputDirectory": "./podcasts",
  "deepgramApiKey": "YOUR_ACTUAL_DEEPGRAM_API_KEY",
  "tempDirectory": "./temp"
}

⚠️ 重要: config.json をgitにコミットしないでください。APIキーが含まれています!.gitignore ですでに除外されています。

ステップ 5: Claude Codeへの追加

Claude CodeのMCP設定(~/.cursor/mcp.json または設定 → MCP経由)に以下を追加します:

{
  "mcpServers": {
    "podcast-scraper": {
      "command": "node",
      "args": ["/FULL/PATH/TO/mcp-podcast-scraper/dist/index.js"]
    }
  }
}

重要: /FULL/PATH/TO/ を実際のインストールパスに置き換えてください。

ステップ 5 (代替): Claude Desktopへの追加

~/Library/Application Support/Claude/claude_desktop_config.json を編集します:

{
  "mcpServers": {
    "podcast-scraper": {
      "command": "node",
      "args": ["/FULL/PATH/TO/mcp-podcast-scraper/dist/index.js"]
    }
  }
}

その後、Claude Desktopを再起動します。


ファイル構造

mcp-podcast-scraper/
├── config.example.json     # Template - copy to config.json
├── config.json             # Your config (git-ignored, contains API key)
├── tracking.example.json   # Example tracking file
├── tracking.json           # Your tracked podcasts (git-ignored)
├── prompts/
│   └── summary-prompt.md   # Customize how Claude summarizes (editable)
├── podcasts/               # Your transcripts & summaries (git-ignored)
├── src/                    # Source code
├── dist/                   # Compiled code (git-ignored)
└── node_modules/           # Dependencies (git-ignored)

使用例

特定のエピソードをスクレイピング

"Scrape this YouTube podcast: https://youtube.com/watch?v=..."

"Find and scrape the latest Lex Fridman episode"

新着エピソードのポッドキャスト追跡

"Track the Huberman Lab podcast: https://feeds.megaphone.fm/hubermanlab"

"Check my tracked podcasts for new episodes"

"List all podcasts I'm tracking"

未完了の作業を検索

"Show me episodes that need summaries"

"List incomplete episodes"

MCPツールリファレンス

ツール

説明

scrape_podcast

エピソードをスクレイピングして文字起こしします。ファイルパスとプレビューを返します。

get_transcript

スクレイピングしたエピソードの完全な文字起こしを読み取ります。

get_summary_prompt

カスタム要約指示を取得します。

save_summary

生成された要約をマークダウンファイルとして保存します。

check_new_episodes

追跡中のポッドキャストで新しい(未スクレイピングの)エピソードを確認します。

list_incomplete

文字起こしはあるが要約がないエピソードを検索します。

search_podcast

YouTubeを検索するかRSSフィードを解析してエピソードを見つけます。

add_tracking

ポッドキャストのRSSフィードを追跡リストに追加します。

list_tracking

追跡中のすべてのポッドキャストをリストアップします。

remove_tracking

追跡リストからポッドキャストを削除します。


ワークフロー

一般的なセッション

  1. 新着エピソードを確認:

    "Check my tracked podcasts for new episodes"
  2. 各新着エピソードをスクレイピング:

    "Scrape the first one"
  3. 文字起こしを取得して要約:

    "Get the transcript and summarize it"
  4. 残りのエピソードに対して繰り返す

未完了の作業を再開

セッションの途中で停止した場合:

"Show me episodes that need summaries"

その後、各未完了エピソードに対して以下を実行します:

"Get the transcript for [episode] and summarize it"

出力構造

ファイルはポッドキャストおよびエピソードごとに整理されます:

podcasts/
├── Huberman Lab/
│   ├── 2024-12-10 - Episode Title/
│   │   ├── transcript.md
│   │   └── summary.md
│   └── 2024-12-05 - Another Episode/
│       ├── transcript.md
│       └── summary.md
└── Lex Fridman Podcast/
    └── 2024-12-08 - Guest Name/
        ├── transcript.md
        └── summary.md

設定オプション

オプション

説明

デフォルト

outputDirectory

文字起こしと要約を保存する場所。相対パスまたは絶対パスを指定可能。

./podcasts

deepgramApiKey

文字起こし用のDeepgram APIキー

必須

tempDirectory

音声ファイル用の一時ディレクトリ(起動時に自動クリーンアップ)

./temp

環境変数(config.jsonの代替オプション):

  • DEEPGRAM_API_KEY

  • OUTPUT_DIRECTORY

  • TEMP_DIRECTORY


要約プロンプトのカスタマイズ

prompts/summary-prompt.md を編集して、Claudeがポッドキャストを要約する方法を制御します。

デフォルトのプロンプトはプロダクトマネージャー向けに調整されており、以下が含まれます:

  • 🎯 エピソードの概要

  • 💡 プロダクトマネージャー向けの重要な洞察

  • 🧠 メンタルモデルとフレームワーク

  • 📈 自己啓発のポイント

  • ✅ アクションアイテム

  • 💬 注目すべき引用

  • 🔗 関連トピック

ニーズに合わせてカスタマイズ

prompts/summary-prompt.md を編集して以下を行います:

  • ターゲット読者(エンジニア、デザイナー、創業者など)の変更

  • セクションの追加/削除

  • 要約の長さの調整

  • 特定のトピックへのフォーカス

  • フォーマットスタイルの変更

カスタマイズ例:

エンジニア向け:

Focus on:
- Technical concepts and architecture decisions
- Implementation details worth noting
- Tools and technologies mentioned
- Code patterns and best practices

創業者向け:

Focus on:
- Business strategy insights
- Fundraising advice
- Growth tactics
- Leadership lessons
- Mistakes to avoid

Claudeは各要約を生成する前にこのプロンプトを読み込み、一貫性のあるパーソナライズされた出力を保証します。


開発

# Watch mode (auto-rebuild on changes)
npm run dev

# Build once
npm run build

# Run MCP server directly
npm start

# Clean build artifacts and temp files
npm run clean

# Test with MCP Inspector (interactive UI)
npx @modelcontextprotocol/inspector node dist/index.js

トラブルシューティング

"ffprobe and ffmpeg not found"

brew install ffmpeg

"Deepgram API key not configured"

config.example.json を config.json にコピーし、APIキーを追加したことを確認してください。

MCPサーバーが接続されない

  1. npm run build を実行します

  2. MCP設定内のパスが正しいことを確認します

  3. Claude Code/Desktopを再起動します

"YouTube URLs not supported for tracking"

代わりにRSSフィードを使用してください。ポッドキャストのRSSフィードは https://getrssfeed.com/ で見つけることができます。


ライセンス

MIT

Available Tools

10 tools
add_trackingA

Add a podcast RSS feed to the tracking list. Use check_new_episodes to find new episodes.

Inputs: podcastName (required), feedUrl (required).

check_new_episodesB

Check all tracked podcasts for new episodes that haven't been scraped yet

Inputs: no named parameters.

get_summary_promptA

Get the custom prompt/instructions for how to summarize podcasts. Read this before summarizing to follow the user's preferences.

Inputs: no named parameters.

get_transcriptB

Read the transcript of a previously scraped episode. After reading, use get_summary_prompt for summarization instructions.

Inputs: podcastName (required), episodeTitle (required), episodeDate (required).

list_incompleteA

List all episodes that have transcripts but are missing summaries. Use this to find episodes that need summarization.

Inputs: no named parameters.

list_trackingB

List all podcasts currently being tracked

Inputs: no named parameters.

remove_trackingC

Remove a podcast from the tracking list

Inputs: podcastName (required).

save_summaryC

Save your generated summary to a markdown file.

Inputs: podcastName (required), episodeTitle (required), episodeDate (required), summaryText (required).

scrape_podcastA

Scrape a podcast episode and transcribe it. Returns transcript file path. Use get_transcript to read it, then save_summary after summarizing.

Inputs: query (required), podcastName, episodeTitle, force.

search_podcastB

Search for podcasts or episodes on YouTube, or parse an RSS feed URL to see available episodes

Inputs: query (required), source.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 10 tools

    Disambiguation4/5

    Most tools have distinct purposes, but there is some overlap between 'scrape_podcast' and 'check_new_episodes' as both involve scraping episodes, which could cause confusion. However, descriptions clarify that 'scrape_podcast' is for manual scraping of specific episodes, while 'check_new_episodes' automatically checks tracked feeds, so the ambiguity is limited.

    Naming Consistency4/5

    Tool names follow a consistent verb_noun pattern throughout, such as 'add_tracking', 'check_new_episodes', and 'save_summary'. The only minor deviation is 'list_incomplete', which uses an adjective instead of a noun, but this does not significantly impact readability or consistency.

    Tool Count5/5

    With 10 tools, the server is well-scoped for podcast scraping and summarization. Each tool serves a clear purpose in the workflow, from tracking and scraping to transcription and summarization, without being overly sparse or bloated.

    Completeness5/5

    The tool set provides complete coverage for the podcast domain, including tracking management (add, list, remove), scraping and transcription, transcript retrieval, summarization with custom prompts, and saving summaries. There are no obvious gaps; it supports a full lifecycle from discovery to final output.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that enables users to retrieve YouTube transcripts and perform video or channel searches without requiring Google API keys. It supports transcript chunking and provides tools for detailed video content analysis and channel metadata extraction.
      5
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that extracts YouTube video transcripts (including metadata) as Markdown, enabling AI to summarize and discuss video content without watching it.
      MIT