naver-blog-importer

naver-blog-importer

네이버 블로그를 통째로 마크다운으로 내려받는 Claude Code 플러그인. 이미지도 포함해서 로컬에 저장한다. Obsidian vault, 정적 사이트, 위키 이관용.

• SmartEditor 2.0 (.se-main-container) / 레거시 에디터 (#postViewArea) 둘 다 지원
• 모바일 URL(m.blog.naver.com) 사용 — 데스크톱 iframe 우회
• 이미지 원본 해상도로 다운로드 (?type=w80 리사이즈 파라미터 제거)
• Idempotent — 재실행하면 이미 받은 글은 SKIP
• 기본 속도 제한: 1 req/sec + 0.3–0.8s 지터

Installation

Marketplace

/plugin marketplace add lazyyoyo/naver-blog-importer
/plugin install naver-blog-importer@naver-blog-importer

Manually

git clone https://github.com/lazyyoyo/naver-blog-importer.git \
  ~/.claude/plugins/naver-blog-importer

CLI only (Claude Code 없이)

git clone https://github.com/lazyyoyo/naver-blog-importer.git
cd naver-blog-importer/skills/naver-blog-importer
pip install -r requirements.txt
python scripts/import_blog.py <blogId>

파이썬 의존성(requests, beautifulsoup4, markdownify)은 스킬 첫 실행 때 Claude가 자동으로 설치한다. 수동으로 깔고 싶으면 pip install -r skills/naver-blog-importer/requirements.txt.

사용

설치하면 끝. 두 가지 방식 모두 동작.

slash 명령

/naver-blog-importer myblog
/naver-blog-importer blog.naver.com/myblog
/naver-blog-importer myblog --category-no 7 --out ./out
/naver-blog-importer myblog --list-only

/naver-blog-importer 뒤로 오는 인자가 그대로 스킬에 전달된다. 옵션은 아래 CLI 섹션과 동일.

자연어

나: blog.naver.com/myblog 통째로 가져와줘
나: 네이버 블로그 myblog 마크다운으로 백업해줘
나: myblog 블로그에서 처음 10개만 ./out 에 저장

Claude가 스킬을 인식해서 적절한 옵션으로 돌리고 결과 디렉토리를 알려준다.

blogId는 blog.naver.com/ 뒤에 오는 값 (예: blog.naver.com/myblog → myblog).

CLI 옵션

# 포스트 목록만 (다운로드 X)
python scripts/import_blog.py <blogId> --list-only

# 전부 가져오기
python scripts/import_blog.py <blogId> --out ./naver-import

# 특정 카테고리만
python scripts/import_blog.py <blogId> --category-no 7 --out ./naver-import

# 일부 범위 / 재시도
python scripts/import_blog.py <blogId> --start 0 --limit 50
python scripts/import_blog.py <blogId> --force        # 이미 받은 글도 다시

출력 구조

naver-import/
├── 2024-03-15-포스트제목.md
├── 2024-03-18-다른글.md
└── assets/
    ├── 223123456789/
    │   ├── img_001.jpg
    │   └── img_002.png
    └── 223123456790/
        └── img_001.jpg

파일명: {yyyy-mm-dd}-{slugified-title}.md. 한글 제목 보존, 공백은 -.

한계

• 네이버 지도/장소/책 카드 위젯 → 텍스트 라벨만 남음
• 비디오 임베드(네이버TV, 유튜브) → 링크로 유지 (임베드 X)
• 비공개/이웃공개 글 → 인증 미지원, 스킵
• 댓글 → 가져오지 않음

구조

.claude-plugin/
├── marketplace.json   # 마켓플레이스 메타
└── plugin.json        # 플러그인 메타
skills/
└── naver-blog-importer/
    ├── SKILL.md       # 스킬 본문 (Claude가 읽음)
    ├── requirements.txt
    └── scripts/       # 파서/이미지/메인

자세한 동작과 트러블슈팅은 SKILL.md.

라이선스

MIT