# 토론토 책장

> 토론토 공공도서관(Toronto Public Library, TPL)에서 빌릴 수 있는 한국어 책 4,577권의 목록을 모은 비공식 정적 안내 사이트. 제목·작가·ISBN·분류와 TPL 카탈로그로 가는 링크를 제공한다. Unofficial static guide to the Korean-language books held by Toronto Public Library.

이 사이트는 TPL 과 무관한 개인 프로젝트다. **소장 여부와 대출 가능 상태는 TPL 카탈로그(BiblioCommons)에서 확인해야 한다.** 여기 있는 정보는 TPL 서지(Z39.50)를 매일 한 번 수집해 정규화한 것이며, 마지막 확인일은 2026-10-05, 데이터 생성 시각은 2026-10-05T18:01:29.676Z 이다. 실시간 API 는 없다.

한글 제목이 있는 책은 전체의 약 62% 다. 나머지는 TPL 서지에 ALA-LC 로마자 표기(예: `Sonyŏn i onda`)만 있어 한글로는 매칭되지 않는다. 한글로 못 찾으면 로마자 표기(`titleRomanized`)로도 비교하라.

**에이전트가 책을 찾는 절차.** `/search` 는 사람용 HTML 이고 검색은 브라우저 JavaScript 로만 돈다. 에이전트는 그 페이지에 의존하지 말고 **정적 카탈로그 파일을 한 번 받아 로컬에서 매칭**한다. 파일은 두 가지 크기가 있다.

1. **축약본 `https://chaekjang.tynamics.com/catalog-lite.txt`** (약 397 KB, text/plain, 탭 구분)을 먼저 받는다. 첫 줄은 열 이름 `slug\ttitle\tauthor\tisbn13\tyear`, 그다음 한 줄에 한 권(4,577줄). "이 책이 있나" 는 여기서 끝난다. 웹 페이지를 잘라 읽는 도구(브라우징·URL 읽기)는 이 파일을 쓴다.
2. 더 많은 필드(로마자·초성·분류·주제어·TPL 링크)가 필요하면 **전체본** `https://chaekjang.tynamics.com/catalog.jsonl` (약 3.4 MB, 압축 전)을 받는다. 한 줄에 책 한 권(JSON). JSONL 을 못 여는 도구는 같은 내용의 `https://chaekjang.tynamics.com/catalog.txt` (text/plain)을, 배열 하나가 편하면 `https://chaekjang.tynamics.com/catalog.json` (`{ generatedAt, lastSyncDate, totalBooks, books: [...] }`)을 쓴다.
3. 로컬에서 `isbn13` 정확 일치 → `title` / `titleRomanized` / `author` 부분 일치 → `titleChosung`(초성) 순으로 후보를 좁힌다. 비교 전에 공백·구두점을 떼면 잘 맞는다.
4. 후보의 책 페이지 `https://chaekjang.tynamics.com/books/<slug>/` (전체본에서는 `url` 필드)를 열면 책 소개·소장 분관·비슷한 책이 있고, `tplUrl` 로 TPL 카탈로그의 그 책 페이지에서 대출 상태를 본다.

파일은 빌드 때 만들어지며 사이트와 함께 매일 갱신된다(TPL 수집 → 정규화 → 배포). 하루 안에는 바뀌지 않으므로 세션 동안 캐시해도 된다.

**축약본 열.** `slug`(책 페이지 주소 `/books/<slug>/`, 끝에 불변 식별자 publicId 가 붙어 있다) · `title` · `author` · `isbn13`(없으면 빈 칸) · `year`(발행 연도). 예: `소년이-온다-3143525\t소년이 온다\t한강\t9788936434120\t2014`

**전체본 레코드 필드.**

- `publicId`: 불변 식별자(TPL catkey 또는 `x` 접두 해시). 주소가 바뀌어도 유지된다.
- `slug`, `url`: 책 상세 페이지. `url` 은 절대 주소(퍼센트 인코딩됨).
- `title`, `subtitle`, `titleRomanized`, `titleChosung`, `originalTitle`: 제목. `titleChosung` 은 한글 제목의 초성(`ㅅㄴㅇ ㅇㄷ`), 한글이 없으면 null.
- `author`, `authorRomanized`, `contributors`, `authorSlug`: 저자·기여자. `authorSlug` 가 있으면 `/authors/<authorSlug>` 에 작가 페이지가 있다.
- `isbn`(서지 원문, 10자리일 수 있음), `isbn13`(검사숫자 확인된 13자리, 틀리면 null), `publisher`, `publicationYear`, `seriesTitle`, `volume`.
- `categories`: 토론토 책장 분류 슬러그(첫 번째가 대표). `/categories/<slug>`. 값: `fiction`(소설), `essay`(에세이), `humanities`(인문·사회), `business`(경제·경영), `science`(과학), `self-help`(자기계발), `children`(어린이), `teens`(청소년), `comics`(만화), `etc`(기타).
- `subjects`: TPL 주제어(영문 LCSH).
- `tplUrl`: TPL BiblioCommons 의 그 책 페이지. catkey 가 없는 책은 ISBN 검색 링크.
- `firstSeenAt`: 이 사이트가 처음 발견한 날(입고일 근사값). `updatedAt`: 페이지 내용이 마지막으로 바뀐 날.

책 소개·표지·소장 분관·부수는 카탈로그에 없다. 필요하면 `url` 의 책 페이지를 읽는다(JSON-LD `Book` 이 들어 있다).

**예시: ISBN 하나로 책 한 권 찾기.**

```
curl -s https://chaekjang.tynamics.com/catalog-lite.txt | grep -P '\t9788936434120\t'
curl -s https://chaekjang.tynamics.com/catalog.jsonl | grep '"isbn13":"9788936434120"'
```

첫 줄(축약본)의 결과:

```
소년이-온다-3143525	소년이 온다	한강	9788936434120	2014
```

둘째 줄(전체본)의 결과(요약):

```
{"publicId":"3143525","title":"소년이 온다","author":"한강","isbn13":"9788936434120","url":"https://chaekjang.tynamics.com/books/%EC%86%8C%EB%85%84%EC%9D%B4-%EC%98%A8%EB%8B%A4-3143525/","tplUrl":"https://tpl.bibliocommons.com/v2/record/S234C3143525", ...}
```

제목으로 찾을 때는 축약본에서 `grep '소년이 온다'`, 전체본에서 `grep '"title":"[^"]*소년이 온다'` 처럼 부분 일치로 찾고, 초성으로 찾을 때는 전체본의 `titleChosung` 을 본다. jq 를 쓸 수 있다면 `jq -c 'select(.author == "한강")'` 이 편하다.

## 둘러보기

- [홈](https://chaekjang.tynamics.com/): 이번 주 새 책, 오늘의 컬렉션, 분야·작가 바로가기
- [새로 들어온 책](https://chaekjang.tynamics.com/new): 최근 7일 사이 처음 발견한 책. `/new/<YYYY-MM-DD>` 로 날짜별
- [컬렉션](https://chaekjang.tynamics.com/collections): 테마를 정해 사람이 직접 고른 추천 목록과 소개 글. 아래 "컬렉션" 절
- [분야](https://chaekjang.tynamics.com/categories): 10개 분류로 나눈 목록
- [작가](https://chaekjang.tynamics.com/authors): 두 권 이상 있는 작가 목록. 작가 페이지는 `/authors/<이름>`
- [분관](https://chaekjang.tynamics.com/branches): TPL 소장 분관별 목록. 분관 페이지는 `/branches/<분관 코드 소문자>`(예: `/branches/trl`). 이름을 확인하지 못한 분관은 코드로 표시
- [검색](https://chaekjang.tynamics.com/search): 사람용. 브라우저 JavaScript 로 도는 제목·작가·ISBN·초성 검색. 에이전트는 아래 카탈로그를 쓴다
- [소개](https://chaekjang.tynamics.com/about): 만든 이유, 데이터 출처와 한계, 만든 팀(Tynamics)과 연락처

## 카탈로그 (에이전트용)

- [catalog-lite.txt](https://chaekjang.tynamics.com/catalog-lite.txt): 축약본. 전 도서 4,577권, 탭 구분(slug·title·author·isbn13·year), text/plain, 약 397 KB. 웹 페이지를 잘라 읽는 도구는 이것부터
- [catalog.jsonl](https://chaekjang.tynamics.com/catalog.jsonl): 전체본. 한 줄에 한 권, 전 필드. `application/x-ndjson`, UTF-8, 약 3.4 MB. 최근에 들어온 책이 앞
- [catalog.txt](https://chaekjang.tynamics.com/catalog.txt): catalog.jsonl 과 같은 내용을 text/plain 으로. JSONL MIME 을 못 여는 도구용
- [catalog.json](https://chaekjang.tynamics.com/catalog.json): 같은 레코드를 `books` 배열 하나로. 머리말에 `generatedAt`·`lastSyncDate`·`totalBooks`

## 컬렉션

- [아이와 함께 읽는 그림책](https://chaekjang.tynamics.com/collections/picture-books-with-kids): 19권. 무릎에 앉혀 소리 내어 읽기 좋은 한국어 그림책. 한국어를 처음 듣는 아이와도 함께 넘길 수 있는 책들입니다.
- [한강과 함께 읽는](https://chaekjang.tynamics.com/collections/han-kang): 6권. 노벨문학상 작가 한강의 소설을 토론토에서 한국어로. 어디서부터 읽을지 순서까지 골랐습니다.
- [김초엽과 한국 SF](https://chaekjang.tynamics.com/collections/kim-choyeop-sf): 16권. 『우리가 빛의 속도로 갈 수 없다면』에서 시작하는 한국 SF 지도. 번역 SF 말고, 한국 작가가 쓴 이야기만 모았습니다.
- [육아·부모를 위한 책](https://chaekjang.tynamics.com/collections/parenting): 17권. 캐나다에서 한국어로 아이를 키우는 부모를 위해. 임신부터 사춘기 전까지, 도서관에서 빌려 볼 수 있는 육아서입니다.
- [아이와 세계사·학습만화](https://chaekjang.tynamics.com/collections/kids-history-comics): 17권. 만화로 시작하는 세계사와 상식. 한국어 읽기에 재미를 붙이고 싶은 초등학생에게 권하는 학습만화입니다.

## 분야별 목록

- [소설](https://chaekjang.tynamics.com/categories/fiction): 1,766권
- [에세이](https://chaekjang.tynamics.com/categories/essay): 26권
- [인문·사회](https://chaekjang.tynamics.com/categories/humanities): 371권
- [경제·경영](https://chaekjang.tynamics.com/categories/business): 176권
- [과학](https://chaekjang.tynamics.com/categories/science): 76권
- [자기계발](https://chaekjang.tynamics.com/categories/self-help): 204권
- [어린이](https://chaekjang.tynamics.com/categories/children): 829권
- [청소년](https://chaekjang.tynamics.com/categories/teens): 10권
- [만화](https://chaekjang.tynamics.com/categories/comics): 45권
- [기타](https://chaekjang.tynamics.com/categories/etc): 1,618권

## Optional

- [sitemap](https://chaekjang.tynamics.com/sitemap-index.xml): 전 페이지 주소와 lastmod
- [robots.txt](https://chaekjang.tynamics.com/robots.txt): 전면 허용. 이 파일과 카탈로그도 허용 범위에 있다
- [TPL 카탈로그](https://tpl.bibliocommons.com/): 소장·대출 상태의 유일한 출처. 책 레코드의 `tplUrl` 이 여기로 간다