# 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