4PDA MCP

MCP-сервер, предоставляющий доступ к lofi (текстовой версии) форума 4PDA без браузера. Использует impit для прохождения TLS-вызова Cloudflare.

Зачем 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 — первая страница темы

• 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, title, replies, 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 закрывает lofi-эндпоинт Cloudflare; он не кэшируется, поэтому каждый запрос попадает на origin, и Cloudflare ограничивает частоту. Лимит не публикуется; измерен эмпирически (авг. 2026):

Сервер держится значительно ниже порога срабатывания, придерживаясь минимального интервала между запросами (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_after_seconds и подождать, а не долбить заблокированный эндпоинт. Ограничение кулдауна — один час, чтобы аномальный Retry-After не заморозил процесс.