PodCrawlerMCP
About
MCP server for podcast discovery through web crawling
Details
- Author
- infinitimeless
- Downloads
- 312
- Categories
- Other
Jump to
- Crawls podcast directories to discover RSS feeds.
- Parses RSS feeds to extract episode data.
- Filters episodes by topic or domain.
- Exposes functionality through MCP tools.
- Seamlessly integrates with AI assistants like Claude.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
PodCrawlerMCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install with pip install podcrawler-mcp (or poetry add podcrawler-mcp). Run the server directly via python -m podcrawler.server. To integrate with Claude Desktop, add a configuration entry pointing to that command. The server exposes the discover_podcasts tool.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"podcrawlermcp": {
"podcrawler-mcp": {
"command": "python",
"args": [
"-m",
"podcrawler.server"
]
}
}
}
}
McpServers
{
"podcrawler-mcp": {
"command": "python",
"args": [
"-m",
"podcrawler.server"
]
}
}
PodCrawlerMCP
An MCP (Model Context Protocol) server for podcast discovery through web crawling. PodCrawlerMCP enables AI assistants to find podcast episodes on specific topics by crawling the web for RSS feeds.
Features
- πΈοΈ Crawls podcast directories to discover RSS feeds
- ποΈ Parses RSS feeds to extract episode data
- π Filters episodes by topic or domain
- π Exposes functionality through MCP tools
- π€ Seamlessly integrates with AI assistants like Claude
Installation
pip install podcrawler-mcp
Or with Poetry:
poetry add podcrawler-mcp
Quick Start
Run the server directly:
python -m podcrawler.server
Or in your Python code:
from podcrawler import PodCrawlerServer
server = PodCrawlerServer()
server.run()
Integrating with Claude Desktop
Add to your Claude Desktop configuration:
{
"mcpServers": {
"podcrawler": {
"command": "python",
"args": ["-m", "podcrawler.server"]
}
}
}
Available Tools
discover_podcasts
Discovers podcasts on a specific topic.
Parameters:
- topic (string): The topic to search for (e.g., "technology", "history")
- max_results (integer, optional): Maximum number of results to return (default: 10)
Example Usage:
What are some science podcasts about black holes?
Project Structure
podcrawler-mcp/
βββ podcrawler/ # Main package
β βββ __init__.py # Package initialization
β βββ server.py # MCP server implementation
β βββ tools/ # MCP tools
β β βββ __init__.py
β β βββ discovery.py # Podcast discovery tool
β βββ crawler/ # Web crawling components
β β βββ __init__.py
β β βββ spider.py # Web crawler implementation
β β βββ parser.py # RSS feed parser
β βββ utils/ # Utility functions
β βββ __init__.py
β βββ filtering.py # Topic filtering utilities
β βββ formatting.py # Output formatting utilities
βββ tests/ # Tests
β βββ __init__.py
β βββ test_server.py # Server tests
βββ examples/ # Usage examples
β βββ basic_discovery.py # Basic discovery example
βββ pyproject.toml # Project configuration
βββ README.md # Project documentation
βββ LICENSE # MIT License
βββ CONTRIBUTING.md # Contribution guidelines
Development
1. Clone the repository
git clone https://github.com/infinitimeless/podcrawler-mcp.git
cd podcrawler-mcp
2. Install dependencies using Poetry
poetry install
3. Run tests
poetry run pytest
Contributing
Contributions are welcome! Please see CONTRIBUTING.md for details.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



