Talhelf

Pornhub MCP Server

Community Talhelf
Updated

ph mcp - for fun

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):
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. 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

  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)

{
  "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"
      ]
    }
  }
}
  1. 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

MCP Server ยท Populars

MCP Server ยท New