EAF Python API Documentation

Accelerate and improve your development by integrating our official, real-time MCP server directly into your AI coding assistant. Working with scrapers and media download engines requires exact knowledge of dynamic parameters, sorting enums, source-loading mechanisms (e.g. load_sources("html")), and typed exception hierarchies. Connecting this MCP server to your AI assistant is absolutely the recommended way to work on and build projects with these APIs.

Server Endpoint (SSE / HTTP)

https://mcp.echteralsfake.me/mcp

🔓

No Authentication

No API keys, accounts, or tokens needed. Connect and use immediately.

⚡

No Strict Rate Limits

Unrestricted access designed for fluid AI pair programming and fast iteration.

🌐

Covers All 16 APIs

Complete context for eaf_base_api plus all 15 site scraper wrappers.

🔄

Always Up To Date

Continuously synchronized with upstream codebase changes and new releases.

🛡️

Completely Anonymous

Zero IP logging, zero request tracking, zero profiling. Complete privacy.

🤖

Hallucination-Free Code

Your agent inspects real signatures and models instead of guessing obsolete APIs.

Why use MCP + AI?

AI models without MCP frequently hallucinate outdated v3 methods (e.g. fetch(), result.video, proxies). When connected to this MCP server, your AI receives live, accurate tool specifications, method signatures, parameter tables, and typed models. Using the MCP server in your workflow will transform your productivity and is the recommended way to build with this ecosystem.

Setup Guides for Popular Coding Tools

Copy and paste the configuration snippet for your editor or AI agent:

Cursor

Add to .cursor/mcp.json in your project root, or globally in ~/.cursor/mcp.json (or configure via Cursor Settings > Features > MCP):

.cursor/mcp.json

{
  "mcpServers": {
    "eaf-apis": {
      "url": "https://mcp.echteralsfake.me/mcp"
    }
  }
}

VS Code (GitHub Copilot / Native MCP)

Add to .vscode/mcp.json in your workspace or user profile (Command Palette: MCP: Open User Configuration):

.vscode/mcp.json

{
  "servers": {
    "eaf-apis": {
      "type": "http",
      "url": "https://mcp.echteralsfake.me/mcp"
    }
  }
}

VS Code Extensions (Cline / Roo Code)

Configure in Cline (cline_mcp_settings.json via Cline MCP panel) or Roo Code (.roo/mcp.json or mcp_settings.json):

mcp_settings.json

{
  "mcpServers": {
    "eaf-apis": {
      "url": "https://mcp.echteralsfake.me/mcp"
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json, Linux: ~/.config/Claude/claude_desktop_config.json):

claude_desktop_config.json

{
  "mcpServers": {
    "eaf-apis": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.echteralsfake.me/mcp"]
    }
  }
}

Claude Code (CLI)

Add via Claude Code CLI command:

bash

claude mcp add --transport http eaf-apis https://mcp.echteralsfake.me/mcp

Windsurf (Codeium)

Add to ~/.codeium/windsurf/mcp_config.json (macOS/Linux) or %USERPROFILE%\.codeium\windsurf\mcp_config.json (Windows):

mcp_config.json

{
  "mcpServers": {
    "eaf-apis": {
      "serverUrl": "https://mcp.echteralsfake.me/mcp"
    }
  }
}

Zed

Add to ~/.config/zed/settings.json (or configure via Settings > AI > Context Servers / MCP Servers):

settings.json

{
  "context_servers": {
    "eaf-apis": {
      "url": "https://mcp.echteralsfake.me/mcp"
    }
  }
}

Antigravity / Gemini CLI

Add via CLI command:

bash

agy mcp add eaf-apis https://mcp.echteralsfake.me/mcp

Or add directly to your global configuration (~/.gemini/config/mcp_config.json):

mcp_config.json

{
  "mcpServers": {
    "eaf-apis": {
      "serverUrl": "https://mcp.echteralsfake.me/mcp"
    }
  }
}

Core engine

The shared request, media-loading, iteration, caching, and download runtime used by every wrapper.

Base API

v4.2.0

The version 4 asynchronous networking and media-loading engine for EchterAlsFake API wrappers. It provides explicit request APIs, bounded retries, byte-limited TTL caches, source-aware media models, structured scrape streams, and HLS/RAW downloads.

API wrappers

Site-specific packages with a consistent async interface and typed media objects.

Beeg API

v1.7

A fully asynchronous Python API wrapper and scraper for Beeg. Fetch video metadata by parsing external API endpoints, and download streams via HLS. Powered by the eaf_base_api networking engine.

Eporner API

v2.4.1

A fully asynchronous Python API wrapper and scraper for Eporner. Fetch video details via API and HTML endpoints, download files directly with multi-threaded range requests, and retrieve pornstar biographies. Powered by the eaf_base_api networking engine.

HQPorner API

v2.5

A fully asynchronous Python API wrapper and scraper for HQPorner. Fetch videos, metadata, search, get videos by actress or category, and download content — all powered by the eaf_base_api networking engine.

MissAV API

v2.6

A fully asynchronous Python API wrapper and scraper for MissAV. Fetch JAV video metadata and download streams via HLS. Features Recombee-powered search with HMAC-signed API requests. Powered by the eaf_base_api networking engine.

PornHub API

v5.4.3

A fully asynchronous Python API wrapper and scraper for Pornhub. Fetch videos, GIFs, shorts, albums, playlists, pornstars, models, channels, and user profiles — with full account login support. Powered by the eaf_base_api networking engine.

Porntrex API

v1.8

A fully asynchronous Python API wrapper and scraper for Porntrex. Fetch video metadata, channel information, and model profiles, run search queries, and download media via direct CDN links. Powered by the eaf_base_api networking engine.

Redtube API

v1.4.1

A fully asynchronous Python API wrapper and scraper for Redtube. Fetch video details, custom playlists, publishers channels, users, and pornstars. Stream downloads via HLS. Powered by the eaf_base_api networking engine.

SpankBang API

v2.4.1

A fully asynchronous Python API wrapper and scraper for SpankBang. Fetch videos, metadata, search, and iterate over channels, creators, or pornstars. Download content using HLS or direct RAW MP4 downloads. Powered by the eaf_base_api networking engine.

Thumbzilla API

v1.4

A fully asynchronous Python API wrapper and scraper for Thumbzilla. Fetch video metadata, playlists, pornstar biographies, amateur profiles, and studio channels. Stream downloads via HLS with auto-constructed master playlists. Powered by the eaf_base_api networking engine.

Tube8 API

v1.3

A fully asynchronous Python API wrapper and scraper for Tube8. Fetch video metadata, pornstar biographies, amateur profiles, and studio channels. Stream downloads via HLS with auto-constructed master playlists. Powered by the eaf_base_api networking engine.

XFreeHD API

v1.7.1

A fully asynchronous Python API wrapper and scraper for XFreeHD. Fetch video metadata, photo albums, execute search queries, and download media files directly from CDNs. Powered by the eaf_base_api networking engine.

xHamster API

v2.6.2

A fully asynchronous Python API wrapper and scraper for xHamster. Fetch video details, shorts, channel information, pornstar metadata, or log into user accounts. Stream downloads via HLS. Powered by the eaf_base_api networking engine.

XNXX API

v2.4.1

A fully asynchronous Python API wrapper and scraper for XNXX. Fetch videos, metadata, search with complex filters, and iterate over user uploads — all powered by the eaf_base_api networking engine.

XVideos API

v2.5

A fully asynchronous Python API wrapper and scraper for XVideos. Fetch videos, metadata, pornstar profiles, channels, playlists, and download content — all powered by the eaf_base_api networking engine.

YouPorn API

v1.8

A fully asynchronous high-speed Python API wrapper and scraper for YouPorn. Fetch video details, custom collections, publisher channels, user uploads, and pornstar metadata. Supports dual streaming modes (HLS and raw MP4). Powered by the eaf_base_api networking engine.

Shared capabilities

Async by default

Built around asyncio with bounded page and item concurrency.

Typed lazy models

Load only the media sources and fields required by your workflow.

Explicit networking

Configure retries, proxies, TLS impersonation, caching, and request limits per core.

HLS and RAW downloads

Quality selection, bounded workers, cancellation, resume state, and optional remuxing.

Structured results

Typed scrape outcomes expose stage, attempts, source URL, item, and error context.

Unified policies

One iterator configuration controls ordering, retries, loading, and error behavior.

Legal notice

Unofficial software

These packages are independent projects and are not affiliated with or endorsed by the target websites. Users are responsible for complying with applicable laws, terms, and policies.

Support and licensing

Project support

Support maintenance through crypto, PayPal, or Ko-fi.

For commercial licensing or custom integration work, email EchterAlsFakeBS@proton.me.

Reference, without the runaround.

Setup Guides for Popular Coding Tools

Cursor

VS Code (GitHub Copilot / Native MCP)

VS Code Extensions (Cline / Roo Code)

Claude Desktop

Claude Code (CLI)

Windsurf (Codeium)

Zed

Antigravity / Gemini CLI

Core engine

Base API

API wrappers

Beeg API

Eporner API

HQPorner API

MissAV API

PornHub API

Porntrex API

Redtube API

SpankBang API

Thumbzilla API

Tube8 API

XFreeHD API

xHamster API

XNXX API

XVideos API

YouPorn API

No matching packages

Shared capabilities

Async by default

Typed lazy models

Explicit networking

HLS and RAW downloads

Structured results

Unified policies

Legal notice

Support and licensing