# NPM 배포 가이드

## 📦 v2.1.0 배포 준비 완료!

### 변경 사항 요약

#### 버전 업그레이드
- **v2.0.4** → **v2.1.0** (메이저 기능 추가)

#### 새로운 파일들
```
✅ shared/local_quality_assessor.py   (12.6 KB)
✅ shared/local_query_refiner.py      (11.9 KB)  
✅ shared/__init__.py
✅ plugins/deep_research_plugin.py    (11.8 KB)
✅ CHANGELOG.md                       (전체 변경 이력)
✅ DEEP_RESEARCH_README.md            (상세 가이드)
✅ test_deep_research.py              (테스트)
✅ .npmignore                         (배포 제외 파일)
```

#### 업데이트된 파일들
```
✅ package.json    (v2.1.0, 키워드 추가)
✅ README.md       (Deep Research 섹션 추가)
✅ requirements.txt (scikit-learn 추가)
✅ enhanced_crawler.py (crawl_with_depth 메서드)
```

---

## 🚀 배포 절차

### 1단계: NPM 로그인 확인

```bash
cd C:/Users/damin/searxng-mcp-server/searxng-mcp-crawl
npm whoami
```

만약 로그인이 안 되어 있다면:
```bash
npm login
```

### 2단계: 패키지 테스트 (선택사항)

```bash
# 로컬 테스트
npm pack

# 결과: otbossam-searxng-mcp-server-2.1.0.tgz
```

### 3단계: 배포 전 체크리스트

- [x] ✅ 버전 업데이트 (2.0.4 → 2.1.0)
- [x] ✅ CHANGELOG.md 작성
- [x] ✅ README.md 업데이트
- [x] ✅ .npmignore 설정
- [x] ✅ 모든 테스트 통과
- [x] ✅ package.json 키워드 추가
- [ ] ⏳ Git commit & push (권장)
- [ ] ⏳ NPM publish

### 4단계: Git에 커밋 (권장)

```bash
git add .
git commit -m "feat: Add Deep Research v2.1.0 - 100% privacy-focused intelligent search

- Add local quality assessment (TF-IDF + heuristics)
- Add intelligent query refinement (rule-based)
- Add recursive web crawling (depth 0-5)
- Add hybrid research strategy (adaptive)
- Add comprehensive documentation
- Update package.json to v2.1.0
- Add CHANGELOG.md
"

git push origin main
```

### 5단계: NPM에 배포

```bash
# 배포 (공개 패키지)
npm publish --access public

# 또는 스코프 패키지로 (현재 @otbossam/searxng-mcp-server)
npm publish
```

### 6단계: 배포 확인

```bash
# NPM에서 확인
npm view @otbossam/searxng-mcp-server

# 버전 확인
npm view @otbossam/searxng-mcp-server versions
```

---

## 📝 배포 후 테스트

### 사용자 입장에서 설치 테스트

```bash
# 글로벌 설치
npm install -g @otbossam/searxng-mcp-server@2.1.0

# npx로 실행
npx @otbossam/searxng-mcp-server@2.1.0
```

### Python 의존성 확인

```bash
pip install scikit-learn>=1.3.0
```

---

## 🔖 배포 명령어 (한 줄)

```bash
cd C:/Users/damin/searxng-mcp-server/searxng-mcp-crawl && npm publish --access public
```

---

## 📊 예상 패키지 크기

```
전체 크기: ~200-300 KB
├── Python 파일: ~150 KB
├── JavaScript 파일: ~10 KB
├── 문서 (MD): ~50 KB
└── 설정 파일: ~5 KB
```

---

## ⚠️ 주의사항

### 배포 전 확인
1. **NPM 계정** 확인 (`npm whoami`)
2. **버전 번호** 중복 없음 확인
3. **테스트** 통과 확인
4. **.npmignore** 설정 확인 (불필요한 파일 제외)
5. **README.md** 가독성 확인

### 배포 후
1. **NPM 페이지** 확인: https://www.npmjs.com/package/@otbossam/searxng-mcp-server
2. **설치 테스트**: 다른 환경에서 `npx` 실행
3. **GitHub Release** 생성 (선택사항)

---

## 🎉 배포 완료 후

### 1. NPM 페이지 업데이트
- 패키지 설명 확인
- 키워드 확인
- README 렌더링 확인

### 2. 홍보 (선택사항)
- Reddit r/programming
- Hacker News
- Twitter/X
- LinkedIn

### 3. 사용자 피드백 수집
- GitHub Issues 모니터링
- NPM 다운로드 수 확인
- 사용자 리뷰 확인

---

## 📚 관련 링크

- **NPM 패키지**: https://www.npmjs.com/package/@otbossam/searxng-mcp-server
- **GitHub**: https://github.com/damin25soka7/hi/tree/main/searxng-mcp-crawl
- **문서**: DEEP_RESEARCH_README.md
- **변경 이력**: CHANGELOG.md

---

## 🤔 배포할까요?

**준비 완료!** 위 명령어를 실행하면 v2.1.0이 NPM에 배포됩니다.

배포 전 마지막 확인:
```bash
# 파일 구조 확인
npm pack --dry-run

# 실제 배포
npm publish --access public
```

**배포하시겠습니까?** 😊