4PDA MCP

无需浏览器即可访问 4PDA 论坛的 lofi（文本）版本。它使用 impit 来通过 Cloudflare 的 TLS 质询。

为什么用 lofi？

lofi/文本版本比完整页面小约 50 倍，并且标记稳定、简单，非常适合 LLM 消费。而完整页面（?act=idx、?showforum=、?showtopic=）重度依赖 JS，且受 Cloudflare 防护门槛限制。

Related MCP server: Reddit MCP Server

URL 约定（已探明）

4PDA 更改了 lofi 入口。lofiversion/index.php?index.html 现在返回 404。当前实际格式是：

• lofiversion/index.php?f{forum_id}.html — 论坛页面（子论坛 + 主题列表）

• lofiversion/index.php?t{topic_id}.html — 主题第 1 页

• lofiversion/index.php?t{topic_id}-{offset}.html — 主题第 N 页，步长 20

• index.php?act=idx — 完整索引，仅用于枚举顶级分类

置顶的头部帖会在每个主题页上重复出现；此服务器在页数 ≥ 2 时会将其丢弃。

工具

• list_forums(forum_id?) — 当省略 forum_id 时返回顶级分类，否则将该论坛的子论坛（以及主题摘要）作为平面列表返回。它返回一个客户端可嵌套的树。

• list_topics(forum_id) — 某个论坛中的主题：id、标题、回复数、is_important。

• list_posts(topic_id, page=1) — 页面上的帖子：作者、日期、html（内部链接在可行的情况下改写为 lofi 形式）。在页数 ≥ 2 时丢弃置顶帖。

运行

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

无需浏览器，无需认证（只读公开内容）。impit 模拟 Chrome 以通过 Cloudflare。

速率限制

4PDA 使用 Cloudflare 作为 lofi 接口的前端；由于没有缓存，每次请求都会到达源服务器，并触发 Cloudflare 的速率限制。限制数值未公开，只能实测（2026 年 8 月）：

服务器通过强制设置最小请求间隔（FOURPDA_MIN_INTERVAL，默认 1.0——即 1 请求/秒，在确认安全的 2 请求/秒之下保留 2 倍余量）来保持在触达该阈值之下。如果仍然发生 429，服务器会记录 Retry-After 冷却时间，并在不再发送任何请求的情况下，从每个工具调用返回结构化的 rate_limited 负载：

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

这将作为正常（非错误）结果返回，因此代理可以读取 Retry_Affer（即 retry_after_seconds）并等待刷新，而不是反复冲击被封锁的接口。冷却时间上限为 1 小时，这样异常的 Retry-After 就不会冻结进程。