Fantia에서 운영하는 팬클럽의 게시물과 첨부 미디어를 오프라인에 저장하고 싶다면, 전용 파이썬 스크립트를 이용하면 단 몇 분 만에 설정을 마칠 수 있다. 이 도구는 HTTP 세션 정보를 활용해 로그인된 사용자만 접근 가능한 콘텐츠를 수집하며, 반복 다운로드를 방지하고 다양한 필터 옵션을 제공한다.
핵심 장점
- 간단한 사용법 – 브라우저에서 복사한 세션 ID만 있으면 복잡한 인증 절차 없이 다운로드 가능
- 중복 방지 데이터베이스 – 내부 SQLite 기반 기록으로 이미 받은 파일은 자동으로 건너뛰어 저장 공간과 시간을 절약
- 세분화된 제어 – 게시물 개수 제한, 출력 폴더 지정, 최신 콘텐츠만 가져오기 등 세부 설정 지원
환경 구성
Python 3.8 이상이 설치된 환경을 권장한다. 필요한 패키지는 requirements.txt를 통해 한 번에 설치할 수 있다.
# 저장소 클론 또는 압축 파일 다운로드
git clone <repository-url>
cd fantiadl
# 의존성 설치
pip install -r requirements.txt
세션 ID 확보 방법
- 웹 브라우저에서 Fantia 계정에 로그인한다.
- 개발자 도구(F12)를 열고 ‘Application’ 또는 ‘Storage’ 탭으로 이동한다.
- Cookies 목록에서
_session_id값을 찾아 복사한다.
기본 다운로드 명령
복사한 세션 ID와 대상 팬클럽 URL을 지정하면 스크립트가 게시물과 미디어를 자동으로 가져온다.
python fantiadl.py --session-id "YOUR_SESSION" --target "FANCLUB_URL"
고급 옵션
상황에 따라 아래와 같은 인수를 추가해 워크플로를 최적화할 수 있다.
# 최근 7개 게시물만 다운로드
python fantiadl.py --session-id "YOUR_SESSION" --target "FANCLUB_URL" --limit 7
# 저장 경로 변경
python fantiadl.py --session-id "YOUR_SESSION" --target "FANCLUB_URL" --outdir "./fantia_backup"
# 이전에 받지 않은 새 콘텐츠만 처리
python fantiadl.py --session-id "YOUR_SESSION" --target "FANCLUB_URL" --fresh-only
--export-external 플래그를 사용하면 외부 링크가 포함된 게시물을 .crawljob 파일로 추출하여 JDownloader 같은 전용 다운로드 관리자와 연동할 수도 있다.
python fantiadl.py --session-id "YOUR_SESSION" --target "FANCLUB_URL" --export-external
자주 발생하는 문제 해결
- 세션 ID를 찾을 수 없음 – 정상적으로 로그인된 상태에서 쿠키를 다시 확인하고, 브라우저별 쿠키 저장 위치(예: Chrome의 경우 Application → Cookies)를 점검한다.
- 다운로드 속도가 느릴 때 – 네트워크 사용량이 적은 시간대에 실행하거나, 외부 링크 추출 후 JDownloader의 다중 연결 기능을 활용한다.
- 실행 오류 발생 – Python 버전을 확인하고
pip list로 필수 라이브러리가 설치되었는지 확인한다. 데이터베이스 손상이 의심되면.db파일을 삭제한 후 다시 시도한다.
누구에게 유용한가
- 여러 팬클럽의 미디어를 체계적으로 보관하고 싶은 팬
- 네트워크 연결이 불안정한 환경에서도 좋아하는 크리에이터의 작업물을 보고 싶은 사용자
- 정기적으로 업데이트되는 콘텐츠를 자동 수집하려는 개인 아카이브 운영자
이 도구는 추가 설정 없이도 빠르게 동작하며, 명령줄 옵션만으로 원하는 작업을 세밀하게 조정할 수 있다. 공개된 저장소에서 소스를 받아 직접 빌드하거나 릴리스 페이지의 실행 파일을 사용해 바로 시작해보자.