aladin-book-mcp
This MCP server/CLI provides Aladin Open API book search, detailed bibliographic lookup, curated lists, and bulk export capabilities.
Check API key and connectivity status.
Search books by keyword, title, author, or publisher, with category filters, sorting, pagination, and target selection (Book, Foreign, Music, DVD, Used, eBook, All).
Look up a book by ISBN13, ISBN10, or Aladin ItemId to retrieve details such as original title, table of contents, page count, format/weight/size, used-copy lowest price, and eBook info.
Retrieve curated lists including bestsellers, new releases, editor recommendations, and blogger bests.
Bulk-collect multiple search terms, remove duplicates, optionally fetch detailed lookup data, and export to xlsx, csv, json, and sqlite.
Use the standalone
aladinCLI for status checks, searches, lookups, list retrieval, and bulk collection without an AI agent.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@aladin-book-mcp search for '인공지능' and return top 5 with ISBN, price, and description"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
알라딘(Aladin) 도서 검색 및 상세 서지 MCP 서버
📈 사용량 — 최근 14일 조회 0회(고유 0) · 클론 0회(고유 0) · 릴리스 자산 누적 다운로드 5
2026-11-17 자동 갱신 · 전체 이력은
docs/usage.csv. GitHub 트래픽 통계는 14일 창만 제공하므로 이 저장소가 매일 찍어 누적한다.
알라딘(Aladin) Open API를 활용하여 도서 검색, 원서명(원제), 전체 목차(TOC), 쪽수(페이지 수), 판형/무게, 부제, 베스트셀러 순위, 중고서점 매물 및 최저가를 조회하고 엑셀/CSV 등으로 일괄 수집하는 Model Context Protocol (MCP) 서버 및 독립 CLI 도구입니다.
주요 기능
🔍 도서 검색 (
aladin_book_search): 키워드, 제목, 저자, 출판사별 통합 검색 (ItemSearch)📖 심층 서지 조회 (
aladin_book_lookup): 13자리/10자리 ISBN 또는 상품ID로 원서명, 도서 목차, 쪽수, 제본/무게/크기, 중고매물 최저가, eBook 연동 정보 조회🏆 큐레이션 리스트 (
aladin_book_list): 알라딘 베스트셀러, 신간, 편집장 추천도서, 블로거 베스트 목록 조회📦 다중 키워드 대량 수집 (
aladin_book_collect): 여러 검색어를 한 번에 자동 페이징 수집하고, 중복 제거 후xlsx,csv,json,sqlite동시 저장💻 독립형 터미널 CLI (
aladin): AI 에이전트 없이도 터미널에서 즉시 검색 및 엑셀 다운로드 지원
Related MCP server: aladin-mcp
인증키 발급 및 설정 (1분 소요, 무료)
알라딘 OpenAPI는 무료이며 TTB Key 발급 즉시 사용할 수 있습니다 (일일 5,000건 쿼터 제공).
1. TTB Key 발급 방법
API를 사용할 블로그나 사이트 정보 등록 후 발급된
TTB Key(예:ttb...) 복사
2. 환경별 키 등록 방법
사용 환경 | 설정 위치 | 설정 방법 |
Claude Desktop ( | 확장 설치 시 팝업창 |
|
Claude Code |
|
|
Antigravity / Gemini CLI |
|
|
CLI / 로컬 개발 | OS 환경변수 / | Windows 환경변수 등록 또는 |
설치 및 MCP 등록
1. Claude Desktop (1-클릭 확장 파일)
Releases에서 **
aladin-book-mcp.mcpb**를 다운로드하여 Claude Desktop 창으로 드래그 앤 드롭합니다.
2. Claude Code
claude mcp add aladin-book --env ALADIN_TTB_KEY=YOUR_TTB_KEY -- uvx --from git+https://github.com/rubatoyd/aladin-book-mcp aladin-book-mcp3. Gemini CLI / Antigravity
프로젝트 루트의 .agents/mcp_config.json 또는 전역 ~/.gemini/config/mcp_config.json:
{
"mcpServers": {
"aladin-book": {
"command": "uvx",
"args": ["--from", "git+https://github.com/rubatoyd/aladin-book-mcp", "aladin-book-mcp"],
"env": {
"ALADIN_TTB_KEY": "YOUR_ALADIN_TTB_KEY",
"PYTHONIOENCODING": "utf-8"
}
}
}
}CLI 도구 사용법 (aladin)
# 1. 상태 점검
uvx --from git+https://github.com/rubatoyd/aladin-book-mcp aladin status
# 2. 키워드 검색
uvx --from git+https://github.com/rubatoyd/aladin-book-mcp aladin search "인공지능" --size 5
# 3. ISBN13 상세 조회 (원서명, 목차, 쪽수, 판형, 중고가)
uvx --from git+https://github.com/rubatoyd/aladin-book-mcp aladin lookup 9791163034735
# 4. 베스트셀러 목록 조회
uvx --from git+https://github.com/rubatoyd/aladin-book-mcp aladin list --type Bestseller --size 10
# 5. 다중 키워드 대량 자동 수집 및 엑셀 저장 (상세 LookUp 포함)
uvx --from git+https://github.com/rubatoyd/aladin-book-mcp aladin collect \
--terms "머신러닝" "딥러닝" \
--max 50 \
--lookup \
--format xlsx csv json sqlite \
--out ./output라이선스
MIT License © 2026 Yeondong Yang
Available Tools
5 toolsaladin_book_collectA
다중 검색어로 도서를 대량 수집하고, 중복 제거 후 xlsx, csv, json, sqlite 파일로 저장합니다.
Args: terms: 수집할 검색어 목록 (예: ['인공지능', '머신러닝']) max_items_per_term: 검색어당 최대 수집 건수 (기본 30) query_type: 검색 필드 ('Keyword', 'Title', 'Author', 'Publisher') search_target: 검색 대상 ('Book', 'eBook', 'All' 등) sort: 정렬 순서 ('Accuracy', 'PublishTime', 'SalesPoint') opt_lookup: True 설정 시 각 도서별 목차/원서명/쪽수 상세 정보(ItemLookUp)까지 추가 조회 export_dir: 파일 저장 폴더 경로 (미지정 시 파일 저장 안 함) export_formats: 저장 포맷 리스트 (['xlsx', 'csv', 'json', 'sqlite'] 중 선택)
Inputs: terms (required), sort, export_dir, opt_lookup, +4 more.
aladin_book_listA
알라딘 베스트셀러, 신간, 추천도서 등 큐레이션 리스트를 조회합니다.
Args:
query_type: 리스트 종류 ('Bestseller', 'ItemNewAll', 'ItemNewSpecial', 'ItemEditorChoice', 'BlogBest')
search_target: 대상 카테고리 ('Book', 'Foreign', 'Music', 'DVD', 'Used', 'eBook', 'All')
start: 시작 페이지 번호 (1100)
max_results: 출력 건수 (1100)
category_id: 특정 카테고리 ID 필터 (선택)
Inputs: start, query_type, category_id, max_results, +1 more.
aladin_book_lookupA
ISBN13 또는 상품ID로 특정 도서의 원서명, 목차, 쪽수, 판형, 부제, 중고가, 전자책 상세 정보를 조회합니다.
Args: item_id: 13자리 ISBN, 10자리 ISBN, 또는 알라딘 ItemId item_id_type: 식별자 타입 ('ISBN13', 'ISBN', 'ItemId' - 미지정시 길이로 자동 감지) opt_result: 부가 정보 요청 플래그 (기본: 'ebookList,usedList,subInfo,packing')
Inputs: item_id (required), opt_result, item_id_type.
aladin_book_searchB
알라딘 Open API로 도서를 검색합니다.
Args:
query: 검색어 (도서명, 저자명, 출판사, 키워드 등)
query_type: 검색 대상 필드 ('Keyword', 'Title', 'Author', 'Publisher')
search_target: 검색 카테고리 ('Book', 'Foreign', 'Music', 'DVD', 'Used', 'eBook', 'All')
start: 시작 페이지 번호 (1100)
max_results: 1회 출력 건수 (1100)
sort: 정렬 순서 ('Accuracy', 'PublishTime', 'Title', 'SalesPoint', 'CustomerRating')
category_id: 특정 알라딘 카테고리 ID 필터 (선택)
Inputs: query (required), sort, start, query_type, +3 more.
aladin_book_statusA
인증키 상태 점검 및 알라딘 Open API 실제 왕복 1회 연결 상태를 점검합니다.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a distinct purpose: status check, search, item lookup, curated lists, and bulk collection. Search and collect overlap somewhat since collect is built on search, but their inputs and outputs clearly separate them.
All tools share the consistent `aladin_book_` prefix and mostly use verb-like suffixes: search, lookup, list, collect. The exception is `aladin_book_status`, which uses a noun rather than a verb, slightly breaking the pattern.
Five tools is a well-scoped count for a book API server. Each tool maps to a distinct operation type and the set avoids unnecessary bloat.
The server covers core book domain workflows: searching, retrieving detailed item info, browsing curated lists, and bulk collecting with export. Minor gaps exist, such as no dedicated category browsing or review retrieval, but the main use cases are well covered.
Maintenance
Related MCP Connectors
Federated search of books and papers, BibTeX/RIS citations, open-access retrieval and reading.
Korean law: statutes, precedents, ordinances, treaties and citation verification (법제처 API).
Search books and authors, fetch editions, browse subjects, and resolve cover images.
나라장터 입찰공고·사전규격·낙찰정보 검색. Korean public procurement bids via KONEPS open API.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server that allows searching and retrieving book information from Aladin's book store API, including book details, bestseller lists, and category-based searches.94MIT
- AlicenseNot gradedqualityDmaintenanceEnables real-time book search, detailed information, and bestsellers from the Aladin OpenAPI, integrated with Claude Desktop via MCP.13 npm3MIT
- AlicenseNot gradedqualityCmaintenanceEnables searching for books by title, author, or keyword, retrieving edition details by ISBN, and accessing author profiles and canonical work records through the Open Library API.93 npmMIT
- AlicenseAqualityBmaintenanceEnables searching the Kakao Daum Book Search API by title, author, publisher, or ISBN, retrieving detailed bibliographic and pricing metadata, and exporting results to xlsx, csv, json, or sqlite through MCP or CLI.41MIT