Skip to main content
Glama

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 saved

Installationsanleitung

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 ffmpeg

Schritt 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 build

Schritt 3: Deepgram API-Schlüssel abrufen

  1. Gehen Sie zu https://console.deepgram.com/

  2. Registrieren Sie sich (der kostenlose Tarif beinhaltet $200 Guthaben – genug für ca. 300 Stunden Audio)

  3. Erstellen Sie einen API-Schlüssel

  4. 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 key

Ihre config.json sollte wie folgt aussehen:

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

⚠️ Wichtig: Committen Sie niemals config.json in Git – sie enthält Ihren API-Schlüssel! Die .gitignore schließ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

scrape_podcast

Episode abrufen & transkribieren. Gibt Dateipfad und Vorschau zurück.

get_transcript

Das vollständige Transkript einer abgerufenen Episode lesen.

get_summary_prompt

Ihre benutzerdefinierten Zusammenfassungsanweisungen abrufen.

save_summary

Ihre generierte Zusammenfassung in einer Markdown-Datei speichern.

check_new_episodes

Überwachte Podcasts auf neue (nicht abgerufene) Episoden prüfen.

list_incomplete

Episoden mit Transkripten, aber ohne Zusammenfassungen finden.

search_podcast

YouTube durchsuchen oder RSS-Feeds parsen, um Episoden zu finden.

add_tracking

Einen Podcast-RSS-Feed zu Ihrer Überwachungsliste hinzufügen.

list_tracking

Alle Podcasts auflisten, die Sie überwachen.

remove_tracking

Einen Podcast aus Ihrer Überwachungsliste entfernen.


Workflow

Typische Sitzung

  1. Auf neue Episoden prüfen:

    "Check my tracked podcasts for new episodes"
  2. Jede neue Episode abrufen:

    "Scrape the first one"
  3. Transkript abrufen und zusammenfassen:

    "Get the transcript and summarize it"
  4. 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.md

Konfigurationsoptionen

Option

Beschreibung

Standard

outputDirectory

Wo Transkripte und Zusammenfassungen gespeichert werden sollen. Kann ein relativer oder absoluter Pfad sein.

./podcasts

deepgramApiKey

Ihr Deepgram API-Schlüssel für die Transkription

Erforderlich

tempDirectory

Temporäres Verzeichnis für Audiodateien (wird beim Start automatisch bereinigt)

./temp

Umgebungsvariablen (optionale Alternative zu config.json):

  • DEEPGRAM_API_KEY

  • OUTPUT_DIRECTORY

  • TEMP_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 practices

Für Gründer:

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

Claude 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.js

Fehlerbehebung

"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

  1. Führen Sie npm run build aus

  2. Überprüfen Sie, ob der Pfad in der MCP-Konfiguration korrekt ist

  3. 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 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