播客转录摘要工具

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

# 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

# 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

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

# Edit config.json and add your Deepgram API key

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

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

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

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"

"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

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

# 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

brew install ffmpeg