Pornhub MCP Server
An MCP (Model Context Protocol) server that provides real-time and historical statistics about the adult entertainment industry using Google Trends API only.
Features
This MCP server provides 100% API-based tools (no cached data):
๐ Google Trends API Tools (2004-Present)
search_trends - Analyze any keywords with full statistics
- Interest over time with trends
- Regional breakdown
- Related & rising queries
compare_performers - Compare search interest between performers
- Side-by-side comparison
- Growth trends
- Regional popularity
compare_platforms - Compare platform popularity
- Pornhub vs OnlyFans vs xVideos, etc.
- Market share trends
- Regional preferences
analyze_category_trends - Analyze content category trends
- MILF, Teen, Amateur, Hentai, etc.
- Trend direction (growing/declining)
- Regional variations
historical_analysis - Multi-year analysis (2004+)
- Long-term trends
- Peak periods
- Growth patterns
trending_searches - Find related & rising searches
- What else people search for
- Breakout terms
- Related performers/categories
Data Source
โ Google Trends API (pytrends)
100% Real-time API - No Cached Data
- Coverage: 2004 to present
- Geographic: Worldwide + country-specific + US state-level
- Data Points: Search interest (0-100 scale), regional breakdown, related queries, trending terms
- Rate Limiting: Built-in delays to respect API limits
- Caching: 1-hour cache to avoid redundant API calls
- Free: No API key required
What You Can Query
- Any performer name (from 2004+)
- Any platform (pornhub, onlyfans, xvideos, etc.)
- Any category (milf, teen, amateur, hentai, etc.)
- Any search term
- Compare up to 5 terms at once
- Custom date ranges
- Regional analysis (US states, countries, worldwide)
Installation
Prerequisites
- Python 3.10 or higher
uvpackage manager (recommended) orpip
Setup
- Install
uv(if not already installed):
curl -LsSf https://astral.sh/uv/install.sh | sh
- Create virtual environment and install dependencies:
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv pip install -e .
Running the Server
Standalone Testing
Run the server directly:
uv run server.py
Configure with Claude Desktop
Edit your Claude Desktop config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
Add the server configuration (choose one method):
Method A: Using the virtual environment directly (Recommended)
{
"mcpServers": {
"pornhub-mcp": {
"command": "/Users/talhelfgott/Desktop/api/.venv/bin/python",
"args": [
"/Users/talhelfgott/Desktop/api/server.py"
]
}
}
}
Method B: Using uv (if you prefer)
{
"mcpServers": {
"pornhub-mcp": {
"command": "uv",
"args": [
"run",
"--directory",
"/Users/talhelfgott/Desktop/api",
"--no-project",
"python",
"server.py"
]
}
}
}
- Restart Claude Desktop
Example Queries
Once connected to Claude Desktop, you can ask:
๐ Performer Analysis
- "Compare search trends for Lana Rhoades vs Riley Reid from 2020-2024"
- "Show me Google Trends for Abella Danger over the past 5 years"
- "Which performer has more search interest: [name A] or [name B]?"
- "Analyze historical trends for [any performer] from 2020 to 2024"
- "What states search for [performer name] the most?"
๐ Platform Comparison
- "Compare Pornhub vs OnlyFans vs xVideos search trends"
- "Is OnlyFans growing or declining in popularity?"
- "Show me the trend for Pornhub over the past 5 years"
- "Which platform is most popular in California?"
๐ Category Trends
- "Compare milf vs teen vs amateur category searches"
- "Is hentai search interest growing or declining?"
- "Show me trends for ethical porn searches"
- "What are the trending adult categories right now?"
๐ Regional Analysis
- "Which US states have the highest search interest for OnlyFans?"
- "Show me UK vs US search interest for [any term]"
- "What are people searching for related to Pornhub?"
๐ Historical Queries
- "Show me 2020-2024 trends for [any performer]"
- "Compare 2020 vs 2024 for [platform or category]"
- "What was the peak year for [any search term]?"
- "Analyze the past 5 years of [anything]"
Project Structure
api/
โโโ server.py # Main MCP server implementation
โโโ pyproject.toml # Project dependencies
โโโ README.md # This file
Data Updates
The current implementation uses cached/sample data. To add real-time data:
- AdultDataLink API: Sign up at https://adultdatalink.com/ and add API integration
- Web Scraping: Implement scrapers for public statistics sites
- Platform APIs: Integrate official APIs where available
Privacy & Ethics
This server is designed for:
- Market research and analysis
- Industry statistics and trends
- Educational purposes
All data is aggregated statistics from public sources. No personal data or explicit content is accessed or stored.
License
MIT License - See LICENSE file for details
Contributing
Contributions welcome! Please ensure:
- Data sources are legitimate and ethical
- No explicit content or personal data
- Focus on industry statistics and analytics