아임웹 사이트 통째로 다운로드 — 폴더 하나에 받아 오프라인으로 띄우는 Claude Code 스킬

아임웹(imweb.me)으로 만든 사이트를 옮기거나 백업하려고 하면, 아임웹에는 사이트를 통째로 내보내는 기능이 없습니다. wget 이나 HTTrack 같은 범용 미러링 도구로 받으면 중복 파일이 수천 개 생기고, 정작 게시글 상세는 빠집니다. 이 스킬은 아임웹 구조에 맞춰 사이트를 폴더 하나에 받고, 인터넷 없이 로컬에서 원본처럼 띄웁니다.

왜 만들었나

한 관광안내 사이트(아임웹, 지도형 게시판 사용)를 wget 으로 받아 보니 이런 문제가 나왔습니다.

• 글쓰기·정렬·돌아갈 주소 링크까지 따라가 HTML 이 1,384개 생겼습니다. 실제 페이지는 153개였습니다.
• 파일 이름에 ?1789… 같은 버전 꼬리가 붙어 %3F 로 깨졌습니다.
• 같은 폰트를 다섯 형식으로 약 1,850개 받았습니다.
• 스크롤할 때 불러오는 이미지 176장이 빠졌습니다.
• 가장 큰 문제: 지도형 게시판의 가게 상세는 링크가 아니라 스크립트가 서버에 따로 요청해 받는 구조라, 게시글 상세가 하나도 받히지 않았습니다.

무엇을 하나

실측

검증은 외부 요청을 전부 차단한 헤드리스 브라우저로 했습니다. 메인·목록 이미지 깨짐 0, 카테고리 탭·쪽 이동·게시글 상세 창이 모두 로컬 파일로 동작했습니다.

결과물

posts.csv 에는 게시글 번호, 카테고리, 제목, 주소, 위도·경도, 이미지 경로, 본문 텍스트가 들어갑니다.

구성

설치와 사용

unzip imweb-site-download.zip -d ~/.claude/skills/
pip install requests

# Claude Code 에게
https://example.imweb.me 아임웹 사이트 통째로 받아서 로컬로 띄워줘

# 직접 실행
S=~/.claude/skills/imweb-site-download/scripts/imweb_dl.py
python3 $S download https://example.imweb.me -o ~/imweb-sites
python3 $S serve ~/imweb-sites/example.imweb.me   # http://127.0.0.1:8765/

요구 사항과 한계

• Python 3.9 이상, requests 라이브러리 하나. Claude Code 없이 스크립트만 써도 됩니다.
• 본인 사이트이거나 백업·이전을 맡은 사이트에 쓰세요. 회원 전용·비밀글은 받지 않습니다.
• 네이버 지도 그림은 오프라인에서 나오지 않습니다. 목록과 게시글 상세 창은 동작합니다.
• 게시글 상세를 따로 받는 기능은 지도형 게시판용입니다. 일반 게시판·쇼핑몰은 링크로 열리는 페이지까지 받습니다.