4PDA MCP

MCP-Server, der die 4PDA-Foren-Lofi-(Text-)Version ohne Browser bereitstellt. Verwendet impit, um Cloudflares TLS-Herausforderung zu überwinden.

Warum Lofi?

Die Lofi-/Text-Version ist ~50x kleiner als die vollständige Seite und hat ein stabiles, einfaches Markup – ideal für die Nutzung durch LLMs. Die vollwertige Version (?act=idx, ?showforum=, ?showtopic=) ist stark JavaScript-lastig und durch Cloudflare abgeschirmt.

Related MCP server: Reddit MCP Server

URL-Konventionen (ermittelt)

4PDA hat den Lofi-Zugang geändert. lofiversion/index.php?index.html liefert inzwischen 404. Das aktuelle Format ist:

• lofiversion/index.php?f{forum_id}.html — eine Forumsseite (Unterforen + Themenliste)

• lofiversion/index.php?t{topic_id}.html — Themenseite 1

• lofiversion/index.php?t{topic_id}-{offset}.html — Themenseite N, Schritt 20

• index.php?act=idx — vollständiger Index, dient nur zum Auflisten der obersten Kategorien

Der angeheftete Kopfbeitrag wiederholt sich auf jeder Themenseite; dieser Server lässt ihn ab Seite ≥ 2 weg.

Werkzeuge

• list_forums(forum_id?) — die obersten Kategorien, wenn forum_id weggelassen wird, andernfalls die Unterforen (und eine Themenübersicht) eines Forums als flache Liste. Gibt einen Baum zurück, den der Client verschachteln kann.

• list_topics(forum_id) — Themen in einem Forum: id, title, replies, is_important.

• list_posts(topic_id, page=1) — Beiträge auf einer Seite: author, date, html (mit internen Links, wenn möglich auf Lofi-Form umgeschrieben). Kopfbeitrag wird ab Seite ≥ 2 weggelassen.

Ausführen

pip install -e .
4pda-mcp            # stdio MCP server
# or: mcp run src/fourpda_mcp/server.py

Kein Browser, keine Authentifizierung (nur öffentliche Inhalte). impit gibt sich als Chrome aus, um Cloudflare zu passieren.

Ratenbegrenzung

4PDA stellt den Lofi-Endpunkt hinter Cloudflare; dieser ist nicht gecacht, daher erreicht jede Anfrage den Ursprungsserver und Cloudflare begrenzt die Rate. Das Limit ist nicht veröffentlicht; es wurde empirisch gemessen (Aug 2026):

Der Server bleibt weit unterhalb der Auslöseschwelle, indem er einen Mindestabstand zwischen Anfragen erzwingt (FOURPDA_MIN_INTERVAL, Standard 1.0 – d. h. 1 Anfrage/s, ein 2-facher Sicherheitsabstand unter den bestätigt sicheren 2 Anfragen/s). Sollte weiterhin ein 429 auftreten, zeichnet der Server die Retry-After-Abkühlung auf und liefert, ohne weitere Anfragen zu senden, bei jedem Tool-Aufruf eine strukturierte rate_limited-Payload:

{"rate_limited": true, "retry_after_seconds": 3600,
 "retry_at_utc": "2026-08-24T23:00:00Z",
 "hint": "4PDA is rate-limiting requests. Retry after 3600s."}

Diese wird als normales (kein Fehler-)Ergebnis zurückgegeben, sodass der Agent retry_after_seconds lesen und warten kann, statt einen blockierten Endpunkt zu überlasten. Die Abkühlzeit ist auf eine Stunde begrenzt, damit ein anomales Retry-After den Prozess nicht einfrieren kann.