MCP Podcast Scraper
MCP 팟캐스트 스크레이퍼
팟캐스트 에피소드를 스크랩하고 전사하는 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 ffmpeg2단계: 복제 및 빌드
# 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 build3단계: Deepgram API 키 받기
가입 (무료 티어에는 $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가 팟캐스트를 요약하는 방식을 제어하세요.
기본 프롬프트는 **제품 관리자(PM)**를 위해 조정되었으며 다음을 포함합니다:
🎯 에피소드 개요
💡 제품 관리자를 위한 핵심 인사이트
🧠 멘탈 모델 및 프레임워크
📈 자기 계발을 위한 핵심 내용
✅ 실행 항목
💬 주목할 만한 인용구
🔗 관련 주제
필요에 맞게 사용자 지정
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 피드를 사용하십시오. https://getrssfeed.com/ 에서 팟캐스트 RSS 피드를 찾을 수 있습니다.
라이선스
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