dongnelibrary 0.2.7 → 0.2.9

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "dongnelibrary",
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=18.0.0"
   },
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "책을 빌릴 수 있는지 확인한다.",
   "main": "src/dongnelibrary.js",
   "bin": {
@@ -17,7 +17,8 @@
     "hscity": "mocha test/hscity.spec.js",
     "osan": "mocha test/osan.spec.js",
     "snlib": "mocha test/snlib.spec.js",
-    "suwon": "mocha test/suwon.spec.js"
+    "suwon": "mocha test/suwon.spec.js",
+    "yongin": "mocha test/yongin.spec.js"
   },
   "repository": {
     "type": "git",
@@ -32,7 +33,8 @@
     "성남시도서관",
     "오산시도서관",
     "화성시립도서관",
-    "수원시도서관"
+    "수원시도서관",
+    "용인시도서관"
   ],
   "author": "<autoscripts@gmail.com>",
   "license": "MIT",
@@ -56,6 +58,6 @@
     "jquery": "^3.7.1",
     "jsdom": "^21.1.1",
     "lodash": "^4.17.20",
-    "request": "^2.73.0"
+    "undici": "^6.23.0"
   }
 }

package/src/dongnelibrary.js

@@ -6,6 +6,7 @@ const hscity = require("./library/hscity");
 const osan = require("./library/osan");
 const snlib = require("./library/snlib");
 const suwon = require("./library/suwon");
+const yongin = require("./library/yongin");
 const async = require("async");
 const util = require("./util.js");
 
@@ -14,7 +15,7 @@ const libraryList = [];
 const getLibraryNames = () => util.getLibraryNames(libraryList);
 
 function makeLibraryList() {
-  const library = [gg, gunpo, hscity, osan, snlib, suwon];
+  const library = [gg, gunpo, hscity, osan, snlib, suwon, yongin];
 
   _.each(library, (library) => {
     _.each(library.getLibraryNames(), (name) => {

package/src/http.js

@@ -0,0 +1,109 @@
+const { request } = require("undici");
+
+const DEFAULT_TIMEOUT = 20000;
+const DEFAULT_USER_AGENT =
+  "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36";
+
+async function get(url, options = {}) {
+  const { qs, headers = {}, timeout = DEFAULT_TIMEOUT } = options;
+
+  let fullUrl = url;
+  if (qs && Object.keys(qs).length > 0) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(qs)) {
+      params.append(key, String(value));
+    }
+    fullUrl = `${url}?${params}`;
+  }
+
+  const res = await request(fullUrl, {
+    method: "GET",
+    headersTimeout: timeout,
+    bodyTimeout: timeout,
+    headers: { "User-Agent": DEFAULT_USER_AGENT, ...headers },
+  });
+
+  return { statusCode: res.statusCode, body: await res.body.text() };
+}
+
+async function post(url, options = {}) {
+  const { form, headers = {}, timeout = DEFAULT_TIMEOUT } = options;
+
+  const formData = new URLSearchParams();
+  if (form) {
+    for (const [key, value] of Object.entries(form)) {
+      formData.append(key, String(value));
+    }
+  }
+
+  const res = await request(url, {
+    method: "POST",
+    headersTimeout: timeout,
+    bodyTimeout: timeout,
+    headers: {
+      "User-Agent": DEFAULT_USER_AGENT,
+      "Content-Type": "application/x-www-form-urlencoded",
+      ...headers,
+    },
+    body: formData.toString(),
+  });
+
+  return { statusCode: res.statusCode, body: await res.body.text() };
+}
+
+function createSession() {
+  let cookies = [];
+
+  return {
+    async get(url, options = {}) {
+      const { headers = {}, timeout = DEFAULT_TIMEOUT } = options;
+
+      const res = await request(url, {
+        method: "GET",
+        headersTimeout: timeout,
+        bodyTimeout: timeout,
+        headers: {
+          "User-Agent": DEFAULT_USER_AGENT,
+          Cookie: cookies.join("; "),
+          ...headers,
+        },
+      });
+
+      const setCookie = res.headers["set-cookie"];
+      if (setCookie) {
+        const newCookies = Array.isArray(setCookie) ? setCookie : [setCookie];
+        cookies = [...cookies, ...newCookies.map((c) => c.split(";")[0])];
+      }
+
+      return { statusCode: res.statusCode, body: await res.body.text() };
+    },
+
+    async post(url, options = {}) {
+      const { form, headers = {}, timeout = DEFAULT_TIMEOUT } = options;
+
+      const formData = new URLSearchParams();
+      if (form) {
+        for (const [key, value] of Object.entries(form)) {
+          formData.append(key, String(value));
+        }
+      }
+
+      const res = await request(url, {
+        method: "POST",
+        headersTimeout: timeout,
+        bodyTimeout: timeout,
+        headers: {
+          "User-Agent": DEFAULT_USER_AGENT,
+          "Content-Type": "application/x-www-form-urlencoded",
+          Cookie: cookies.join("; "),
+          ...headers,
+        },
+        body: formData.toString(),
+      });
+
+      return { statusCode: res.statusCode, body: await res.body.text() };
+    },
+  };
+}
+
+module.exports = { get, post, createSession };

package/src/library/gg.js

@@ -1,6 +1,6 @@
 const getLibraryNames = require("../util.js").getLibraryNames;
 const jquery = require("jquery");
-const req = require("request");
+const { get } = require("../http");
 const { JSDOM } = require("jsdom");
 
 const libraryList = [
@@ -22,7 +22,7 @@ function getLibraryCode(libraryName) {
   return found ? found.code : "";
 }
 
-function search(opt, getBook) {
+async function search(opt, getBook) {
   let title = opt.title;
   let libraryName = opt.libraryName;
 
@@ -40,70 +40,70 @@ function search(opt, getBook) {
     return;
   }
 
-  // 'https://lib.goe.go.kr/gg/intro/search/index.do?viewPage=1&search_text=javascript&booktype=BOOKANDNONBOOK&libraryCodes=MB&rowCount=1000',
   const lcode = getLibraryCode(libraryName);
-  req.get(
-    {
-      url: `https://lib.goe.go.kr/gg/intro/search/index.do`,
-      timeout: 20000,
-      qs: {
-        booktype: "BOOKANDNONBOOK",
-        libraryCodes: lcode,
-        rowCount: 1000,
-        search_text: title,
-        viewPage: 1,
-      },
-    },
-    function (err, res, body) {
-      if (err || (res && res.statusCode !== 200)) {
-        let msg = "";
 
-        if (err) {
-          msg = err;
-        }
+  try {
+    const { statusCode, body } = await get(
+      `https://lib.goe.go.kr/gg/intro/search/index.do`,
+      {
+        qs: {
+          booktype: "BOOKANDNONBOOK",
+          libraryCodes: lcode,
+          rowCount: 1000,
+          search_text: title,
+          viewPage: 1,
+        },
+      },
+    );
 
-        if (res && res.statusCode) {
-          msg = msg + " " + res.statusCode;
-        }
+    if (statusCode !== 200) {
+      if (getBook) {
+        getBook({ msg: `HTTP ${statusCode}` });
+      }
+      return;
+    }
 
-        if (getBook) {
-          getBook({ msg: msg });
-        }
-      } else {
-        const dom = new JSDOM(body);
-        const $counter = dom.window.document.querySelector(
-          "#search_result > div.research-box > div.search-info > b",
-        );
-        const count = $counter ? Number($counter.innerHTML) : 0;
-        // const $row = dom.window.document.querySelectorAll('.row .book-title')
-        const $ = jquery(dom.window);
-        const booklist = [];
-        $(".bif").each((_, a) => {
-          const title = $(a).find(".book-title > span").text().trim();
-          const rented = $(a).find(".state.typeC").text().trim();
-          const libraryName = $(a)
-            .find("span:contains('도서관')")
-            .next()
-            .text()
-            .split("|")[0]
-            .trim();
-          if (title) {
-            booklist.push({
-              libraryName,
-              title,
-              maxoffset: count,
-              exist: rented === "대출가능",
-            });
-          }
-        });
-        getBook(null, {
-          startPage: opt.startPage,
-          totalBookCount: count,
-          booklist,
+    const dom = new JSDOM(body);
+    const $counter = dom.window.document.querySelector(
+      "#search_result > div.research-box > div.search-info > b",
+    );
+    const count = $counter ? Number($counter.innerHTML) : 0;
+    const $ = jquery(dom.window);
+    const booklist = [];
+    $(".bif").each((_, a) => {
+      const titleElement = $(a).find(".book-title");
+      const title = titleElement.find("> span").text().trim();
+      const bookPath = titleElement.attr("href");
+      const bookUrl = bookPath
+        ? "https://lib.goe.go.kr/gg/intro/search/" + bookPath
+        : "";
+      const rented = $(a).find(".state.typeC").text().trim();
+      const libraryName = $(a)
+        .find("span:contains('도서관')")
+        .next()
+        .text()
+        .split("|")[0]
+        .trim();
+      if (title) {
+        booklist.push({
+          libraryName,
+          title,
+          bookUrl,
+          maxoffset: count,
+          exist: rented === "대출가능",
         });
       }
-    },
-  );
+    });
+    getBook(null, {
+      startPage: opt.startPage,
+      totalBookCount: count,
+      booklist,
+    });
+  } catch (err) {
+    if (getBook) {
+      getBook({ msg: err.toString() });
+    }
+  }
 }
 
 module.exports = {

package/src/library/gunpo.js

@@ -1,4 +1,4 @@
-const req = require("request");
+const { get } = require("../http");
 const _ = require("lodash");
 const getLibraryNames = require("../util.js").getLibraryNames;
 
@@ -40,11 +40,12 @@ function getBookList(json) {
       title: book.titleStatement,
       exist: book.branchVolumes.some((vol) => vol.cState.includes("대출가능")),
       libraryName: book.branchVolumes.map((vol) => vol.name).join(","),
+      bookUrl: book.id ? `https://www.gunpolib.go.kr/#/book/${book.id}` : "",
     };
   });
 }
 
-function search(opt, getBook) {
+async function search(opt, getBook) {
   let title = opt.title;
   let libraryName = opt.libraryName;
 
@@ -64,44 +65,35 @@ function search(opt, getBook) {
 
   const branch = getLibraryCode(libraryName);
 
-  req.get(
-    {
-      url: "https://www.gunpolib.go.kr/pyxis-api/1/collections/1/search",
-      timeout: 20000,
-      headers: {
-        "User-Agent":
-          "User-Agent:Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.106 Safari/537.36",
+  try {
+    const { statusCode, body } = await get(
+      "https://www.gunpolib.go.kr/pyxis-api/1/collections/1/search",
+      {
+        qs: {
+          all: `k|a|${title}`,
+          branch,
+          max: 1000,
+        },
       },
-      qs: {
-        all: `k|a|${title}`,
-        branch,
-        max: 1000,
-      },
-    },
-    function (err, res, body) {
-      if (err || (res && res.statusCode !== 200)) {
-        let msg = "";
-
-        if (err) {
-          msg = err;
-        }
+    );
 
-        if (res && res.statusCode) {
-          msg = msg + " " + res.statusCode;
-        }
-
-        if (getBook) {
-          getBook({ msg: msg });
-        }
-      } else {
-        const booklist = getBookList(JSON.parse(body));
-        getBook(null, {
-          totalBookCount: booklist.length,
-          booklist,
-        });
+    if (statusCode !== 200) {
+      if (getBook) {
+        getBook({ msg: `HTTP ${statusCode}` });
       }
-    },
-  );
+      return;
+    }
+
+    const booklist = getBookList(JSON.parse(body));
+    getBook(null, {
+      totalBookCount: booklist.length,
+      booklist,
+    });
+  } catch (err) {
+    if (getBook) {
+      getBook({ msg: err.toString() });
+    }
+  }
 }
 
 module.exports = {

package/src/library/hscity.js

@@ -1,6 +1,6 @@
 const getLibraryNames = require("../util.js").getLibraryNames;
 const jquery = require("jquery");
-const req = require("request");
+const { post } = require("../http");
 const { JSDOM } = require("jsdom");
 
 const libraryList = [
@@ -38,7 +38,7 @@ function getLibraryCode(libraryName) {
   return found ? found.code : "";
 }
 
-function search(opt, getBook) {
+async function search(opt, getBook) {
   let title = opt.title;
   let libraryName = opt.libraryName;
 
@@ -57,62 +57,61 @@ function search(opt, getBook) {
   }
 
   const lcode = getLibraryCode(libraryName);
-  // const url=`https://hscitylib.or.kr/intro/menu/10008/program/30001/searchResultList.do?searchType=SIMPLE&searchManageCodeArr=MK&searchKeyword=javascript`
   const url = `https://hscitylib.or.kr/intro/menu/10008/program/30001/searchResultList.do`;
-  req.post(
-    {
-      url,
-      timeout: 20000,
-      headers: {
-        "User-Agent":
-          "User-Agent:Mozilla/5.0 (X11 Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.106 Safari/537.36",
-      },
+
+  try {
+    const { statusCode, body } = await post(url, {
       form: {
         searchType: "SIMPLE",
         searchKeyword: title,
         searchManageCodeArr: lcode,
         searchDisplay: 1000,
       },
-    },
-    function (err, res, body) {
-      if (err || (res && res.statusCode !== 200)) {
-        let msg = "";
+    });
 
-        if (err) {
-          msg = err;
-        }
-
-        if (res && res.statusCode) {
-          msg = msg + " " + res.statusCode;
-        }
+    if (statusCode !== 200) {
+      if (getBook) {
+        getBook({ msg: `HTTP ${statusCode}` });
+      }
+      return;
+    }
 
-        if (getBook) {
-          getBook({ msg });
-        }
-      } else {
-        const dom = new JSDOM(body);
-        const $ = jquery(dom.window);
-        const count = $("#totalCnt").text().match(/\d+/)[0];
-        const booklist = [];
-        $(".bookArea").each((_, a) => {
-          const title = $(a).find("p.book_name.kor.on > a").attr("title");
-          const rented = $(a).find("span.emp8").text().trim();
-          const libraryName = $(a).find("b.themeFC").text().trim();
-          booklist.push({
-            libraryName: libraryName.replace(/[\[\]]/g, ""),
-            title,
-            maxoffset: count,
-            exist: rented.includes("대출가능"),
-          });
-        });
-        getBook(null, {
-          startPage: opt.startPage,
-          totalBookCount: count,
-          booklist,
-        });
+    const dom = new JSDOM(body);
+    const $ = jquery(dom.window);
+    const count = $("#totalCnt").text().match(/\d+/)[0];
+    const booklist = [];
+    $(".bookArea").each((_, a) => {
+      const titleElement = $(a).find("p.book_name.kor.on > a");
+      const title = titleElement.attr("title");
+      const onclick = titleElement.attr("onclick") || "";
+      const match = onclick.match(
+        /fnDetail\('(\d+)',\s*'(\d+)',\s*'([^']*)',\s*'(\w+)'\)/,
+      );
+      let bookUrl = "";
+      if (match) {
+        const [, bookKey, speciesKey, isbn, pubFormCode] = match;
+        bookUrl = `https://hscitylib.or.kr/intro/menu/10008/program/30001/searchResultDetail.do?bookKey=${bookKey}&speciesKey=${speciesKey}&isbn=${isbn}&pubFormCode=${pubFormCode}`;
       }
-    },
-  );
+      const rented = $(a).find("span.emp8").text().trim();
+      const libraryName = $(a).find("b.themeFC").text().trim();
+      booklist.push({
+        libraryName: libraryName.replace(/[\[\]]/g, ""),
+        title,
+        bookUrl,
+        maxoffset: count,
+        exist: rented.includes("대출가능"),
+      });
+    });
+    getBook(null, {
+      startPage: opt.startPage,
+      totalBookCount: count,
+      booklist,
+    });
+  } catch (err) {
+    if (getBook) {
+      getBook({ msg: err.toString() });
+    }
+  }
 }
 
 module.exports = {

package/src/library/osan.js

@@ -1,5 +1,5 @@
 const getLibraryNames = require("../util.js").getLibraryNames;
-const req = require("request");
+const { get } = require("../http");
 const { JSDOM } = require("jsdom");
 
 const libraryList = [
@@ -20,7 +20,7 @@ function getLibraryCode(libraryName) {
   return found ? found.code : "";
 }
 
-function search(opt, getBook) {
+async function search(opt, getBook) {
   let title = opt.title;
   let libraryName = opt.libraryName;
 
@@ -38,95 +38,103 @@ function search(opt, getBook) {
     return;
   }
 
-  // https://www.osanlibrary.go.kr/intro/program/plusSearchResultList.do?searchType=SIMPLE&searchCategory=ALL&searchLibraryArr=MA&searchKey=ALL&searchKeyword=javascript&searchRecordCount=20
   const lcode = getLibraryCode(libraryName);
-  req.get(
-    {
-      url: `https://www.osanlibrary.go.kr/intro/program/plusSearchResultList.do`,
-      timeout: 20000,
-      qs: {
-        searchType: "SIMPLE",
-        searchCategory: "ALL",
-        searchLibraryArr: lcode,
-        searchKey: "ALL",
-        searchKeyword: title,
-        searchRecordCount: 1000,
+
+  try {
+    const { statusCode, body } = await get(
+      `https://www.osanlibrary.go.kr/intro/program/plusSearchResultList.do`,
+      {
+        qs: {
+          searchType: "SIMPLE",
+          searchCategory: "ALL",
+          searchLibraryArr: lcode,
+          searchKey: "ALL",
+          searchKeyword: title,
+          searchRecordCount: 1000,
+        },
       },
-    },
-    function (err, res, body) {
-      if (err || (res && res.statusCode !== 200)) {
-        let msg = "";
+    );
 
-        if (err) {
-          msg = err;
-        }
+    if (statusCode !== 200) {
+      if (getBook) {
+        getBook({ msg: `HTTP ${statusCode}` });
+      }
+      return;
+    }
 
-        if (res && res.statusCode) {
-          msg = msg + " " + res.statusCode;
-        }
+    const dom = new JSDOM(body);
+    const document = dom.window.document;
+
+    // Extract total count from "총 <span class="highlight">44</span>건"
+    const highlightSpans = document.querySelectorAll("span.highlight");
+    let count = "0";
+    for (const span of highlightSpans) {
+      const text = span.textContent.trim();
+      if (/^\d+$/.test(text)) {
+        count = text;
+        break;
+      }
+    }
 
-        if (getBook) {
-          getBook({ msg: msg });
-        }
-      } else {
-        const dom = new JSDOM(body);
-        const document = dom.window.document;
-
-        // Extract total count from "총 <span class="highlight">44</span>건"
-        const highlightSpans = document.querySelectorAll("span.highlight");
-        let count = "0";
-        for (const span of highlightSpans) {
-          const text = span.textContent.trim();
-          if (/^\d+$/.test(text)) {
-            count = text;
-            break;
-          }
-        }
+    const booklist = [];
+    const bookItems = document.querySelectorAll(".bookList .listWrap > li");
+    bookItems.forEach((li) => {
+      // Get title and book URL from .book_name link
+      const titleLink = li.querySelector(".book_name");
+      const titleEl = titleLink ? titleLink.querySelector("span") : null;
+      const bookTitle = titleEl ? titleEl.textContent.trim() : "";
+
+      // Extract book URL from onclick handler
+      let bookUrl = "";
+      const onclick = titleLink ? titleLink.getAttribute("onclick") || "" : "";
+      const urlMatch = onclick.match(
+        /fnSearchResultDetail\((\d+),(\d+),'(\w+)'\)/,
+      );
+      if (urlMatch) {
+        const [, recKey, bookKey, publishFormCode] = urlMatch;
+        bookUrl = `https://www.osanlibrary.go.kr/intro/menu/10003/program/30004/plusSearchResultDetail.do?recKey=${recKey}&bookKey=${bookKey}&publishFormCode=${publishFormCode}`;
+      }
 
-        const booklist = [];
-        const bookItems = document.querySelectorAll(".bookList .listWrap > li");
-        bookItems.forEach((li) => {
-          // Get title from .book_name span
-          const titleEl = li.querySelector(".book_name span");
-          const bookTitle = titleEl ? titleEl.textContent.trim() : "";
-
-          // Get availability status from .status p
-          const statusEl = li.querySelector(".status p");
-          const statusText = statusEl ? statusEl.textContent.trim() : "";
-          const exist = statusText.includes("대출가능");
-
-          // Get library name from ".book_info .fb p" containing "소장도서관"
-          let libName = "";
-          const fbParagraphs = li.querySelectorAll(".book_info .fb p");
-          fbParagraphs.forEach((p) => {
-            const text = p.textContent;
-            if (text.includes("소장도서관")) {
-              // Format: "[공공]오산시중앙도서관" - extract library name after "]"
-              const match = text.match(/\](.+)$/);
-              if (match) {
-                libName = match[1].trim();
-              }
-            }
-          });
-
-          if (bookTitle) {
-            booklist.push({
-              libraryName: libName,
-              title: bookTitle,
-              maxoffset: count,
-              exist: exist,
-            });
+      // Get availability status from .status p
+      const statusEl = li.querySelector(".status p");
+      const statusText = statusEl ? statusEl.textContent.trim() : "";
+      const exist = statusText.includes("대출가능");
+
+      // Get library name from ".book_info .fb p" containing "소장도서관"
+      let libName = "";
+      const fbParagraphs = li.querySelectorAll(".book_info .fb p");
+      fbParagraphs.forEach((p) => {
+        const text = p.textContent;
+        if (text.includes("소장도서관")) {
+          // Format: "[공공]오산시중앙도서관" - extract library name after "]"
+          const match = text.match(/\](.+)$/);
+          if (match) {
+            libName = match[1].trim();
           }
-        });
-
-        getBook(null, {
-          startPage: opt.startPage,
-          totalBookCount: count,
-          booklist,
+        }
+      });
+
+      if (bookTitle) {
+        booklist.push({
+          libraryName: libName,
+          title: bookTitle,
+          bookUrl,
+          maxoffset: count,
+          exist: exist,
         });
       }
-    },
-  );
+    });
+
+    getBook(null, {
+      startPage: opt.startPage,
+      totalBookCount: count,
+      booklist,
+    });
+  } catch (err) {
+    if (getBook) {
+      getBook({ msg: err.toString() });
+    }
+  }
 }
 
 module.exports = {

package/src/library/snlib.js

@@ -1,6 +1,6 @@
 const getLibraryNames = require("../util.js").getLibraryNames;
 const jquery = require("jquery");
-const req = require("request");
+const { get } = require("../http");
 const { JSDOM } = require("jsdom");
 
 const libraryList = [
@@ -27,7 +27,7 @@ function getLibraryCode(libraryName) {
   return found ? found.code : "";
 }
 
-function search(opt, getBook) {
+async function search(opt, getBook) {
   let title = opt.title;
   let libraryName = opt.libraryName;
 
@@ -46,67 +46,74 @@ function search(opt, getBook) {
   }
 
   const lcode = getLibraryCode(libraryName);
-  req.get(
-    {
-      url: "https://www.snlib.go.kr/intro/menu/10041/program/30009/plusSearchResultList.do",
-      timeout: 20000,
-      qs: {
-        currentPageNo: 1,
-        searchBookClass: "ALL",
-        searchCategory: "BOOK",
-        searchKey: "ALL",
-        searchKeyword: title,
-        searchLibraryArr: lcode,
-        searchOrder: "DESC",
-        searchRecordCount: 1000,
-        searchSort: "SIMILAR",
-        searchType: "SIMPLE",
-      },
-    },
-    function (err, res, body) {
-      if (err || (res && res.statusCode !== 200)) {
-        let msg = "";
 
-        if (err) {
-          msg = err;
-        }
+  try {
+    const { statusCode, body } = await get(
+      "https://www.snlib.go.kr/intro/menu/10041/program/30009/plusSearchResultList.do",
+      {
+        qs: {
+          currentPageNo: 1,
+          searchBookClass: "ALL",
+          searchCategory: "BOOK",
+          searchKey: "ALL",
+          searchKeyword: title,
+          searchLibraryArr: lcode,
+          searchOrder: "DESC",
+          searchRecordCount: 1000,
+          searchSort: "SIMILAR",
+          searchType: "SIMPLE",
+        },
+      },
+    );
 
-        if (res && res.statusCode) {
-          msg = msg + " " + res.statusCode;
-        }
+    if (statusCode !== 200) {
+      if (getBook) {
+        getBook({ msg: `HTTP ${statusCode}` });
+      }
+      return;
+    }
 
-        if (getBook) {
-          getBook({ msg: msg });
+    const dom = new JSDOM(body);
+    const $ = jquery(dom.window);
+    const count = $("strong.themeFC").text().match(/\d+/)[0];
+    const booklist = [];
+    if (count) {
+      $(".resultList > li").each((_, a) => {
+        const titleElement = $(a).find(".tit a");
+        const title = titleElement.text().trim();
+        const onclick = titleElement.attr("onclick") || "";
+        const match = onclick.match(
+          /fnSearchResultDetail\((\d+),(\d+),'(\w+)'\)/,
+        );
+        let bookUrl = "";
+        if (match) {
+          const [, recKey, bookKey, publishFormCode] = match;
+          bookUrl = `https://www.snlib.go.kr/intro/menu/10041/program/30009/plusSearchResultDetail.do?recKey=${recKey}&bookKey=${bookKey}&publishFormCode=${publishFormCode}`;
         }
-      } else {
-        const dom = new JSDOM(body);
-        const $ = jquery(dom.window);
-        const count = $("strong.themeFC").text().match(/\d+/)[0];
-        const booklist = [];
-        if (count) {
-          $(".resultList > li").each((_, a) => {
-            const title = $(a).find(".tit a").text().trim();
-            const rented = $(a).find(".bookStateBar .txt b").text();
-            const b = $(a).find(".site > span:first-child").text().split(":");
-            const libraryName = b && b[1] ? b[1].trim() : "";
-            if (title) {
-              booklist.push({
-                libraryName,
-                title,
-                maxoffset: count,
-                exist: rented.includes("대출가능"),
-              });
-            }
+        const rented = $(a).find(".bookStateBar .txt b").text();
+        const b = $(a).find(".site > span:first-child").text().split(":");
+        const libraryName = b && b[1] ? b[1].trim() : "";
+        if (title) {
+          booklist.push({
+            libraryName,
+            title,
+            bookUrl,
+            maxoffset: count,
+            exist: rented.includes("대출가능"),
           });
         }
-        getBook(null, {
-          startPage: opt.startPage,
-          totalBookCount: count,
-          booklist,
-        });
-      }
-    },
-  );
+      });
+    }
+    getBook(null, {
+      startPage: opt.startPage,
+      totalBookCount: count,
+      booklist,
+    });
+  } catch (err) {
+    if (getBook) {
+      getBook({ msg: err.toString() });
+    }
+  }
 }
 
 module.exports = {

package/src/library/suwon.js

@@ -1,5 +1,5 @@
 const getLibraryNames = require("../util.js").getLibraryNames;
-const req = require("request");
+const { createSession } = require("../http");
 
 const libraryList = [
   { code: "141025", name: "선경도서관" },
@@ -32,10 +32,6 @@ function getLibraryCode(libraryName) {
   return found ? found.code : "";
 }
 
-function getAllLibraryCodes() {
-  return libraryList.map((lib) => lib.code).join(",");
-}
-
 function stripHtml(str) {
   return str ? str.replace(/<[^>]*>/g, "") : "";
 }
@@ -45,15 +41,20 @@ function getBookList(data) {
     return [];
   }
   return data.SEARCH_RESULT.SEARCH_LIST.map(function (book) {
+    let bookUrl = "";
+    if (book.MANAGE_CODE && book.ISBN && book.BOOK_KEY) {
+      bookUrl = `https://search.suwonlib.go.kr/detail/${book.MANAGE_CODE}/${book.ISBN}/${book.BOOK_KEY}`;
+    }
     return {
       title: stripHtml(book.TITLE_INFO || ""),
       exist: book.LOAN_CODE === "OK",
       libraryName: book.LIB_NAME || "",
+      bookUrl,
     };
   });
 }
 
-function search(opt, getBook) {
+async function search(opt, getBook) {
   let title = opt.title;
   let libraryName = opt.libraryName;
 
@@ -73,102 +74,71 @@ function search(opt, getBook) {
 
   const lcode = getLibraryCode(libraryName);
 
-  // Create a cookie jar to maintain session
-  const jar = req.jar();
-
-  // First, visit the search page to initialize session
-  req.get(
-    {
-      url: "https://search.suwonlib.go.kr/search",
-      jar: jar,
-      timeout: 20000,
-      headers: {
-        "User-Agent":
-          "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
-      },
-    },
-    function (err1, res1, body1) {
-      if (err1) {
-        if (getBook) {
-          getBook({ msg: err1.toString() });
-        }
-        return;
-      }
-
-      // Now make the API call with the session cookies
-      // Requires 'ajax: true' header and full parameter set including empty facet parameters
-      req.post(
-        {
-          url: "https://search.suwonlib.go.kr/getSearchResult/normal",
-          jar: jar,
-          timeout: 20000,
-          headers: {
-            "User-Agent":
-              "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
-            "Content-Type": "application/x-www-form-urlencoded; charset=UTF-8",
-            Referer: "https://search.suwonlib.go.kr/search",
-            "X-Requested-With": "XMLHttpRequest",
-            ajax: "true",
-          },
-          form: {
-            searchTxt: title,
-            kCid: "",
-            kdcValue: "",
-            searchKind: "book",
-            manageCode: lcode,
-            isInnerSearch: "F",
-            innerSearchTxt: "",
-            keywordSearch: false,
-            displayNo: "1000",
-            orderbyItem: "ACCURACY_SORT",
-            orderby: "DESC",
-            pageNo: "1",
-            facetLib: "",
-            facetLibName: "",
-            facetAuthor: "",
-            facetPublisher: "",
-            facetPubYear: "",
-            facetSubject: "",
-            facetSubjectName: "",
-            facetMedia: "",
-            facetMediaName: "",
-          },
+  try {
+    // Create a session to maintain cookies
+    const session = createSession();
+
+    // First, visit the search page to initialize session
+    await session.get("https://search.suwonlib.go.kr/search");
+
+    // Now make the API call with the session cookies
+    const { statusCode, body } = await session.post(
+      "https://search.suwonlib.go.kr/getSearchResult/normal",
+      {
+        form: {
+          searchTxt: title,
+          kCid: "",
+          kdcValue: "",
+          searchKind: "book",
+          manageCode: lcode,
+          isInnerSearch: "F",
+          innerSearchTxt: "",
+          keywordSearch: false,
+          displayNo: "1000",
+          orderbyItem: "ACCURACY_SORT",
+          orderby: "DESC",
+          pageNo: "1",
+          facetLib: "",
+          facetLibName: "",
+          facetAuthor: "",
+          facetPublisher: "",
+          facetPubYear: "",
+          facetSubject: "",
+          facetSubjectName: "",
+          facetMedia: "",
+          facetMediaName: "",
         },
-        function (err, res, body) {
-          if (err || (res && res.statusCode !== 200)) {
-            let msg = "";
-
-            if (err) {
-              msg = err;
-            }
+        headers: {
+          "Content-Type": "application/x-www-form-urlencoded; charset=UTF-8",
+          Referer: "https://search.suwonlib.go.kr/search",
+          "X-Requested-With": "XMLHttpRequest",
+          ajax: "true",
+        },
+      },
+    );
 
-            if (res && res.statusCode) {
-              msg = msg + " " + res.statusCode;
-            }
+    if (statusCode !== 200) {
+      if (getBook) {
+        getBook({ msg: `HTTP ${statusCode}` });
+      }
+      return;
+    }
 
-            if (getBook) {
-              getBook({ msg: msg });
-            }
-          } else {
-            try {
-              const data = JSON.parse(body);
-              const booklist = getBookList(data);
-              const totalCount =
-                data.SEARCH_RESULT && data.SEARCH_RESULT.SEARCH_COUNT
-                  ? data.SEARCH_RESULT.SEARCH_COUNT
-                  : booklist.length;
-              getBook(null, {
-                totalBookCount: totalCount,
-                booklist,
-              });
-            } catch (e) {
-              getBook({ msg: "Failed to parse response: " + e.message });
-            }
-          }
-        },
-      );
-    },
-  );
+    const data = JSON.parse(body);
+    const booklist = getBookList(data);
+    const totalCount =
+      data.SEARCH_RESULT && data.SEARCH_RESULT.SEARCH_COUNT
+        ? data.SEARCH_RESULT.SEARCH_COUNT
+        : booklist.length;
+    getBook(null, {
+      totalBookCount: totalCount,
+      booklist,
+    });
+  } catch (err) {
+    if (getBook) {
+      getBook({ msg: err.toString() });
+    }
+  }
 }
 
 module.exports = {

package/src/library/yongin.js

@@ -0,0 +1,182 @@
+const getLibraryNames = require("../util.js").getLibraryNames;
+const { get } = require("../http");
+const { JSDOM } = require("jsdom");
+
+const libraryList = [
+  // Public libraries (시립도서관)
+  { code: "MB", name: "수지도서관" },
+  { code: "MI", name: "구갈희망누리도서관" },
+  { code: "MD", name: "구성도서관" },
+  { code: "MK", name: "기흥도서관" },
+  { code: "MY", name: "남사도서관" },
+  { code: "MF", name: "동백도서관" },
+  { code: "NA", name: "동천도서관" },
+  { code: "ML", name: "모현도서관" },
+  { code: "MM", name: "보라도서관" },
+  { code: "MO", name: "상현도서관" },
+  { code: "MZ", name: "서농도서관" },
+  { code: "NB", name: "성복도서관" },
+  { code: "MA", name: "용인중앙도서관" },
+  { code: "MJ", name: "양지해밀도서관" },
+  { code: "NN", name: "영덕도서관" },
+  { code: "MX", name: "이동꿈틀도서관" },
+  { code: "ME", name: "죽전도서관" },
+  { code: "MP", name: "청덕도서관" },
+  { code: "MC", name: "포곡도서관" },
+  { code: "MN", name: "흥덕도서관" },
+  // Smart libraries (스마트도서관)
+  { code: "NO", name: "기흥동행정복지센터스마트도서관" },
+  { code: "NJ", name: "기흥역스마트도서관" },
+  { code: "NF", name: "동천동행정복지센터스마트도서관" },
+  { code: "NS", name: "마북동행정복지센터스마트도서관" },
+  { code: "NG", name: "보정동행정복지센터스마트도서관" },
+  { code: "NP", name: "상갈동행정복지센터스마트도서관" },
+  { code: "NT", name: "상하동행정복지센터스마트도서관" },
+  { code: "NH", name: "성복역스마트도서관" },
+  { code: "NL", name: "시청스마트도서관" },
+  { code: "NI", name: "신봉동행정복지센터스마트도서관" },
+  { code: "NR", name: "역북동행정복지센터스마트도서관" },
+  { code: "NM", name: "용인중앙시장역스마트도서관" },
+  { code: "ND", name: "원삼면스마트도서관" },
+  { code: "NQ", name: "유방어린이공원스마트도서관" },
+  { code: "NK", name: "죽전역스마트도서관" },
+  // Small libraries (작은도서관)
+  { code: "NC", name: "고림다온작은도서관" },
+  { code: "MS", name: "남사맑은누리작은도서관" },
+  { code: "MT", name: "백암면작은도서관" },
+  { code: "MW", name: "상현1동작은도서관" },
+  { code: "MQ", name: "상현2동작은도서관" },
+  { code: "MV", name: "이동천리작은도서관" },
+];
+
+function getLibraryCode(libraryName) {
+  const found = libraryList.find((lib) => lib.name === libraryName);
+  return found ? found.code : "";
+}
+
+async function search(opt, getBook) {
+  let title = opt.title;
+  let libraryName = opt.libraryName;
+
+  if (!title) {
+    if (getBook) {
+      getBook({ msg: "Need a book name" });
+    }
+    return;
+  }
+
+  if (!libraryName) {
+    if (getBook) {
+      getBook({ msg: "Need a library name" });
+    }
+    return;
+  }
+
+  const lcode = getLibraryCode(libraryName);
+
+  try {
+    const { statusCode, body } = await get(
+      `https://lib.yongin.go.kr/intro/menu/10003/program/30012/plusSearchResultList.do`,
+      {
+        qs: {
+          searchType: "SIMPLE",
+          searchCategory: "ALL",
+          searchLibraryArr: lcode,
+          searchKey: "ALL",
+          searchKeyword: title,
+          searchRecordCount: 1000,
+        },
+      },
+    );
+
+    if (statusCode !== 200) {
+      if (getBook) {
+        getBook({ msg: `HTTP ${statusCode}` });
+      }
+      return;
+    }
+
+    const dom = new JSDOM(body);
+    const document = dom.window.document;
+
+    // Extract total count from "총<strong class="highlight">44</strong> 건"
+    const highlightElems = document.querySelectorAll(".highlight");
+    let count = "0";
+    for (const elem of highlightElems) {
+      const text = elem.textContent.trim();
+      if (/^\d+$/.test(text)) {
+        count = text;
+        break;
+      }
+    }
+
+    const booklist = [];
+    const bookItems = document.querySelectorAll(".bookList .listWrap > li");
+    bookItems.forEach((li) => {
+      // Get title and book URL from .book_name link
+      const titleLink = li.querySelector(".book_name a");
+      // Title is the text content of the link, excluding the book_kind badge
+      let bookTitle = "";
+      if (titleLink) {
+        // Clone the node and remove the book_kind element to get clean title
+        const clone = titleLink.cloneNode(true);
+        const bookKind = clone.querySelector(".book_kind");
+        if (bookKind) bookKind.remove();
+        bookTitle = clone.textContent.trim();
+      }
+
+      // Extract book URL from onclick handler
+      let bookUrl = "";
+      const onclick = titleLink ? titleLink.getAttribute("onclick") || "" : "";
+      const urlMatch = onclick.match(
+        /fnSearchResultDetail\((\d+),(\d+),'(\w+)'\)/,
+      );
+      if (urlMatch) {
+        const [, recKey, bookKey, publishFormCode] = urlMatch;
+        bookUrl = `https://lib.yongin.go.kr/intro/menu/10003/program/30012/plusSearchResultDetail.do?recKey=${recKey}&bookKey=${bookKey}&publishFormCode=${publishFormCode}`;
+      }
+
+      // Get availability status from .status p
+      const statusEl = li.querySelector(".status p");
+      const statusText = statusEl ? statusEl.textContent.trim() : "";
+      const exist = statusText.includes("대출가능");
+
+      // Get library name from ".book_info.info03 p" (first p contains library name)
+      let libName = "";
+      const info03 = li.querySelector(".book_info.info03");
+      if (info03) {
+        const firstP = info03.querySelector("p");
+        if (firstP) {
+          libName = firstP.textContent.trim();
+        }
+      }
+
+      if (bookTitle) {
+        booklist.push({
+          libraryName: libName,
+          title: bookTitle,
+          bookUrl,
+          maxoffset: count,
+          exist: exist,
+        });
+      }
+    });
+
+    getBook(null, {
+      startPage: opt.startPage,
+      totalBookCount: count,
+      booklist,
+    });
+  } catch (err) {
+    if (getBook) {
+      getBook({ msg: err.toString() });
+    }
+  }
+}
+
+module.exports = {
+  search,
+  getLibraryNames: function () {
+    return getLibraryNames(libraryList);
+  },
+};

package/test/helpers/libraryTestSuite.js

@@ -97,6 +97,7 @@ function createLibraryTestSuite(lib, description) {
       this.timeout(60000);
       let completed = 0;
       const failures = [];
+      let successCount = 0;
 
       libraryNames.forEach(function (libraryName) {
         lib.search(
@@ -116,19 +117,31 @@ function createLibraryTestSuite(lib, description) {
                 book.booklist !== undefined,
                 `${libraryName} should return a booklist`,
               );
-              console.log(
-                `  ✓ ${libraryName}: ${book.totalBookCount} books found`,
-              );
+              if (book.totalBookCount > 0) {
+                console.log(
+                  `  ✓ ${libraryName}: ${book.totalBookCount} books found`,
+                );
+                successCount++;
+              } else {
+                // Some libraries (smart/small) may legitimately have 0 results
+                console.log(
+                  `  - ${libraryName}: 0 books found (may be expected for small collections)`,
+                );
+              }
             }
 
             if (completed === libraryNames.length) {
-              if (failures.length > 0) {
-                console.log(`  Warning: ${failures.length} libraries failed`);
-              }
+              console.log(
+                `  Summary: ${successCount} libraries with results, ${failures.length} errors`,
+              );
               assert.ok(
                 failures.length < libraryNames.length,
                 "At least one library should be searchable",
               );
+              assert.ok(
+                successCount > 0,
+                "At least one library should return results",
+              );
               done();
             }
           },

package/test/yongin.spec.js

@@ -0,0 +1,4 @@
+const lib = require("../src/library/yongin");
+const { createLibraryTestSuite } = require("./helpers/libraryTestSuite");
+
+createLibraryTestSuite(lib, "용인시 도서관");