MCP Podcast Scraper
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キーの取得
https://console.deepgram.com/ にアクセスします
サインアップします(無料枠には200ドル分のクレジットが含まれており、約300時間の音声分に相当します)
APIキーを作成します
キーをコピーします
ステップ 4: 設定
設定ファイルのサンプルをコピーし、APIキーを追加します:
# Copy the example config
cp config.example.json config.json
# Edit config.json and add your Deepgram API keyconfig.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ツールリファレンス
ツール | 説明 |
| エピソードをスクレイピングして文字起こしします。ファイルパスとプレビューを返します。 |
| スクレイピングしたエピソードの完全な文字起こしを読み取ります。 |
| カスタム要約指示を取得します。 |
| 生成された要約をマークダウンファイルとして保存します。 |
| 追跡中のポッドキャストで新しい(未スクレイピングの)エピソードを確認します。 |
| 文字起こしはあるが要約がないエピソードを検索します。 |
| YouTubeを検索するかRSSフィードを解析してエピソードを見つけます。 |
| ポッドキャストのRSSフィードを追跡リストに追加します。 |
| 追跡中のすべてのポッドキャストをリストアップします。 |
| 追跡リストからポッドキャストを削除します。 |
ワークフロー
一般的なセッション
新着エピソードを確認:
"Check my tracked podcasts for new episodes"各新着エピソードをスクレイピング:
"Scrape the first one"文字起こしを取得して要約:
"Get the transcript and summarize it"残りのエピソードに対して繰り返す
未完了の作業を再開
セッションの途中で停止した場合:
"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設定オプション
オプション | 説明 | デフォルト |
| 文字起こしと要約を保存する場所。相対パスまたは絶対パスを指定可能。 |
|
| 文字起こし用のDeepgram APIキー | 必須 |
| 音声ファイル用の一時ディレクトリ(起動時に自動クリーンアップ) |
|
環境変数(config.jsonの代替オプション):
DEEPGRAM_API_KEYOUTPUT_DIRECTORYTEMP_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 avoidClaudeは各要約を生成する前にこのプロンプトを読み込み、一貫性のあるパーソナライズされた出力を保証します。
開発
# 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サーバーが接続されない
npm run buildを実行しますMCP設定内のパスが正しいことを確認します
Claude Code/Desktopを再起動します
"YouTube URLs not supported for tracking"
代わりにRSSフィードを使用してください。ポッドキャストのRSSフィードは https://getrssfeed.com/ で見つけることができます。
ライセンス
MIT
Available Tools
10 toolsadd_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
Scored across 10 tools
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.
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.
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.
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
Related MCP Connectors
An MCP server that provides tools to discover and retrieve podcast episodes transcripts.
MCP server for RiverScript, an AI transcription platform - fetches transcripts shared via a link.
An MCP server that gives any LLM or agent clean YouTube transcripts on demand: a single video, a whole channel, or a playlist, plus AI cleanup of auto-generated captions. API-key auth, credit-based, same backend as the public v1 API. Get a free API key with 25 free credits at youtubetranscriptdownload.com/account.
MCP server for structured access to Lenny Rachitsky podcast transcripts. For content creators.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn 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.54MIT
- AlicenseBqualityDmaintenanceAn MCP server designed to fetch transcripts for YouTube videos. It enables AI tools to access video text content for tasks like summarization, analysis, and key takeaway extraction.174MIT
- AlicenseAqualityDmaintenanceAn MCP server that integrates with the Podhome API to manage multiple podcast shows. It enables users to create and schedule episodes, generate clips, and manage webhooks through natural language commands.10MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that extracts YouTube video transcripts (including metadata) as Markdown, enabling AI to summarize and discuss video content without watching it.MIT