dongnelibrary 0.3.10 → 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

@@ -0,0 +1,18 @@
+{
+  "permissions": {
+    "allow": [
+      "WebFetch(domain:lib.ice.go.kr)",
+      "mcp__playwright__browser_fill_form",
+      "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/.playwright-mcp/console-2026-03-11T12-40-15-835Z.log

@@ -0,0 +1 @@
+[    8436ms] [ERROR] Failed to load resource: the server responded with a status of 404 (Not Found) @ https://lib.ice.go.kr/favicon.ico:0

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,15 +244,63 @@ 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.
 
 #### Parameters
 
-| Parameter | Type     | Required | Description            |
-| --------- | -------- | -------- | ---------------------- |
-| `name`    | `string` | Yes      | Name to check          |
+| Parameter | Type     | Required | Description   |
+| --------- | -------- | -------- | ------------- |
+| `name`    | `string` | Yes      | Name to check |
 
 #### Returns
 
@@ -324,38 +372,50 @@ type SearchCompleteCallback = (
 
 ## Supported Library Systems
 
-| Module   | Library System     | Region            |
-| -------- | ------------------ | ----------------- |
-| `gg`     | 경기교육통합도서관 | Gyeonggi Province |
-| `gunpo`  | 군포시도서관       | Gunpo City        |
-| `hscity` | 화성시립도서관     | Hwaseong City     |
-| `osan`   | 오산시도서관       | Osan City         |
-| `snlib`  | 성남시도서관       | Seongnam City     |
-| `suwon`  | 수원시도서관       | Suwon City        |
-| `yjlib`  | 여주시립도서관     | Yeoju City        |
-| `yongin` | 용인시도서관       | Yongin City       |
-| `jeju`   | 제주시도서관       | Jeju City         |
-
-Use `getAllLibraryNames()` to see all 180+ individual branch names.
+| Module   | Library System                 | Region            |
+| -------- | ------------------------------ | ----------------- |
+| `gg`     | 경기교육통합도서관             | Gyeonggi Province |
+| `gunpo`  | 군포시도서관                   | Gunpo City        |
+| `hscity` | 화성시립도서관                 | Hwaseong City     |
+| `ice`    | 인천광역시교육청통합공공도서관 | Incheon City      |
+| `osan`   | 오산시도서관                   | Osan City         |
+| `snlib`  | 성남시도서관                   | Seongnam City     |
+| `suwon`  | 수원시도서관                   | Suwon City        |
+| `yjlib`  | 여주시립도서관                 | Yeoju City        |
+| `yongin` | 용인시도서관                   | Yongin City       |
+| `jeju`   | 제주시도서관                   | Jeju City         |
+
+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 "흥천,판교"
@@ -145,12 +145,14 @@ console.log(results.length + " 개의 도서관을 검색했습니다.");
 - [경기교육통합도서관][gg-url] (경기중앙교육도서관,경기평택교육도서관,경기광주교육도서관,경기여주가남교육도서관,경기포천교육도서관,경기김포교육도서관,경기과천교육도서관,경기성남교육도서관,경기화성교육도서관,경기의정부교육도서관,경기평생교육학습관)
 - [군포시도서관][gunpo-url] (산본도서관,당동도서관,대야도서관,어린이도서관,이동도서관,군포중앙도서관,누리천문대,시청북카페밥상머리,부곡도서관,당정문화도서관,동화나무어린이도서관,금정작은도서관,재궁꿈나무도서관,궁내동작은도서관,노루목작은도서관,버드나무에부는바람작은도서관,꿈쟁이도서관,우리마을도서관,북카페사랑아이엔지,산본역도서관,하늘정원작은도서관,꿈이지,꿈드림작은도서관,여담작은도서관)
 - [성남시도서관][snlib-url] (논골도서관,중원어린이도서관,성남중앙도서관,분당도서관,고등도서관,구미도서관,해오름도서관,중원도서관,무지개도서관,수내도서관,판교도서관,위례도서관,수정도서관,책테마파크도서관,운중도서관,서현도서관,복정도서관,판교어린이도서관)
+- [인천광역시교육청통합공공도서관][ice-url] (인천광역시교육청계양도서관,인천광역시교육청부평도서관,인천광역시교육청서구도서관,인천광역시교육청신트리도서관,인천광역시교육청연수도서관,인천광역시교육청주안도서관,인천광역시교육청중앙도서관,인천광역시교육청평생학습관도서관,인천광역시교육청화도진도서관)
 - [오산시도서관][osan-url] (오산중앙도서관,꿈두레도서관,초평도서관,햇살마루도서관,청학도서관,양산도서관,소리울도서관,무지개도서관,고현초꿈키움도서관,쌍용예가시민개방도서관)
 - [화성시립도서관][hscity-url] (남양도서관,태안도서관,삼괴도서관,병점도서관,샘내도서관,두빛나래어린이도서관,봉담도서관,둥지나래어린이도서관,목동이음터도서관,기아행복마루도서관,화성동탄중앙도서관,송산도서관,정남도서관,비봉도서관,진안도서관,중앙이음터도서관,양감도서관,다원이음터도서관,송린이음터도서관,팔탄도서관,마도도서관,봉담커피앤북도서관,왕배푸른숲도서관,노을빛도서관,서연이음터도서관,호연이음터도서관,향남복합문화센터도서관,봉담와우도서관,늘봄이음터도서관,달빛나래어린이도서관)
 - [수원시도서관][suwon-url] (선경도서관,수원중앙도서관,창룡도서관,화서다산도서관,호매실도서관,서수원도서관,한림도서관,버드내도서관,북수원도서관,대추골도서관,일월도서관,광교홍재도서관,태장마루도서관,광교푸른숲도서관,매여울도서관,망포글빛도서관,슬기샘도서관,지혜샘어린이도서관,바른샘어린이도서관,한아름도서관,반달어린이도서관,사랑샘도서관,희망샘도서관)
 - [용인시도서관][yongin-url] (수지도서관,구갈희망누리도서관,구성도서관,기흥도서관,남사도서관,동백도서관,동천도서관,모현도서관,보라도서관,상현도서관,서농도서관,성복도서관,용인중앙도서관,양지해밀도서관,영덕도서관,이동꿈틀도서관,죽전도서관,청덕도서관,포곡도서관,흥덕도서관,기흥동행정복지센터스마트도서관,기흥역스마트도서관,동천동행정복지센터스마트도서관,마북동행정복지센터스마트도서관,보정동행정복지센터스마트도서관,상갈동행정복지센터스마트도서관,상하동행정복지센터스마트도서관,성복역스마트도서관,시청스마트도서관,신봉동행정복지센터스마트도서관,역북동행정복지센터스마트도서관,용인중앙시장역스마트도서관,원삼면스마트도서관,유방어린이공원스마트도서관,죽전역스마트도서관,고림다온작은도서관,남사맑은누리작은도서관,백암면작은도서관,상현1동작은도서관,상현2동작은도서관,이동천리작은도서관)
 - [여주시립도서관][yjlib-url] (여주도서관,세종도서관,점동도서관,여주기적의도서관,흥천도서관,금사도서관,대신도서관,산북작은도서관,북내작은도서관,여주역스마트도서관,이마트스마트도서관)
 - [제주시도서관][jeju-url] (한라도서관,우당도서관,탐라도서관,제주시기적의도서관,애월도서관,조천읍도서관,한경도서관,삼매봉도서관,중앙도서관,동부도서관,서부도서관,서귀포기적의도서관,성산일출도서관,안덕산방도서관,표선도서관,꿈바당어린이도서관)
+- [원주시립통합도서관][wonju-url] (시립중앙도서관,중천철학도서관,미리내도서관,태장도서관,샘마루도서관,그림책도서관,생각자람어린이도서관,귀래면작은도서관,원주한도시한책읽기도서관,개운동작은도서관,치악산새마을문고작은도서관,무실동작은도서관,문막읍작은도서관,봉산동작은도서관,도란도란청소년도서관,부론면작은도서관)
 
 ## 마무리
 
@@ -164,12 +166,14 @@ console.log(results.length + " 개의 도서관을 검색했습니다.");
     npm run gg      # 경기도 도서관
     npm run gunpo   # 군포시 도서관
     npm run hscity  # 화성시 도서관
+    npm run ice     # 인천시 도서관
     npm run osan    # 오산시 도서관
     npm run snlib   # 성남시 도서관
     npm run suwon   # 수원시 도서관
     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
@@ -184,4 +188,6 @@ console.log(results.length + " 개의 도서관을 검색했습니다.");
 [suwon-url]: https://www.suwonlib.go.kr
 [yongin-url]: https://lib.yongin.go.kr
 [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/