dongnelibrary 0.3.11 → 0.3.13

package/.claude/projects/-Users-bob-src-dongnelibrary/memory/MEMORY.md

@@ -0,0 +1,4 @@
+# Memory Index
+
+## Reference
+- [도서관 정보나루 API](reference_data4library_api.md) - data4library.kr API 조사 결과, 도서관 이름으로 위도/경도 조회 가능

package/.claude/projects/-Users-bob-src-dongnelibrary/memory/reference_data4library_api.md

@@ -0,0 +1,106 @@
+---
+name: 도서관 정보나루 API
+description: data4library.kr API 조사 결과 - 도서관 이름으로 위도/경도 조회 가능한 공공 API
+type: reference
+---
+
+## 도서관 정보나루 API (data4library.kr)
+
+국립중앙도서관 운영, 1,588개 도서관 / 1.98억 장서 / 4천만 회원 / 24억 대출 기록 보유.
+
+Base URL: `http://data4library.kr/api/`
+
+### 핵심 엔드포인트: `/api/libSrch`
+
+도서관 이름으로 검색하면 **위도/경도를 바로 반환**. 별도 지오코딩 불필요.
+
+```
+GET http://data4library.kr/api/libSrch?authKey=YOUR_KEY&libName=판교&format=json
+```
+
+#### 요청 파라미터
+
+| 파라미터 | 필수 | 설명 |
+|----------|------|------|
+| `authKey` | O | API 인증키 |
+| `libName` | - | 도서관 이름 (부분 검색 가능) |
+| `region` | - | 지역 코드 (예: "11" = 서울) |
+| `dtl_region` | - | 세부 지역 코드 |
+| `format` | - | `json` 또는 XML(기본값) |
+| `pageNo` | - | 페이지 번호 (기본 1) |
+| `pageSize` | - | 페이지 크기 (기본 10) |
+
+#### 응답 필드
+
+| 필드 | 설명 |
+|------|------|
+| `libCode` | 도서관 코드 |
+| `libName` | 도서관 이름 |
+| `address` | 주소 |
+| `latitude` | 위도 |
+| `longitude` | 경도 |
+| `homepage` | 홈페이지 URL |
+| `tel` | 전화번호 |
+| `closed` | 휴관일 |
+| `operatingTime` | 운영시간 |
+| `BookCount` | 장서 수 |
+
+#### JSON 응답 구조
+
+```json
+{
+  "response": {
+    "request": {...},
+    "resultNum": N,
+    "numFound": N,
+    "libs": [
+      {
+        "lib": {
+          "libCode": "...",
+          "libName": "...",
+          "latitude": "...",
+          "longitude": "...",
+          ...
+        }
+      }
+    ]
+  }
+}
+```
+
+### API 키 발급 절차
+
+1. https://data4library.kr/joinPage 에서 회원가입
+2. 로그인 → 마이페이지 → 인증키 메뉴
+3. 이용 목적 선택 후 신청
+4. 다음 영업일 오전 승인
+5. 문의: libdata@korea.kr / 02-595-6131
+
+### 호출 제한
+
+| 구분 | 일 호출 한도 |
+|------|-------------|
+| 기본 | 500건/일 |
+| 서버 IP 등록 시 | 30,000건/일 |
+
+2023년 11월 20일부터 무제한 접근 중단, 최대 30,000건/일.
+
+### 기타 유용한 엔드포인트 (18개 중 주요 항목)
+
+| 엔드포인트 | 설명 |
+|------------|------|
+| `/api/libSrch` | 도서관 검색 (위치, 연락처 등) |
+| `/api/extends/libSrch` | 도서관 정보 + 대출 트렌드 통합 |
+| `/api/bookExist` | 특정 도서관 도서 소장 여부 |
+| `/api/libSrchByBook` | ISBN으로 소장 도서관 검색 |
+| `/api/srchBooks` | 키워드 도서 검색 |
+| `/api/srchDtlList` | 도서 상세 (서지, 표지, 대출통계) |
+| `/api/loanItemSrch` | 인기 대출 도서 (성별, 연령, 지역별) |
+| `/api/hotTrend` | 급상승 대출 도서 (7일 기준) |
+| `/api/usageAnalysisList` | 도서 이용 분석 |
+
+### 이 프로젝트와의 관계
+
+- 현재 코드베이스에 190+개 도서관이 `LibraryInfo { code, name }` 으로만 저장됨
+- `/api/libSrch`로 한 번 일괄 조회하여 좌표를 캐싱하면 지도 기능 구현 가능
+- 500건/일이면 전체 도서관 좌표를 하루 만에 수집 가능

package/.claude/settings.local.json

@@ -3,7 +3,16 @@
     "allow": [
       "WebFetch(domain:lib.ice.go.kr)",
       "mcp__playwright__browser_fill_form",
-      "mcp__playwright__browser_click"
+      "mcp__playwright__browser_click",
+      "WebFetch(domain:lib.wonju.go.kr)",
+      "mcp__chrome-devtools__new_page",
+      "mcp__chrome-devtools__take_screenshot",
+      "mcp__chrome-devtools__fill",
+      "mcp__chrome-devtools__take_snapshot",
+      "mcp__chrome-devtools__click",
+      "mcp__chrome-devtools__wait_for",
+      "mcp__chrome-devtools__evaluate_script",
+      "mcp__chrome-devtools__close_page"
     ]
   }
 }

package/API.md

@@ -1,6 +1,6 @@
 # DongneLibrary API Reference
 
-A JavaScript/TypeScript library for checking book availability across 180+ Korean public library branches.
+A JavaScript/TypeScript library for checking book availability across 190+ Korean public library branches.
 
 ## Installation
 
@@ -192,7 +192,7 @@ Returns an array of all supported library branch names.
 
 #### Returns
 
-`string[]` - Array of library names (180+ branches)
+`string[]` - Array of library names (190+ branches)
 
 #### Example
 
@@ -244,6 +244,54 @@ console.log(modules);
 
 ---
 
+### getLibraryNamesInModule(moduleName)
+
+Returns an array of library branch names belonging to a specific module.
+
+#### Parameters
+
+| Parameter    | Type     | Required | Description              |
+| ------------ | -------- | -------- | ------------------------ |
+| `moduleName` | `string` | Yes      | Module name to look up   |
+
+#### Returns
+
+`string[]` - Array of library branch names in the module
+
+#### Example
+
+```javascript
+const libs = dongnelibrary.getLibraryNamesInModule("성남시도서관");
+console.log(libs);
+// ['논골도서관', '중원어린이도서관', '성남중앙도서관', '분당도서관', ...]
+```
+
+---
+
+### resolveLibraryCount(libraryName)
+
+Returns the number of libraries that will be searched for the given name(s).
+
+#### Parameters
+
+| Parameter     | Type                 | Required | Description                                         |
+| ------------- | -------------------- | -------- | --------------------------------------------------- |
+| `libraryName` | `string \| string[]` | Yes      | Library name(s). Use `''` for all libraries         |
+
+#### Returns
+
+`number` - Number of libraries that will be searched
+
+#### Example
+
+```javascript
+dongnelibrary.resolveLibraryCount("");            // 193 (all libraries)
+dongnelibrary.resolveLibraryCount("성남시도서관"); // 18 (all branches in module)
+dongnelibrary.resolveLibraryCount("판교도서관");   // 1
+```
+
+---
+
 ### isModuleName(name)
 
 Checks if a given name is a library system module name.
@@ -337,26 +385,37 @@ type SearchCompleteCallback = (
 | `yongin` | 용인시도서관                   | Yongin City       |
 | `jeju`   | 제주시도서관                   | Jeju City         |
 
-Use `getAllLibraryNames()` to see all 180+ individual branch names.
+Use `getAllLibraryNames()` to see all 190+ individual branch names.
 
 ---
 
 ## CLI Usage
 
 ```bash
-# Interactive mode
+# Interactive mode (default - no arguments needed)
+npx dongnelibrary
+
+# Interactive mode (explicit)
 npx dongnelibrary -i
 
-# Interactive mode (choose by library system)
-npx dongnelibrary -m
+# List all libraries grouped by module
+npx dongnelibrary -a
 
 # Search specific library
 npx dongnelibrary -t "해리포터" -l "판교도서관"
 
-# Search all libraries
-npx dongnelibrary -t "해리포터" -a
+# Quick search with combined query
+npx dongnelibrary -q "판교 해리포터"
+
+# Search multiple libraries
+npx dongnelibrary -q "판교,정자 해리포터"
 ```
 
+The interactive mode prompts for book title first, then lets you choose a search scope:
+- Search all libraries
+- Search by library system (10 modules)
+- Search by library name (autocomplete)
+
 See `dongnelibrary --help` for all options.
 
 ---

package/README.md

@@ -18,8 +18,8 @@
     npm ci
     npm run build
 
+    node ./dist/cli.js
     node ./dist/cli.js -i
-    node ./dist/cli.js -m
     node ./dist/cli.js -a
     node ./dist/cli.js -t 별 -l 남양
     node ./dist/cli.js -t 별 -l 흥천,판교
@@ -31,8 +31,8 @@
 ## Install with npm and Run
 
     npm install dongnelibrary@latest -g
+    dongnelibrary
     dongnelibrary -i
-    dongnelibrary -m
     dongnelibrary -a
     dongnelibrary -t 별 -l 남양
     dongnelibrary -t 별 -l 흥천,판교
@@ -44,8 +44,8 @@
 
 ## Run with npx
 
+    npx dongnelibrary
     npx dongnelibrary -i
-    npx dongnelibrary -m
     npx dongnelibrary -a
     npx dongnelibrary -t 별 -l 남양
     npx dongnelibrary -t 별 -l 흥천,판교
@@ -61,8 +61,8 @@
 
 ### run examples
 
+    docker run -it --rm ghcr.io/afrontend/dongnelibrary
     docker run -it --rm ghcr.io/afrontend/dongnelibrary -i
-    docker run -it --rm ghcr.io/afrontend/dongnelibrary -m
     docker run --rm ghcr.io/afrontend/dongnelibrary -a
     docker run --rm ghcr.io/afrontend/dongnelibrary -t 별 -l 남양
     docker run --rm ghcr.io/afrontend/dongnelibrary -t 별 -l 흥천,판교
@@ -77,8 +77,8 @@
 
 ### run examples
 
+    docker run -it dongnelibrary
     docker run -it dongnelibrary -i
-    docker run -it dongnelibrary -m
     docker run dongnelibrary -a
     docker run dongnelibrary -t 별 -l "남양"
     docker run dongnelibrary -t 별 -l "흥천,판교"
@@ -152,6 +152,7 @@ console.log(results.length + " 개의 도서관을 검색했습니다.");
 - [용인시도서관][yongin-url] (수지도서관,구갈희망누리도서관,구성도서관,기흥도서관,남사도서관,동백도서관,동천도서관,모현도서관,보라도서관,상현도서관,서농도서관,성복도서관,용인중앙도서관,양지해밀도서관,영덕도서관,이동꿈틀도서관,죽전도서관,청덕도서관,포곡도서관,흥덕도서관,기흥동행정복지센터스마트도서관,기흥역스마트도서관,동천동행정복지센터스마트도서관,마북동행정복지센터스마트도서관,보정동행정복지센터스마트도서관,상갈동행정복지센터스마트도서관,상하동행정복지센터스마트도서관,성복역스마트도서관,시청스마트도서관,신봉동행정복지센터스마트도서관,역북동행정복지센터스마트도서관,용인중앙시장역스마트도서관,원삼면스마트도서관,유방어린이공원스마트도서관,죽전역스마트도서관,고림다온작은도서관,남사맑은누리작은도서관,백암면작은도서관,상현1동작은도서관,상현2동작은도서관,이동천리작은도서관)
 - [여주시립도서관][yjlib-url] (여주도서관,세종도서관,점동도서관,여주기적의도서관,흥천도서관,금사도서관,대신도서관,산북작은도서관,북내작은도서관,여주역스마트도서관,이마트스마트도서관)
 - [제주시도서관][jeju-url] (한라도서관,우당도서관,탐라도서관,제주시기적의도서관,애월도서관,조천읍도서관,한경도서관,삼매봉도서관,중앙도서관,동부도서관,서부도서관,서귀포기적의도서관,성산일출도서관,안덕산방도서관,표선도서관,꿈바당어린이도서관)
+- [원주시립통합도서관][wonju-url] (시립중앙도서관,중천철학도서관,미리내도서관,태장도서관,샘마루도서관,그림책도서관,생각자람어린이도서관,귀래면작은도서관,원주한도시한책읽기도서관,개운동작은도서관,치악산새마을문고작은도서관,무실동작은도서관,문막읍작은도서관,봉산동작은도서관,도란도란청소년도서관,부론면작은도서관)
 
 ## 마무리
 
@@ -172,6 +173,7 @@ console.log(results.length + " 개의 도서관을 검색했습니다.");
     npm run yjlib   # 여주시 도서관
     npm run yongin  # 용인시 도서관
     npm run jeju    # 제주시 도서관
+    npm run wonju   # 원주시 도서관
 
 [dongnelibraryspa]: https://github.com/afrontend/dongnelibraryspa "AngularJS, Foundation을 사용한 Web UI"
 [npm-image]: https://img.shields.io/npm/v/dongnelibrary.svg
@@ -188,3 +190,4 @@ console.log(results.length + " 개의 도서관을 검색했습니다.");
 [yjlib-url]: https://www.yjlib.go.kr
 [ice-url]: https://lib.ice.go.kr/
 [jeju-url]: https://www.jeju.go.kr/
+[wonju-url]: https://lib.wonju.go.kr/