Content
# 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)
1. **search_trends** - Analyze any keywords with full statistics
- Interest over time with trends
- Regional breakdown
- Related & rising queries
2. **compare_performers** - Compare search interest between performers
- Side-by-side comparison
- Growth trends
- Regional popularity
3. **compare_platforms** - Compare platform popularity
- Pornhub vs OnlyFans vs xVideos, etc.
- Market share trends
- Regional preferences
4. **analyze_category_trends** - Analyze content category trends
- MILF, Teen, Amateur, Hentai, etc.
- Trend direction (growing/declining)
- Regional variations
5. **historical_analysis** - Multi-year analysis (2004+)
- Long-term trends
- Peak periods
- Growth patterns
6. **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
- `uv` package manager (recommended) or `pip`
### Setup
1. Install `uv` (if not already installed):
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```
2. Create virtual environment and install dependencies:
```bash
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv pip install -e .
```
## Running the Server
### Standalone Testing
Run the server directly:
```bash
uv run server.py
```
### Configure with Claude Desktop
1. Edit your Claude Desktop config file:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
2. Add the server configuration (choose one method):
**Method A: Using the virtual environment directly (Recommended)**
```json
{
"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)**
```json
{
"mcpServers": {
"pornhub-mcp": {
"command": "uv",
"args": [
"run",
"--directory",
"/Users/talhelfgott/Desktop/api",
"--no-project",
"python",
"server.py"
]
}
}
}
```
3. 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:
1. **AdultDataLink API**: Sign up at https://adultdatalink.com/ and add API integration
2. **Web Scraping**: Implement scrapers for public statistics sites
3. **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
