4PDA MCP

브라우저 없이 4PDA 포럼의 lofi(텍스트) 버전을 노출하는 MCP 서버입니다. Cloudflare의 TLS 챌린지를 통과하기 위해 impit을 사용합니다.

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, title, replies, is_important.

• list_posts(topic_id, page=1) — 페이지의 게시물: author, date, 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로 보호합니다. 캐시되지 않으므로 모든 요청이 원본 서버에 도달하고 Cloudflare의 요청 속도 제한을 받습니다. 이 제한은 공개되어 있지 않으며 직접 측정했습니다 (2026년 8월):

서버는 요청 사이의 최소 간격(FOURPDA_MIN_INTERVAL, 기본값 1.0 — 즉, 1 req/s이고, 안전이 확인된 2 req/s에 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를 읽고 차단된 엔드포인트를 두들기지 않고 대기할 수 있습니다. 쿨다운은 최대 1시간이므로, 비정상적인 Retry-After 값으로 프로세스가 멈추지 않습니다.