---
title: "Librario: 여러 도서 메타데이터 소스를 하나로 합치는 오픈소스 API"
published: 2026-01-10T23:45:25.000Z
canonical: https://jeff.news/article/812
---
# Librario: 여러 도서 메타데이터 소스를 하나로 합치는 오픈소스 API

개인 서재 1,800권 관리를 위해 만든 도서 메타데이터 통합 API. Google Books, ISBNDB, Hardcover 등에서 데이터를 가져와 필드별 전략으로 병합함. Go로 작성, PostgreSQL 백엔드, AGPL 라이선스. 프리알파 단계.

개인 서재 1,800권을 관리하려다 만든 도서 메타데이터 통합 API인 Librario가 Show HN에 공개됨. Go로 작성되었고 AGPL 라이선스로 SourceHut에서 호스팅됨.

---

- 기존 도서 API들은 하나만으로 완전한 정보를 얻을 수 없는 게 문제였음. 어떤 소스는 시리즈 정보만, 다른 소스는 장르만, 또 다른 소스는 표지만 제대로 제공하는 식임
- 현재 Google Books, ISBNDB, Hardcover를 지원하며, Goodreads와 Anna's Archive도 추가 예정임
- 핵심은 서로 충돌하는 데이터를 병합하는 머저(merger) 로직임. 필드별로 다른 전략을 사용함:
  - **제목**: 괄호가 포함되거나 80자 이상인 제목은 감점하는 스코어링 시스템 적용 (부제나 에디션 정보가 제목에 섞이는 걸 방지)
  - **표지**: 모든 후보 URL을 수집한 뒤 이미지를 다운로드해서 해상도와 품질 기준으로 점수를 매겨 최적 표지를 선택
  - **기타 필드**(출판사, 언어, 페이지 수 등): 소스 우선순위 기반으로 첫 번째 비어있지 않은 값을 채택
- PostgreSQL 백엔드를 사용하며, 쿼리가 늘어날수록 데이터베이스가 강화되는 구조임
- 데이터베이스 스키마는 원래 AI로 작성했으나 신뢰하기 어려워서 SourceHut 개발자에게 의뢰해 v1.0 전에 전면 재작성 중임
- net/http에서 Fiber로 마이그레이션을 검토했지만, 표준 라이브러리를 벗어나는 게 적절하지 않다고 판단해 취소했음
- 현재 프리알파(pre-alpha) 단계이며, 개발자가 생후 5개월 아기를 돌보는 중이라 개발 속도는 느린 편임

## 핵심 포인트

- Google Books, ISBNDB, Hardcover 등 여러 소스의 도서 메타데이터를 하나로 병합
- 제목 스코어링(괄호/80자 이상 감점), 표지 품질 스코어링 등 필드별 병합 전략 적용
- AI가 작성한 DB 스키마를 신뢰할 수 없어 SourceHut 개발자에게 재작성 의뢰
- AGPL 라이선스, Go 작성, PostgreSQL 백엔드, 프리알파 단계

## 인사이트

도서 메타데이터의 파편화 문제를 해결하려는 실용적 접근이며, AI 생성 코드를 신뢰하지 못해 전문가에게 재작성을 맡긴 판단이 흥미로운 사례임.