MCP Podcast Scraper
MCP Podcast Scraper
Ein MCP-Server (Model Context Protocol), der Podcast-Episoden abruft und transkribiert. Entwickelt für die Verwendung mit Claude Code oder Claude Desktop – Sie geben den Podcast an, das MCP transkribiert ihn und Claude fasst ihn zusammen.
Erstellt von Walid Koleilat, um MCP von Grund auf zu erlernen und einen echten Workflow zu lösen: Stundenlanges Podcast-Audio in nützliche, auf Produktmanagement ausgerichtete Zusammenfassungen zu verwandeln, ohne Claude verlassen zu müssen.
Was es tut
🎙️ Ruft Podcasts ab von YouTube-Videos oder RSS-Feeds
🎯 Transkribiert Audio mit dem schnellen Nova-2-Modell von Deepgram
📁 Organisiert Dateien nach Podcast-Name und Episodendatum
🔄 Überwacht Podcasts auf neue Episoden
⏭️ Überspringt Duplikate – bereits verarbeitete Episoden werden nicht erneut abgerufen
📋 Findet unvollständige Arbeit – listet Episoden auf, die noch zusammengefasst werden müssen
✏️ Benutzerdefinierte Zusammenfassungs-Prompts – passen Sie an, wie Claude für Ihre Bedürfnisse zusammenfasst
Related MCP server: ytt-mcp
Funktionsweise
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 savedInstallationsanleitung
Schritt 1: Voraussetzungen
Installieren Sie die erforderlichen System-Tools (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 ffmpegSchritt 2: Klonen & Erstellen
# 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 buildSchritt 3: Deepgram API-Schlüssel abrufen
Gehen Sie zu https://console.deepgram.com/
Registrieren Sie sich (der kostenlose Tarif beinhaltet $200 Guthaben – genug für ca. 300 Stunden Audio)
Erstellen Sie einen API-Schlüssel
Kopieren Sie den Schlüssel
Schritt 4: Konfiguration
Kopieren Sie die Beispiel-Konfigurationsdatei und fügen Sie Ihren API-Schlüssel hinzu:
# Copy the example config
cp config.example.json config.json
# Edit config.json and add your Deepgram API keyIhre config.json sollte wie folgt aussehen:
{
"outputDirectory": "./podcasts",
"deepgramApiKey": "YOUR_ACTUAL_DEEPGRAM_API_KEY",
"tempDirectory": "./temp"
}⚠️ Wichtig: Committen Sie niemals
config.jsonin Git – sie enthält Ihren API-Schlüssel! Die.gitignoreschließt sie bereits aus.
Schritt 5: Zu Claude Code hinzufügen
Fügen Sie dies zu Ihren Claude Code MCP-Einstellungen hinzu (~/.cursor/mcp.json oder über Einstellungen → MCP):
{
"mcpServers": {
"podcast-scraper": {
"command": "node",
"args": ["/FULL/PATH/TO/mcp-podcast-scraper/dist/index.js"]
}
}
}Wichtig: Ersetzen Sie /FULL/PATH/TO/ durch den tatsächlichen Pfad zu Ihrer Installation.
Schritt 5 (Alternative): Zu Claude Desktop hinzufügen
Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"podcast-scraper": {
"command": "node",
"args": ["/FULL/PATH/TO/mcp-podcast-scraper/dist/index.js"]
}
}
}Starten Sie anschließend Claude Desktop neu.
Dateistruktur
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)Anwendungsbeispiele
Eine bestimmte Episode abrufen
"Scrape this YouTube podcast: https://youtube.com/watch?v=..."
"Find and scrape the latest Lex Fridman episode"Podcasts auf neue Episoden überwachen
"Track the Huberman Lab podcast: https://feeds.megaphone.fm/hubermanlab"
"Check my tracked podcasts for new episodes"
"List all podcasts I'm tracking"Unvollständige Arbeit finden
"Show me episodes that need summaries"
"List incomplete episodes"MCP-Tools-Referenz
Tool | Beschreibung |
| Episode abrufen & transkribieren. Gibt Dateipfad und Vorschau zurück. |
| Das vollständige Transkript einer abgerufenen Episode lesen. |
| Ihre benutzerdefinierten Zusammenfassungsanweisungen abrufen. |
| Ihre generierte Zusammenfassung in einer Markdown-Datei speichern. |
| Überwachte Podcasts auf neue (nicht abgerufene) Episoden prüfen. |
| Episoden mit Transkripten, aber ohne Zusammenfassungen finden. |
| YouTube durchsuchen oder RSS-Feeds parsen, um Episoden zu finden. |
| Einen Podcast-RSS-Feed zu Ihrer Überwachungsliste hinzufügen. |
| Alle Podcasts auflisten, die Sie überwachen. |
| Einen Podcast aus Ihrer Überwachungsliste entfernen. |
Workflow
Typische Sitzung
Auf neue Episoden prüfen:
"Check my tracked podcasts for new episodes"Jede neue Episode abrufen:
"Scrape the first one"Transkript abrufen und zusammenfassen:
"Get the transcript and summarize it"Für verbleibende Episoden wiederholen
Unvollständige Arbeit fortsetzen
Falls Sie mitten in der Sitzung aufgehört haben:
"Show me episodes that need summaries"Dann für jede unvollständige Episode:
"Get the transcript for [episode] and summarize it"Ausgabestruktur
Dateien sind nach Podcast und Episode organisiert:
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.mdKonfigurationsoptionen
Option | Beschreibung | Standard |
| Wo Transkripte und Zusammenfassungen gespeichert werden sollen. Kann ein relativer oder absoluter Pfad sein. |
|
| Ihr Deepgram API-Schlüssel für die Transkription | Erforderlich |
| Temporäres Verzeichnis für Audiodateien (wird beim Start automatisch bereinigt) |
|
Umgebungsvariablen (optionale Alternative zu config.json):
DEEPGRAM_API_KEYOUTPUT_DIRECTORYTEMP_DIRECTORY
Zusammenfassungs-Prompts anpassen
Steuern Sie, wie Claude Ihre Podcasts zusammenfasst, indem Sie prompts/summary-prompt.md bearbeiten.
Der Standard-Prompt ist auf Produktmanager zugeschnitten und enthält:
🎯 Episodenübersicht
💡 Wichtige Erkenntnisse für Produktmanager
🧠 Mentale Modelle & Frameworks
📈 Erkenntnisse zur persönlichen Entwicklung
✅ Aufgaben (Action Items)
💬 Bemerkenswerte Zitate
🔗 Verwandte Themen
An Ihre Bedürfnisse anpassen
Bearbeiten Sie prompts/summary-prompt.md, um:
Die Zielgruppe zu ändern (Ingenieur, Designer, Gründer, etc.)
Abschnitte hinzuzufügen/zu entfernen
Die Länge der Zusammenfassung anzupassen
Sich auf bestimmte Themen zu konzentrieren
Den Formatierungsstil zu ändern
Beispielanpassungen:
Für Ingenieure:
Focus on:
- Technical concepts and architecture decisions
- Implementation details worth noting
- Tools and technologies mentioned
- Code patterns and best practicesFür Gründer:
Focus on:
- Business strategy insights
- Fundraising advice
- Growth tactics
- Leadership lessons
- Mistakes to avoidClaude liest diesen Prompt vor der Generierung jeder Zusammenfassung, um eine konsistente, personalisierte Ausgabe zu gewährleisten.
Entwicklung
# 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.jsFehlerbehebung
"ffprobe and ffmpeg not found"
brew install ffmpeg"Deepgram API key not configured"
Stellen Sie sicher, dass Sie config.example.json nach config.json kopiert und Ihren API-Schlüssel hinzugefügt haben.
MCP-Server verbindet nicht
Führen Sie
npm run buildausÜberprüfen Sie, ob der Pfad in der MCP-Konfiguration korrekt ist
Starten Sie Claude Code/Desktop neu
"YouTube URLs not supported for tracking"
Verwenden Sie stattdessen RSS-Feeds. Finden Sie Podcast-RSS-Feeds unter https://getrssfeed.com/
Lizenz
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